@golevelup/nestjs-graphql-request

中文文档
5.0.0发布于 2026/03/19MITTypeScriptCommonJS近 30 天下载 8.7万

用于整合图克请求和NestJS的坏账公用事业

中文使用文档
文档目录4 节
  1. 开始
  2. 导入
  3. 输入图形QLClient
  4. 类型安全图形QL 访问

图QL 请求

这个图书馆提供 GraphQLRequestModule 从而容易初始化 GraphQLClient 用于Depdency注射。 这可以和自动码源结合,用于从您 Nest 服务中安全进入第三方 GQL API

version downloads license

开始

* :密码组

npm install ---save @golevelup/nestjs-graphql-request
yarn add @golevelup/nestjs-graphql-request
pnpm add @golevelup/nestjs-graphql-request

* :

导入

导入并添加 GraphQLRequestModule 页:1 imports 消费单元的一节.

import { GraphQLRequestModule } from '@golevelup/nestjs-graphql-request';

@Module({
  imports: [
    GraphQLRequestModule.forRoot({
      // Exposes configuration options based on the graphql-request package
      endpoint: config.get('endpoint'),
      options: {
        headers: {
          'content-type': 'application/json',
          'x-hasura-admin-secret': config.get('secret'),
        },
      },
    }),
  ],
})
export class AppModule {
  // ...
}

输入图形QLClient

要让您控制器或服务中的 GraphQL 请求使用所提供的装饰器 @InjectGraphQLClient。 。 。 .

import { InjectGraphQLClient } from '@golevelup/nestjs-graphql-request';
import { GraphQLClient } from 'graphql-request';

@Injectable()
export class ExampleService {
  constructor(@InjectGraphQLClient() private readonly client: GraphQLClient) {}
}

类型安全图形QL 访问

GraphQL 客户端与 GraphQL 代码生成工具结合,用于向 GraphQL 端点通信时效果最好. 跟着 GraphQL 代码生成器 GraphQL 请求插件指令。 。 。 .

在GraphQL Endpoint上运行代码生成器将会为API暴露出的所有操作和类型以及一个 getSdk 函数,可以和 GraphQL 请求一起使用,以获取智能和类型saftey,用于您提出的所有请求。 这个 getSdk 函数仅需要图形QLClient实例(此库提供)。 然而,由于每个生成的SDK每个端点都是独一无二的,所以由您在您的应用程序中给提供商电线. 使用最小代码的供应商工厂可以做到这一点.

import {
  GraphQLRequestModule,
  GraphQLClientInject,
} from '@golevelup/nestjs-graphql-request';
import { getSdk } from './your-codegen-location';

@Module({
  imports: [
    GraphQLRequestModule.forRoot({
      // Exposes configuration options based on the graphql-request package
      endpoint: config.get('endpoint'),
      options: {
        headers: {
          'content-type': 'application/json',
          'x-hasura-admin-secret': config.get('secret'),
        },
      },
    }),
  ],
  providers: [
    {
      // you can provide whatever key you want. use it in conjunction with @Inject("TypeSafeGqlSdk") to get the SDK instance in your controllers/services
      provide: 'TypeSafeGqlSdk',
      inject: [GraphQLClientInject],
      useFactory: (client: GraphQLClient) => getSdk(client),
    },
  ],
})
export class AppModule {
  // ...
}

版本与发布记录

@golevelup/nestjs-graphql-request 共发布 28 个版本,首次发布于 2020/03/28;过去 12 个月发布了 5 个版本。

版本发布日期距今
5.0.0latest2026/03/197 个月前
4.1.12025/12/1910 个月前
4.1.02025/12/1910 个月前
4.0.02025/12/1910 个月前
3.0.02025/12/1910 个月前
0.2.52025/02/191.7 年前

关于 @golevelup/nestjs-graphql-request 的常见问题

@golevelup/nestjs-graphql-request 是什么?

用于整合图克请求和NestJS的坏账公用事业

如何安装 @golevelup/nestjs-graphql-request?

在项目目录运行 npm install @golevelup/nestjs-graphql-request,或使用 pnpm add / yarn add / bun add。

@golevelup/nestjs-graphql-request 支持 TypeScript 吗?

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

@golevelup/nestjs-graphql-request 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@golevelup/nestjs-graphql-request 可以商用吗?

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

@golevelup/nestjs-graphql-request 的下载量有多少?

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

@golevelup/nestjs-graphql-request 还在维护吗?

最新版本 5.0.0 发布于 2026/03/19(7 个月前);至今共发布 28 个版本,其中过去 12 个月发布了 5 个;首次发布于 2020/03/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。