batched-graphql-request

Features

• Most simple and lightweight GraphQL client
• Includes batching and caching based dataloader
• Promise-based API (works with async / await)
• Typescript support (Flow coming soon)

Idea

The idea of this library is to provide query batching and caching for Node.js backends on a per-request basis. That means, per http request to your Node.js backend, you create a new instance of BatchedGraphQLClient which has its own cache and batching. Sharing a BatchedGraphQLClient instance across requests against your webserver is not recommended as that would result in Memory Leaks with the Cache growing infinitely. The batching and caching is based on dataloader

Install

npm install batched-graphql-request

Examples

Creating a new Client per request

In this example, we proxy requests that come in the form of batched array. Instead of sending each request individually to my-endpoint, all requests are again batched together and send grouped to the underlying endpoint, which increases the performance dramatically.

1import { BatchedGraphQLClient } from 'batched-graphql-request'
2import * as express from 'express'
3import * as bodyParser from 'body-parser'
4 
5const app = express()
6 
7/*
8This accepts POST requests to /graphql of this form:
9[
10  {query: "...", variables: {}},
11  {query: "...", variables: {}},
12  {query: "...", variables: {}}
13]
14 */
15 
16app.use(
17  '/graphql',
18  bodyParser.json(),
19  async (req, res) => {
20    const client = new BatchedGraphQLClient('my-endpoint', {
21      headers: {
22        Authorization: 'Bearer my-jwt-token',
23      },
24    })
25    
26    const requests = Array.isArray(req.body) ? req.body : [req.body]
27    
28    const results = await Promise.all(requests.map(({query, variables}) => client.request(query, variables)))
29    
30    res.json(results)
31  }
32)
33 
34app.listen(3000, () =>
35  console.log('Server running.'),
36)

To learn more about the usage, please check out graphql-request