@graphql-tools/jest-transform

中文文档
3.1.0发布于 2026/10/26MITTypeScriptESM + CJS构建来源已验证近 30 天下载 79.3万

装入和剖析导入的 GraphQL 文件的插件

中文使用文档

图QL 变形

用于预处理 GraphQL 文档(操作、碎片和 SDL)的 Jest 变压器

npm install @graphql-tools/jest-transform

在你身边 package.json数字 :

{
  "jest": {
    "transform": {
      "\\.(gql|graphql)$": "@graphql-tools/jest-transform"
    }
  }
}

或者说 jest.config.js数字 :

module.exports = {
  // ...
  transform: {
    '\\.(gql|graphql)$': '@graphql-tools/jest-transform'
  }
}

如何是区别于 jest-transform-graphql? 吗? 没用的 graphql-tag/loader 下划线 引擎盖,但是我们自己的, 更优化和定制 @graphql-tools/webpack-loaderA级 .graphql 文件可能导出多个命名操作; 参见 Webpack-loader README.

选项

  • 无 描述( C)默认: 假) - 删除描述
  • eMudule (英语:默认: 假) - 使用进出口报表而不是普通JS
{
  "globals": {
    "graphql": {
      "noDescription": true
    }
  }
}

版本与发布记录

@graphql-tools/jest-transform 共发布 326 个版本,首次发布于 2021/06/17;过去 12 个月发布了 144 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.1.0latest2026/10/2621 天前
3.1.0-rc-20261026131423-8fabaf53c1774b23fb7f57b7dadfe5d6b5213dacrc2026/10/2621 天前
3.1.0-alpha-20261026123108-071eb6cfddd27d23db13b9ffc9051c072334a401alpha2026/10/2621 天前
3.1.0-alpha-20261026122756-d820b8099b0a6fe9c218e6e0820ecc34b7e5daf52026/10/2621 天前
3.1.0-alpha-20261026121847-75fd8ee1b5baa57c5039f3d1805399a1e4f2d5102026/10/2621 天前
3.1.0-alpha-20261026031207-872f174b78389989102096bcfff633be6688b5502026/10/2621 天前

其他发布通道:beta → 1.0.0-alpha-e6320b00.0,alpha → 3.1.0-alpha-20261026123108-071eb6cfddd27d23db13b9ffc9051c072334a401,rc → 3.1.0-rc-20261026131423-8fabaf53c1774b23fb7f57b7dadfe5d6b5213dac。

关于 @graphql-tools/jest-transform 的常见问题

@graphql-tools/jest-transform 是什么?

装入和剖析导入的 GraphQL 文件的插件

如何安装 @graphql-tools/jest-transform?

在项目目录运行 npm install @graphql-tools/jest-transform,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:graphql(^16.0.0 || ^17.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@graphql-tools/jest-transform 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@graphql-tools/jest-transform 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@graphql-tools/jest-transform 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.18.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@graphql-tools/jest-transform 可以商用吗?

@graphql-tools/jest-transform 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@graphql-tools/jest-transform 的下载量有多少?

根据 npm 官方下载统计,@graphql-tools/jest-transform 在 2026/10/17 – 2026/11/15 这 30 天内被下载 792,891 次,日均约 26,430 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@graphql-tools/jest-transform 还在维护吗?

最新版本 3.1.0 发布于 2026/10/26(21 天前);至今共发布 326 个版本,其中过去 12 个月发布了 144 个;首次发布于 2021/06/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。