# @golevelup/nestjs-graphql-request 中文文档

规范地址：https://npmcn.com/package/%40golevelup/nestjs-graphql-request/

版本：5\.0\.0
npm 元数据更新时间：2026-03-18T20:15:22.053Z
中文译文更新时间：2026-11-16T18:44:03.188Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40golevelup/nestjs-graphql-request
原文对照：https://npmcn.com/package/%40golevelup/nestjs-graphql-request/?lang=original
项目主页：https://github.com/golevelup/nestjs#readme
源码仓库：https://github.com/golevelup/nestjs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：15.4 kB，27 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2020-03-27T21:42:47.982Z
- 最新版本发布：2026-03-18T20:15:21.910Z
- 近 30 天下载量：87356（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 5 个）

## 中文简介

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

## 安装

```sh
npm install @golevelup/nestjs-graphql-request
```

也可以使用：`pnpm add @golevelup/nestjs-graphql-request`、`yarn add @golevelup/nestjs-graphql-request`、`bun add @golevelup/nestjs-graphql-request`

## README

# 图QL 请求

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

[![version](https://img.shields.io/npm/v/@golevelup/nestjs-graphql-request.svg?style=flat)](https://www.npmjs.com/package/@golevelup/nestjs-graphql-request) [![downloads](https://img.shields.io/npm/dt/@golevelup/nestjs-graphql-request.svg?style=flat)](https://www.npmjs.com/package/@golevelup/nestjs-graphql-request) ![license](https://img.shields.io/npm/l/@golevelup/nestjs-graphql-request.svg)

## 开始

\* :密码组

```bash
npm install ---save @golevelup/nestjs-graphql-request
```

```bash
yarn add @golevelup/nestjs-graphql-request
```

```bash
pnpm add @golevelup/nestjs-graphql-request
```

\* :

## 导入

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

```typescript
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`。 。 。 .

```typescript
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 请求插件指令](https://graphql-code-generator.com/docs/plugins/typescript-graphql-request)。 。 。 .

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

```typescript
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 是什么？

用于整合图克请求和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 和提交记录判断。

