npm 包 graphql-cli-plugin-validate-schema 使用教程

阅读时长 4 分钟读完

前言

在前端开发过程中,GraphQL 得到了越来越多的应用。针对 GraphQL,有很多的 npm 包可以辅助我们的开发,其中 graphql-cli-plugin-validate-schema 就是其中一个非常实用的包。它可以用来验证 GraphQL schema 是否符合规范,保证开发的GraphQL API 的正确性。

安装

使用 npm 安装 graphql-cli-plugin-validate-schema

配置

使用插件

graphql-config.yml 中添加插件:

-- -------------------- ---- -------
------- --------------
---------- ----------------
-----------
  ----------------
    ------
      - -----------------------------
      - ----------------------------
      - --------------------------
      - -------------------------
      - -----------------------------
  • schema: GraphQL schema 的文件路径。
  • documents: GraphQL documents 的文件路径。
  • extensions: 插件配置。
    • validate-schema: 插件名称。
      • rules: 插件规则。

自定义规则

你可以配置你自己的规则或者重写默认的规则:

custom-rules.js 文件中添加自己的规则:

-- -------------------- ---- -------
-------------- - ---------- -------- -- -
  ------ -
    ----------------- ---- ------- ----- ---------- -
      -- ---------- --- ------------------------ -
        ---------
          ---------------
          -------
        --
      -
    --
  --
--

以上代码会检测字段名,如果不是小写字母就会抛出一个错误。

使用

运行 graphql validate 命令,即可验证 GraphQL schema 是否符合规范:

如果你自定义了规则,你也可以使用 graphql validate 命令来验证:

示例代码

-- -------------------- ---- -------
----- - -------- ----------- - - -------------------
----- ------ - -------------
    ---- ----- -
        ------ ------
    -
---
----- ----- - -
  ----- -
    -----
  -
--
----- ------------------ - -----------------------------------------------------------------
-------------------------- ------ - ------ ------------------------------- -------------- -- -
  -------------------
--

结论

graphql-cli-plugin-validate-schema 是一个非常实用的包,帮助我们验证 GraphQL schema 是否符合规范,保证开发的 GraphQL API 的正确性。它可以用于开发阶段,也可以用于测试和部署阶段。希望本文的介绍能够帮助大家更好地使用此工具。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005726081e8991b448e88b3

纠错
反馈