# @glennsl/rescript-json-combinators 中文文档

规范地址：https://npmcn.com/package/%40glennsl/rescript-json-combinators/

版本：1\.6\.0
npm 元数据更新时间：2026-10-15T18:53:32.693Z
中文译文更新时间：2026-11-16T16:20:50.597Z
软件包许可：\(LGPL-3\.0 OR MPL-2\.0\)

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

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

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

- 包体积（解压后）：67.5 kB，12 个文件
- TypeScript 类型：未声明
- Node.js 要求：\*
- 运行依赖：0 个
- 首次发布：2022-07-17T12:30:34.211Z
- 最新版本发布：2026-10-15T18:53:32.544Z
- 近 30 天下载量：3168（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 3 个）

## 中文简介

JSON解码和编码的组合器库.

## 安装

```sh
npm install @glennsl/rescript-json-combinators
```

也可以使用：`pnpm add @glennsl/rescript-json-combinators`、`yarn add @glennsl/rescript-json-combinators`、`bun add @glennsl/rescript-json-combinators`

## README

# 重写- json- 组合符

JSON解码和编码的组合器库.

[![npm](https://img.shields.io/npm/v/@glennsl/rescript-json-combinators.svg)](https://npmjs.org/@glennsl/rescript-json-combinators) [![Issues](https://img.shields.io/github/issues/glennsl/rescript-json-combinators.svg)](https://github.com/glennsl/rescript-json-combinators/issues) [![Last Commit](https://img.shields.io/github/last-commit/glennsl/rescript-json-combinators.svg)](https://github.com/glennsl/rescript-json-combinators/commits/master)

## 示例

```rescript
type point = {
  x: int,
  y: int,
}

type polyline = {
  points: array<point>,
  thickness: option<int>,
}

module Decode = {
  open Json.Decode

  let point = object(field => {
    x: field.required(. "x", int),
    y: field.required(. "y", int),
  })

  let polyline = object(field => {
    points: field.required(. "points", array(point)),
    thickness: field.optional(. "thickness", int),
  })
}

let data = `{
  "points": [
    { "x": 1, "y": -4 },
    { "x": 5, "y": 8 }
  ]
}`

let _ = data->Js.Json.parseExn->Json.decode(Decode.polyline)->Js.log
```

见 [实例](https://github.com/glennsl/rescript-json-combinators/blob/master/examples/) 为了更多.

## 安装

```sh
npm install --save @glennsl/rescript-json-combinators
```

然后添加 `@glennsl/rescript-json-combinators` 改为 `bs-dependencies` 在你身边 `bsconfig.json`数字 :

```diff
 {
   "bs-dependencies": [
+    "@glennsl/rescript-json-combinators"
   ]
 }
```

可选情况下, 添加此选项可自动打开库以使用 `Json.Encode` 财务报告和审定财务报表 `Json.Decode` 直接 :

```diff
 {
   "bsc-flags": [
+    "-open JsonCombinators",
   ]
 }
```

## 与bs-json的区别

`rescript-json-combinators` 优先继承 `bs-json`。它是从零开始改写的,无意成为 向后兼容 。 虽然大多数情况下都具有相同的设计原则,但也有一些显著的差异:

-   解码器已被抽象化. 虽然内部代表性保持不变,但这一职能需要 `Js.Json.t` 并返回已解码的值或提出例外,它们不再可以直接调用。 相反,他们必须运行 通过 `Decode.decode`这样做是为了确保 `DecodeError` 例外不漏出并返回 a `result` 换句话说 自定义解码器仍然可用 `Decode.custom`。 。 。 .
    
-   一个新的 `object` 已添加了解码器, 虽然仍然可以在自定义解码器中单独解码字段, 但此 用这种方法解决几个人类基因组问题,例如区分缺失的领域和错误 类型,以及自定义解码器的过度使用和封装.
    
-   出行和生地javascript在一些地方被用来提高性能. 这大部分是看不到的 终端用户,因为已无法直接调用解码器. 不过也有几种例外,比如里面的字段解码器 页:1 `object` 脱壳器,以及 `map`。 。 。 .
    

## 文档

### API 密码

目前请参见界面文件 :

-   [贾森](https://github.com/glennsl/rescript-json-combinators/blob/master/src/Json.resi)
-   [贾生. 编码](https://github.com/glennsl/rescript-json-combinators/blob/master/src/Json_Encode.resi)
-   [贾生. 解码](https://github.com/glennsl/rescript-json-combinators/blob/master/src/Json_Decode.resi)

## 许可证

这项工作有双重许可证 [LGPL 3. 0 数据](https://choosealicense.com/licenses/lgpl-3.0/) 财务报告和审定财务报表 [MPL 2.0 (韩语)](https://choosealicense.com/licenses/mpl-2.0/)。如果使用此工作,您可以在其中之一中选择.

请看 [液态LGPL-3.0](https://github.com/glennsl/rescript-json-combinators/blob/master/LICENSE.LGPL-3.0) 财务报告和审定财务报表 [液态. MPL-2.0](https://github.com/glennsl/rescript-json-combinators/blob/master/LICENSE.MPL-2.0) 每个许可证的全文.

`SPDX-License-Identifier: LGPL-3.0 OR MPL-2.0`

## 变动

### 1.6.0 (简体中文)

-   添加 `Decode.recursive` 自引用解码器

### 1.5.0 (中文(简体) )

-   更新为重述 12

### 1.4.0 (中文(简体) )

-   明确显示的编码组合器以减少11个未显示模式中的断裂
-   更新实例以重述 11

### 1.3.0 (单位:千美元)

-   添加 `Decode.indirect` 帮助解码递归数据结构

### 1.2.0 (中文(简体) )

-   添加 `Decode.flatMap`

### 1.1.0 国家

-   reript v11 兼容格式化 (# 3)

### 1.0.0 (单位:千美元)

初步释放

## 常见问题

### @glennsl/rescript-json-combinators 是什么？

JSON解码和编码的组合器库\.

### 如何安装 @glennsl/rescript-json-combinators？

在项目目录运行 npm install @glennsl/rescript-json-combinators，或使用 pnpm add / yarn add / bun add。

### @glennsl/rescript-json-combinators 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/glennsl\_\_rescript-json-combinators 是否存在。

### @glennsl/rescript-json-combinators 需要什么版本的 Node\.js？

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

### @glennsl/rescript-json-combinators 可以商用吗？

@glennsl/rescript-json-combinators 使用 \(LGPL-3\.0 OR MPL-2\.0\) 许可。可在 LGPL-3\.0、MPL-2\.0 中任选其一遵守。以上为概括，不构成法律意见，请以许可原文为准。

### @glennsl/rescript-json-combinators 的下载量有多少？

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

### @glennsl/rescript-json-combinators 还在维护吗？

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

