monojack/graphql-normalizr: Normalize GraphQL responses for persisting in the cl ...

原作者: [db:作者] 来自: 网络收藏邀请

开源软件名称（OpenSource Name）：

monojack/graphql-normalizr

开源软件地址(OpenSource Url)：

https://github.com/monojack/graphql-normalizr

开源编程语言(OpenSource Language)：

JavaScript 100.0%

开源软件介绍(OpenSource Introduction)：

graphql-normalizr

Normalize GraphQL responses for persisting in the client cache/state.

TL;DR: Transforms:

{
  "data": {
    "findUser": [
      {
        "__typename": "User",
        "id": "5a6efb94b0e8c36f99fba013",
        "email": "[email protected]",
        "posts": [
          {
            "__typename": "BlogPost",
            "id": "5a6efb94b0e8c36f99fba016",
            "title": "Dolorem voluptatem molestiae",
            "comments": [
              {
                "__typename": "Comment",
                "id": "5a6efb94b0e8c36f99fba019",
                "message": "Alias quod est voluptatibus aut quis sunt aut numquam."
              },
              {
                "__typename": "Comment",
                "id": "5a6efb94b0e8c36f99fba01b",
                "message": "Harum quia asperiores nemo."
              },
              {
                "__typename": "Comment",
                "id": "5a6efb94b0e8c36f99fba01c",
                "message": "Vel veniam consectetur laborum."
              },
              {
                "__typename": "Comment",
                "id": "5a6efb94b0e8c36f99fba01e",
                "message": "Possimus beatae vero recusandae beatae quas ut commodi laboriosam."
              }
            ]
          }
        ]
      }
    ]
  }
}

into:

{
  "comments": {
    "5a6efb94b0e8c36f99fba019": {
      "id": "5a6efb94b0e8c36f99fba019",
      "message": "Alias quod est voluptatibus aut quis sunt aut numquam."
    },
    "5a6efb94b0e8c36f99fba01b": {
      "id": "5a6efb94b0e8c36f99fba01b",
      "message": "Harum quia asperiores nemo."
    },
    "5a6efb94b0e8c36f99fba01c": {
      "id": "5a6efb94b0e8c36f99fba01c",
      "message": "Vel veniam consectetur laborum."
    },
    "5a6efb94b0e8c36f99fba01e": {
      "id": "5a6efb94b0e8c36f99fba01e",
      "message": "Possimus beatae vero recusandae beatae quas ut commodi laboriosam."
    }
  },
  "blogPosts": {
    "5a6efb94b0e8c36f99fba016": {
      "id": "5a6efb94b0e8c36f99fba016",
      "title": "Dolorem voluptatem molestiae",
      "comments": [
        "5a6efb94b0e8c36f99fba019",
        "5a6efb94b0e8c36f99fba01b",
        "5a6efb94b0e8c36f99fba01c",
        "5a6efb94b0e8c36f99fba01e"
      ]
    }
  },
  "users": {
    "5a6efb94b0e8c36f99fba013": {
      "id": "5a6efb94b0e8c36f99fba013",
      "email": "[email protected]",
      "posts": ["5a6efb94b0e8c36f99fba016"]
    }
  }
}

Motivation

We all love GraphQL and we want to use it. There are tons of libraries and clients out there that help us do that with ease, but there is still one problem... How do you persist that data?

Yes, everything is all great when the response mirrors the exact structure we asked for, but we don't want to cache it that way, do we? We probably want a normalized version of that data which we can persist to our store and read/modify it efficiently. Flux or Redux stores work best with normalized data and there are also GraphQL clients you can use to execute queries on the local cache/state (blips or apollo-link-state), in which case, we definitely need to persist normalized data.

GraphQLNormalizr is simple, fast, light-weight and it provides all the tools needed to do just that, the only requirement is that you include the id and __typename fields for all the nodes (but it can do that for you if you're too lazy or you want to keep your sources thin).

Installation
API by example
Migrating from 1.x to 2.x

Installation

npm install graphql-normalizr

API by example

The GraphQLNormalizr constructor function returns an object containing 3 methods:

parse
addRequiredFields
normalize

Depending on how you write your queries, you may or may not use parse or addRequiredFields, but normalize is the method that you will transform the GraphQL response. As you've probably seen from the TL;DR, all response nodes must contain the __typename and id fields. __typename is a GraphQL meta field and the id key may be customized when creating the GraphQLNormalizr client.

If your queries already ask for id and __typename there's no need to use parse or addRequiredFields. Otherwise, parse will take care of transforming your GraphQL source into a Document and add the __typename and id fields where needed. In case you already use a different parser, or only have access to the Document you may use addRequiredFields on the Document to add the __typename and id fields

GraphQLNormalizr

import { GraphQLNormalizr } from 'graphql-normalizr'

// const config = ...
const normalizer = new GraphQLNormalizr(config)

config: optional - the configuration object containing information for instantiating the client. it takes the following props:

idKey
useConnections
typeMap
exclude
lists
typenames
typePointers
caching
plural
casing

idKey

Default is "id". Configures a custom id key for the client. Use this if your resource identifiers are found under a different key name ('_id', 'key', 'uid' etc).

Consider the following GraphQL response:

const response = {
  data: {
    findUser: {
      __typename: 'User',
      uid: '5a6efb94b0e8c36f99fba013',
      email: '[email protected]',
    },
  },
}

Normalize the data with our custom id key:

// using destructuring to get the `normalize` method of the client
const { normalize } = new GraphQLNormalizr({ idKey: 'uid' })
normalize(response)
// =>
// {
//  users: {
//    '5a6efb94b0e8c36f99fba013' : {
//      uid: '5a6efb94b0e8c36f99fba013',
//      email: '[email protected]'
//    }
//  }
// }

useConnections

Default is false. If you are using GraphQL connections with edges and nodes, set this flag to true otherwise you'll get a warning and the normalization won't work.

NOTE: The connections implementation needs to be according to the specification

const response = {
  data: {
    findUser: {
      __typename: 'User',
      id: '5a6efb94b0e8c36f99fba013',
      email: '[email protected]',
      friends: {
        __typename: 'FriendsConnection',
        totalCount: 3,
        edges: [
          {
            node: {
              __typename: 'User',
              id: '5a6cf127c2b20834f6551481',
              email: '[email protected]',
            },
            cursor: 'Y3Vyc29yMg==',
          },
          {
            node: {
              __typename: 'User',
              id: '5a6cf127c2b20834f6551482',
              email: '[email protected]',
            },
            cursor: 'Y3Vyc29yMw==',
          },
        ],
        pageInfo: {
          endCursor: 'Y3Vyc29yMw==',
          hasNextPage: false,
        },
      },
    },
  },
}

const { normalize } = new GraphQLNormalizr({
  useConnections: true,
})

normalize(response)
// =>
// {
//   users: {
//     '5a6efb94b0e8c36f99fba013': {
//       id: '5a6efb94b0e8c36f99fba013',
//       email: '[email protected]',
//       friends: ['5a6cf127c2b20834f6551481', '5a6cf127c2b20834f6551482'],
//     },
//     '5a6cf127c2b20834f6551481': {
//       id: '5a6cf127c2b20834f6551481',
//       email: '[email protected]',
//     },
//     '5a6cf127c2b20834f6551482': {
//       id: '5a6cf127c2b20834f6551482',
//       email: '[email protected]',
//     },
//   },
// }

typeMap

By default the entity name will be the plural form of the type name, converted to camel case, (PrimaryAddress type will be stored under the primaryAddresses key). Use this option to provide specific entity names for some/all Types, or try the plural and casing options to derive the entity names.

const response = {
  data: {
    findUser: {
      __typename: 'User',
      id: '5a6efb94b0e8c36f99fba013',
      email: '[email protected]',
    },
  },
}

const { normalize } = new GraphQLNormalizr({
  typeMap: { User: 'accounts' },
})
normalize(response)
// =>
// {
//  accounts: {
//    '5a6efb94b0e8c36f99fba013' : {
//      id: '5a6efb94b0e8c36f99fba013',
//      email: '[email protected]'
//    }
//  }
// }

exclude

Prevent normalization of specified fields

const response = {
  data: {
    allUsers: [
      {
        __typename: 'User',
        id: '5a6efb94b0e8c36f99fba013',
        email: '[email protected]',
        preferences: null
        posts: [
          {
            __typename: 'BlogPost',
            id: '5a6cf127c2b20834f6551484',
            likes: 10,
            title: 'Sunt ut aut',
            tags: {},
          }
        ]
      },
      {
        __typename: 'User',
        id: '5a6efb94b0e8c36f99fba013',
        email: '[email protected]',
        preferences: { foo: 'apple', bar: 1,  baz: { a: 'b' }, quux: null, }
        posts: [
          {
            __typename: 'BlogPost',
            id: '5a6cf127c2b20834f6551485',
            likes: 23,
            title: 'Nesciunt esse',
            tags: [],
          }
        ]
      },
    ],
  },
}

Normalize the data excluding the preferences field on users and the tags field on blogPosts:

// using destructuring to get the `normalize` method of the client
const { normalize } = new GraphQLNormalizr({ exclude: { users: [ 'preferences' ], blogPosts: [ 'tags' ] } })
normalize(response)
// =>
// {
//   users: {
//     '5a6efb94b0e8c36f99fba013': {,
//       id: '5a6efb94b0e8c36f99fba013',
//       email: '[email protected]',
//       preferences: null
//     },
//     '5a6efb94b0e8c36f99fba013': {
//       id: '5a6efb94b0e8c36f99fba013',
//       email: '[email protected]',
//       preferences: { foo: 'apple', bar: 1,  baz: { a: 'b' }, quux: null, }
//     },
//   },
//   blogPosts: {
//     '5a6cf127c2b20834f6551484': {
//       id: '5a6cf127c2b20834f6551484',
//       likes: 10,
//       title: 'Sunt ut aut',
//       tags: {},
//     },
//     '5a6cf127c2b20834f6551485': {
//       id: '5a6cf127c2b20834f6551485',
//       likes: 23,
//       title: 'Nesciunt esse',
//       tags: [],
//     },
//   }
// }

plural

Default is true. Set this to false if you don't want to pluralize entity names. Considering the previous response example:

const { normalize } = new GraphQLNormalizr({
  plural: false,
})
normalize(response)
// =>
// {
//  user: {
//    '5a6efb94b0e8c36f99fba013' : {
//      id: '5a6efb94b0e8c36f99fba013',
//      email: '[email protected]'
//    }
//  }
// }

casing

You can also specify the preferred casing for entity names. Again, consider the above response example.

// casing: 'lower'
// User => user

// casing: 'upper'
// User => USER

// casing: 'camel'
// PrimaryAddress => primaryAddress

// casing: 'pascal'
// PrimaryAddress => PrimaryAddress

// casing: 'snake'
// PrimaryAddress => primary_address

// casing: 'kebab'
// PrimaryAddress => primary-address

Combine plural and casing options to get the desired entity names

lists

Default is false. All the data is stored in key/value pairs, for easy access. If you want to use arrays, for whatever reason, set this to true

For the same response object in our previous example:

const { normalize } = new GraphQLNormalizr({
  lists: true,
})
normalize(response)
// =>
// {
//  users: [
//    {
//      id: '5a6efb94b0e8c36f99fba013',
//      email: '[email protected]'
//    }
//  ]
// }

typenames

Default is false. The normalized data will not contain the __typename field. Set this to true if you need to persist them.

const { normalize } = new GraphQLNormalizr({
  typenames: true,
})

normalize(response)
// =>
// {
//  users: {
//    '5a6efb94b0e8c36f99fba013' : {
//      __typename: 'User',
//      id: '5a6efb94b0e8c36f99fba013',
//      email: '[email protected]'
//    }
//  }
// }

typePointers

Default is false. Enables explicit type pointers - instead of an array of only identifiers and having to figure out which collection they point to, it will return objects containing the identifier as well as the collection name. Works especially well with Union types and Interfaces.

const { normalize } = new GraphQLNormalizr({
  typePointers: true,
})

// ['5a6cf127c2b20834f655148a', '5a6cf127c2b20834f655148b', '5a6cf127c2b20834f655148c']
users: [
  {
    _id: '5a6cf127c2b20834f655148a', // '_id' or the specified key
    collection: 'members', // type Member
  },
  {
    _id: '5a6cf127c2b20834f655148b', // '_id' or the specified key
    collection: 'authors', // type Author
  },
  {
    _id: '5a6cf127c2b20834f655148c', // '_id' or the specified key
    collection: 'members', // type Member
  },
],

caching

Default is false. The normalize method is pretty fast by itself, it does a single iteration and associates the values only for each response node and not for all the fields. Enable this if you think you'd be normalizing the same response multiple times, like when you're polling for data and it may not have changed.

const { normalize } = new GraphQLNormalizr({
  caching: true,
})

const normalized = normalize(response)
const cached = normalize(response)

cached === normalized // => true

`parse`

Turns a GraphQL source into a Document and adds the required fields where necessary.

// ...
import { GraphQLNormalizr } from 'graphql-normalizr'

const source = `{
  allUsers {
    email
    posts {
      title
      comments {
        message
      }
    }
  }
}`

const { parse } = new GraphQLNormalizr()

const query = parse(source) // will add `id` and `__typename` fields to all the nodes

// We can use the print method from `graphql` to see/use the updated source
const { print } = require('graphql')
print(query)
// =>
// `{
//  allUsers {
//    __typename
//    id
//    email
//    posts {
//      __typename
//      id
//      comments {
//        __typename
//        id
//        message
//      }
//    }
//  }
// }`

// ...

`addRequiredFields`

If you only have access to the Document, you can use the print method from graphql to get the source and parse it. But that may be expensive and you shouldn't have to print a document just to parse it again. addRequiredFields will add the id and __typename fields to that document, without the need of extracting its source.

// ...
import { GraphQLNormalizr } from 'graphql-normalizr'
import { allUsersQuery } from './queries'

const { addRequiredFields } = new GraphQLNormalizr()

const

鲜花

握手

雷人

路过

鸡蛋

该文章已有0人参与评论

请发表评论

全部评论

专题导读

More+

10-27 六六分期app的软件客服如何联系？(六六分期

11-06 可心卡盟:win10系统火狐flash插件崩溃怎么

11-06 亲亲特价:怎么删除回收站图标

11-06 济南大学虚拟社区:鲁大师节能降温的具体办

11-06 xlueops.exe:无线网络安装向导

11-06 女斗合众国:win7系统cf与主机连接不稳定怎

11-06 0xc000022-[cf烟雾头]cf怎么调烟雾头

11-06 qizideyouhuo:应用程序无法正常启动0xc0000

11-06 ipz-185:win7系统vcf文件怎么打开

11-06 傻哥蹦迪:win10系统s4怎么打开usb调试

11-06 八神浩树gtaste:回收站清空了怎么恢复

11-06 妖尾之黑色守护:win10系统电脑没有1440x900

11-06 校园至尊魔王小说:win7系统浏览网页时字体

11-06 女斗合众国:win10系统访问共享文件夹提示请

11-06 tokyo hot n0654:恢复win7系统默认字体一招

11-06 雨酷仙境:设置win7系统转移临时文件夹腾出

11-06 阿穆纳伊之杖:win7系统开始菜单在右边还原

11-06 tunespotting:win10系统火狐flash插件总是

11-06 甘尔葛分析师：计谋网站seo关键词暴涨有什

11-06 蔡贵霖: 计谋网站seo关键词暴涨有什么秘密

11-06 博益网首页:ao3网页版进入不了解决方法

11-06 漏斗子专栏: 网站数据分析小白易懂精华篇

11-06 见证双虹怎么做:win7系统开启telnet命令的

11-06 颾狐蝶蜋:系统资源不足无法完成请求的服务

11-06 国光中学校歌:提交网站到alexa查询详细步骤

11-06 西安有情天:静态网页和动态网页的区别

11-06 红木雅尚斋:外部链接构造对网站的好处

11-06 前官礼遇：防止域名劫持–增强域安全性的10

11-06 密传二转答案: 中文分词算法有哪些

11-06 金泉家园邮编:百度快照劫持的表现及应对方

AvanthikaMeenakshi/graphqlReactBoilerplate发布时间：2022-06-22

correttojs/graphql-codegen-apollo-next-ssr: Autogenerate apollo code for nextjs ...发布时间：2022-06-22

剪的笔顺,诠释剪的笔画,认识剪的部首

1 六六分期app的软件客服如何联系？(六六分期

六六分期app的软件客服如何联系？不知道吗？加qq群【895510560】即可！标题：六六分期

阅读：18248|2023-10-27

2 可心卡盟:win10系统火狐flash插件崩溃怎么

今天小编告诉大家如何处理win10系统火狐flash插件总是崩溃的问题，可能很多用户都不知

阅读：9671|2022-11-06

3 亲亲特价:怎么删除回收站图标

今天小编告诉大家如何对win10系统删除桌面回收站图标进行设置，可能很多用户都不知道

阅读：8175|2022-11-06

4 济南大学虚拟社区:鲁大师节能降温的具体办

今天小编告诉大家如何对win10系统电脑设置节能降温的设置方法，想必大家都遇到过需要

阅读：8547|2022-11-06

5 xlueops.exe:无线网络安装向导

我们在使用xp系统的过程中,经常需要对xp系统无线网络安装向导设置进行设置，可能很多

阅读：8455|2022-11-06

6 女斗合众国:win7系统cf与主机连接不稳定怎

今天小编告诉大家如何处理win7系统玩cf老是与主机连接不稳定的问题，可能很多用户都不

阅读：9384|2022-11-06

7 0xc000022-[cf烟雾头]cf怎么调烟雾头

电脑对日常生活的重要性小编就不多说了，可是一旦碰到win7系统设置cf烟雾头的问题，很

阅读：8426|2022-11-06

8 qizideyouhuo:应用程序无法正常启动0xc0000

我们在日常使用电脑的时候，有的小伙伴们可能在打开应用的时候会遇见提示应用程序无法

阅读：7859|2022-11-06

9 ipz-185:win7系统vcf文件怎么打开

今天小编告诉大家如何对win7系统打开vcf文件进行设置，可能很多用户都不知道怎么对win

阅读：8410|2022-11-06

10 傻哥蹦迪:win10系统s4怎么打开usb调试

今天小编告诉大家如何对win10系统s4开启USB调试模式进行设置，可能很多用户都不知道怎

阅读：7394|2022-11-06

客服电话

电子邮件

monojack/graphql-normalizr: Normalize GraphQL responses for persisting in the cl ...

开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

graphql-normalizr

Motivation

Table of contents

Installation

API by example

GraphQLNormalizr

idKey

useConnections

typeMap

exclude

plural

casing

lists

typenames

typePointers

caching

parse

addRequiredFields

请发表评论

全部评论

上一篇：

下一篇：

theindianappguy/machine_learning_flutter

samaxes/minify-maven-plugin: Combine and

挨打的读音是什么？是āi dǎ还是ái dǎ？

nacika-ins/nanachibot: nanachibot is Rus

CVE-2022-2071

剪的笔顺,诠释剪的笔画,认识剪的部首

六六分期app的软件客服如何联系？(六六分期

florent37/ViewAnimator: A fluent Android

florent37/Shrine-MaterialDesign2: implem

CVE-2020-36276

SimpleSoftwareIO/simple-sms: Send and re

关于我们

产品与服务

解决方案

139-2527-9053

`parse`

`addRequiredFields`