什么是 Introspection
Introspection 是 GraphQL 的一种特性，它使得我们可以探查查询和类型系统的结构和能力。简单来说就是能够自省 GraphQL API 中的属性和方法。
GraphQL 通过 __schema 字段来提供 Introspection 的功能，这个字段会返回一个特殊类型对象，描述了当前 GraphQL API 中所有可能的类型，包括对象、接口、枚举值等等。
如何使用 Introspection
通过调用指定的 query，可以获得 GraphQL API 的 schema 信息，具体如下：
-- -------------------- ---- -------
-
-------- -
--------- -
----
-
------------ -
----
-
---------------- -
----
-
----- -
----
-
-
-这个 query 将会返回 GraphQL API 中所有的类型名称，包括与它们相关的其他信息。
当我们需要在编写客户端代码时，可以通过调用 Introspection API，动态地获取数据，而不是在编译时静态地规定查询的结构。
Introspection 的应用场景
自动化客户端代码生成
通过运用 Introspection 可以实现自动生成客户端代码，这样我们就不用单独建立一套类型定义，而是可以动态地从 API 中获取类型信息。
例如，GraphQL Code Generator 就是使用了 Introspection 的一个很好例子，它可以根据 Introspection API 来自动生成查询过程中需要使用的类型、查询字段以及变量。
调试与分析
在构建 GraphQL API 时，我们有时会使用 fragment 的方式来组织查询，但我们很难确保查询中每一个 fragment，都会被正确地使用。
使用 Introspection 可以发现当前 GraphQL API 中所支持的查询类型，并检查查询中哪些 fragment 已经被使用到。
另外，我们在开发过程中还可以使用 Introspection 查询 GraphQL API 中的所有类型和字段，这样能够更快地了解 GraphQL API 的组织结构。
示例代码
-- -------------------- ---- -------
----- ------------------ - -
----- ------------------ -
-------- -
----- -
----
----
------ -
----
---- -
----
----
-
-
-
-
-
--
----- ----------- - -
------- -------
-------- -
--------------- -------------------
--
----- ---------------- ------ ------------------ ---
--
----------------- ------------
-------------- -- --------------
------------ -- -------------------这段代码将查询 GraphQL API 中的所有类型及其字段，并以 JSON 格式输出。在运行代码片段之前你需要替换上面的 URL，构建你的 GraphQL API 的地址来执行查询。
总结
Introspection 是 GraphQL 的一个重要特性，它使得我们可以在运行时动态地探查 GraphQL API 中的属性和方法，通过运用 Introspection 可以达到自动化客户端代码生成、调试与分析等效果。掌握 Introspection 的用法有助于我们更好地使用 GraphQL，并优化我们的工作效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64e7132bf6b2d6eab326cfe9