功能特性
端点输入与切换
顶部的端点输入框允许输入任意 GraphQL 服务器的 URL 地址。输入完成后按回车或点击连接按钮即可切换到新的端点。工具会自动向端点发送 Introspection 查询以获取 Schema 定义,并更新文档浏览器的内容。内置四个预置端点(Countries、Rick and Morty、Pokemon、Star Wars),点击即可快速切换。端点输入框支持自动补全和历史记录。
查询执行与快捷键
编写完查询后,点击"执行"按钮或使用快捷键 Ctrl+Enter 即可发送请求。工具会将查询语句、变量和请求头打包为 GraphQL 请求发送到目标端点。响应结果以格式化的 JSON 形式显示在右侧的结果面板中。执行过程中会显示加载状态,执行完成后会显示请求耗时。支持长时间运行的查询,不会因为查询执行时间较长而超时。
交互式文档浏览
右侧文档面板展示从 GraphQL 服务器获取的完整 Schema 文档。可以按类型名搜索 Query、Mutation、Subscription 的定义,查看每个字段的名称、描述、参数和返回类型。点击字段可以展开查看详细的类型信息,支持嵌套类型的递归浏览。文档会在连接端点后自动加载,也可以手动刷新。文档是交互式的,点击字段名可以快速插入到查询编辑器中。
代码美化与复制
工具栏提供三个便捷操作:美化(Ctrl+Shift+F)自动格式化查询代码,添加适当的缩进和换行,提高可读性;复制按钮一键将查询内容复制到剪贴板,方便分享和粘贴;清空按钮快速清除编辑器中的所有内容,准备编写新的查询。这些操作都有对应的快捷键,提升开发效率。
查询历史记录
工具自动保存最近执行的查询历史记录。历史记录面板显示查询的执行时间、查询摘要和执行状态(成功/失败)。点击历史记录项可以快速恢复之前的查询到编辑器中。历史记录存储在浏览器的 localStorage 中,关闭页面后仍会保留。支持清除历史记录功能。历史记录帮助开发者在多次查询迭代中快速回溯,避免重复编写相同的查询。
查询/变量/Headers 标签页
编辑器区域支持三个标签页切换:Query 标签页用于编写 GraphQL 查询/变更/订阅语句;Variables 标签页用于定义查询变量,以 JSON 格式输入,变量可以在查询中通过 $variableName 引用;Headers 标签页用于配置自定义 HTTP 请求头,如 Authorization Token、Content-Type 等。三个标签页协同工作,支持构建复杂的 GraphQL 请求。每个标签页都独立保存内容,切换不会丢失。
UD5工具箱