graphql 有针对不同语言的服务端实现，以帮助开发人员搭建 graphql server。 （推荐学习：前端视频）
而 gq-loader 是一个 webpack 插件，你可以认为它一针对前端项目的一种 client 端实现，它的目的是帮助前端开发同学更简便的调用 graphql api，它让前端开发人员在使用 graphql 时更加方便，像普通 js 模块一样轻松自如，使前端开发人员能在 js 文件中通过 import 或 require 导入 .gql 和 .graphql 文件，然后直接调用。
并且它还支持通过 #import 语法导入其它 .gql 文件，比如 fragments。
#import 还提供了两个别名，分别是 #require 和 #include，这两个别名和 #import 的用法及行为完全一致。
安装
npm install gq-loader --save-dev
或者
yarn add gq-loader
基本使用
如同其它 loader 一样，首先，我们在 webpack.config.js 中添加 gq-loader 的配置
{ test: /\.(graphql|gql)$/, exclude: /node_modules/, use: { loader: 'gq-loader' options: { url: 'graphql server url' } }}
然后，我们就可以在 js 文件中通过 import 来导入 .gql 文件使用它了，我们来一个简单的示例，假设已经有一个可以工作的 graphql server，那么，我们先创建一个可以查询用户的 getuser.gql
#import './fragment.gql' query myquery($name: string) { getuser(name: $name) ...userfields }}
可以看到，我们通过 #import 引用了另外一个 .gql 文件 fragment.gql，在这个文件中我们描术了要返回的 user 的字段信息，这样我们就能在不同的地方「重用」它了，我们也创建一下这个文件
fragment userfields on user { name age}
好了，我们可以在 js 文件中直接导入 getuser.gql，并且使用它查询用户了，从未如此简便，我们来看看
import getuser from './getuser.gql';import react from 'react';import reactdom from 'react-dom';async function query() { const user = await getuser({ name: 'bob' }); console.log('user', user);}function app() { return <button onclick={query}>click</button>;}reactdom.render(<app />, document.getelementbyid('root'));
在调用 getuser 时，我们可以给函数参数向 graphql 传递变量，这些变量就是我们的查询参数。
自定义请求
默认 gq-loader 就会帮你完成 graphql 请求，但某些场景下或许你想自已控制所有请求，如果有这样需要，我们还可以通过 request 属性来「自定义」请求，看一下示例，需要先稍微改动一下 loader 配置
{ test: /\.(graphql|gql)$/, exclude: /node_modules/, use: { loader: 'gq-loader' options: { url: 'graphql server url', //指定自动请求模块路径 request: require.resolve('your_request_module_path'); } }}
在 your_request_module_path 填写自定义请求模块路径，gq-loader 将自动加载并使用对应请求模块，模块只需要改出一个「请求函数即可」，看如下自定义示例
onst $ = require('jquery');//url 是要请求的 graphql 服务地址//data 是待发送的数据//options 是自定义选项module.exports = function(url, data, options){ //如果有需要还可以处理 options return $.post(url, data);};
其中，options 是导入 .gql 文件后「函数的第二个参数」，比如，可以这样传递 options 参数
import getuser from './getuser.gql';async function query() { const options = {...}; const user = await getuser({ name: 'bob' }, options); console.log('user', user);}
注意，gq-loader 的 extensions 无论配置何值，在 js 中 import 时都不能省略扩展名，此选项仅作用于 .gql 文件 import 其它 .gql 文件
以上就是前端怎么调用graphql api?的详细内容。