GraphQL 格式化与压缩
解析、格式化或压缩 GraphQL 操作,并汇总变量与 Fragment
使用 GraphQL 官方解析器检查文档语法;支持操作文档与 SDL;限制 2 MiB 和 50,000 Token。不连接 Schema,不验证字段、参数类型或权限。
语法有效的 GraphQL 文档会显示在这里。
工具说明
GraphQL 格式化工具使用参考 Parser 和 Printer 解析语法、排版和压缩,接受操作文档、Fragment 以及 Schema 定义语言 SDL。摘要分别统计操作、各操作的变量定义、Fragment 和全部 Definition;SDL 计入定义总数。排版不保留源注释,但描述和字符串值仍属于文档内容;压缩会删除可忽略的逗号、空白和注释,同时保留必要的 Token 边界。输入限制为 2 MiB 与 50,000 Token。语法通过的文档仍可能包含未知字段、重名操作或不兼容的 Fragment;本工具不执行 Schema 验证或网络请求。修改输入或模式会清除旧输出,尚未完成的解析器加载也不会恢复已清空的结果。
场景配方
为代码评审规范化 GraphQL 操作
目标:把文档语法整理与 Schema、运行时排障分开
- 粘贴包含全部 Fragment Definition 的完整操作并格式化。
- 检查操作名、变量数量、Fragment 与语法错误位置。
- 提交规范文档后,再按当前 Schema 校验,并在已授权环境执行。
结果:得到语法有效、可读,且明确保留 Schema 与运行时检查的操作文档。
常见问题
支持 Mutation 和 Subscription 吗?
支持,参考解析器接受 Query、Mutation、Subscription、Fragment 与 Directive 语法。
压缩模式会删除什么?
会删除可忽略空白、可选逗号和注释,同时保留必须的 Token 分隔。
格式化会保留注释吗?
不会,GraphQL AST Printer 输出语义文档,不保留源注释。
可以根据我的 Schema 校验字段吗?
不可以,没有 Schema 时只检查文档语法,不检查字段、参数和 Fragment 类型条件。
工具会执行 GraphQL 请求吗?
不会,不联系 Endpoint、不发送变量,也不判断权限。
Query 会上传吗?
不会,解析、打印、压缩与摘要都在本地运行。
支持 SDL 吗?摘要数量代表什么?
支持解析和排版 SDL,并计入 Definition 总数。Operations 和 Fragments 统计对应的可执行定义;变量定义数量按各操作累加,不同操作中的同名变量分别计算。工具不会构建或验证 Schema。
输入有哪些限制?
最多 2 MiB UTF-8 输入和 50,000 Token。过深嵌套或复杂文档仍可能超出浏览器解析资源并返回错误。
继续浏览