# @0no-co/graphql\.web 中文文档

规范地址：https://npmcn.com/package/%400no-co/graphql.web/

版本：1\.3\.4
npm 元数据更新时间：2026-08-21T17:06:23.889Z
中文译文更新时间：2026-11-05T16:49:53.969Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%400no-co/graphql.web
原文对照：https://npmcn.com/package/%400no-co/graphql.web/?lang=original
项目主页：https://github.com/0no-co/graphql.web#readme
源码仓库：https://github.com/0no-co/graphql.web

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

- 包体积（解压后）：117 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：graphql ^14\.0\.0 \|\| ^15\.0\.0 \|\| ^16\.0\.0 \|\| ^17\.0\.0
- 首次发布：2023-03-20T05:02:11.420Z
- 最新版本发布：2026-08-21T17:06:23.531Z
- 近 30 天下载量：24272330（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 5 个）

## 中文简介

符合规格的客户端图形QL执行

## 安装

```sh
npm install @0no-co/graphql.web
```

也可以使用：`pnpm add @0no-co/graphql.web`、`yarn add @0no-co/graphql.web`、`bun add @0no-co/graphql.web`

## README

## @0no-co/graphql.web (英语)

**客户端 GraphQL 符合规格的最小值 .**  
  
 [![CI Status](https://github.com/0no-co/graphql.web/actions/workflows/release.yml/badge.svg?branch=main)](https://github.com/0no-co/graphql.web/actions/workflows/release.yml)[![Bundlesize](https://deno.bundlejs.com/?q=@0no-co/graphql.web&badge) ](https://npmjs.com/package/@0no-co/graphql.web)[![Discord](https://img.shields.io/discord/1082378892523864074?color=7389D8&label&logo=discord&logoColor=ffffff)](https://urql.dev/discord)  
  

`@0no-co/graphql.web` 是一个公用图书馆,旨在提供最低限度的 通常从 `graphql`,例如GraphQL查询解析器、打印机和访问者.

虽然它的目标并不完全匹配 [图表QL.js API 密码](https://graphql.org/graphql-js/graphql/) 它的目标是保持API-和 在可能和必要的情况下,类型兼容。 然而,其目标是提供 通用图QL公用设备的最小执行 符合或符合 GraphQL.js 的执行.

> **说明:** 如果你是想找一个临时的替代 `graphql` 软件包,您可以在您的网络应用程序中添加别名, 更多关于 页:1 [`graphql-web-lite` 项目](https://github.com/0no-co/graphql-web-lite), (中文(简体) ), 使用此库来显示 `graphql` 软件包.

[`@urql/core`](https://github.com/urql-graphql/urql) 取决于此软件包到 授权其 GraphQL 查询解析和打印. **如果您在使用 `@urql/core@^4` 您已使用此库**

### 概览

`@0no-co/graphql.web` 旨在提供一套最低限度的出口,以执行 客户端图QL 公用设备,主要包括解析、打印和访问 图表QL AST,以及 `GraphQLError` 课.

目前, `graphql.web` 压缩到 4kB 以下, 并且不会倒退到 GraphQL.js在分析、打印或访问AST时的表现.

对所有初级API来说,我们的目标是达到100%的测试覆盖率并匹配输出, 类型,以及 GraphQL.js 的 API 兼容性,包括——尽可能 —— AST 类型与当前稳定兼容的脚本类型 图QL.js.

### API 密码

目前,只提供少数几种出口,即此处所列出口 用于 `@urql/core`我们期望它们在所有客户端都是常见的 图QL应用.

| 导出 | 说明 | 链接 |
| --- | --- | --- |
| `parse` | 微小( 但符合) GraphQL 查询语言解析器 . | [来源](https://npmcn.com/package/%400no-co/graphql.web/src/parser.ts) |
| `print` | A (符合) GraphQL 查询语言打印机 . | [来源](https://npmcn.com/package/%400no-co/graphql.web/src/printer.ts) |
| `visit` | GraphQL.js 访问者的递补执行. | [来源](https://npmcn.com/package/%400no-co/graphql.web/src/printer.ts) |
| `Kind` | 地图QL.js `Kind` enum, 包含支持 `ASTNode` 类型. | [来源](https://npmcn.com/package/%400no-co/graphql.web/src/kind.ts) |
| `GraphQLError` | `GraphQLError` 取消了源/位置调试. | [来源](https://npmcn.com/package/%400no-co/graphql.web/src/kind.ts) |
| `valueFromASTUntyped` | 强制AST值加入JS值. | [来源](https://npmcn.com/package/%400no-co/graphql.web/src/values.ts) |

任何重新实施的既定目标是:

1.  不执行 GraphQL 中的任何执行或系统部件 规格.
2.  尽可能遵守 GraphQL.js 的类型和API .
3.  不执行或披露任何极少使用的 API 或 属性 图QL.js 库.
4.  提供最低限度的可维护的GraphQL.js公用事业.

因此,虽然我们可以预见实施完全分开的和完全分开的API 未来与GraphQL.js 库无关,目前所宣称的目标是 用于允许 GraphQL 客户端使用此库, 如 [`@urql/core`](https://github.com/urql-graphql/urql)。 。 。 .

## 常见问题

### @0no-co/graphql\.web 是什么？

符合规格的客户端图形QL执行

### 如何安装 @0no-co/graphql\.web？

在项目目录运行 npm install @0no-co/graphql\.web，或使用 pnpm add / yarn add / bun add。

### @0no-co/graphql\.web 支持 TypeScript 吗？

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

### @0no-co/graphql\.web 支持 ESM 还是 CommonJS？

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

### @0no-co/graphql\.web 可以商用吗？

@0no-co/graphql\.web 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @0no-co/graphql\.web 的下载量有多少？

根据 npm 官方下载统计，@0no-co/graphql\.web 在 2026/10/04 – 2026/11/02 这 30 天内被下载 24,272,330 次，日均约 809,078 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @0no-co/graphql\.web 还在维护吗？

最新版本 1\.3\.4 发布于 2026/08/22（2 个月前）；至今共发布 56 个版本，其中过去 12 个月发布了 5 个；首次发布于 2023/03/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。