@glennsl/rescript-json-combinators

中文文档
1.6.0发布于 2026/10/16(LGPL-3.0 OR MPL-2.0)零依赖近 30 天下载 3168

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

中文使用文档
文档目录14 节
  1. 示例
  2. 安装
  3. 与bs-json的区别
  4. 文档
  5. API 密码
  6. 许可证
  7. 变动
  8. 1.6.0 (简体中文)
  9. 1.5.0 (中文(简体) )
  10. 1.4.0 (中文(简体) )
  11. 1.3.0 (单位:千美元)
  12. 1.2.0 (中文(简体) )
  13. 1.1.0 国家
  14. 1.0.0 (单位:千美元)

重写- json- 组合符

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

npm Issues Last Commit

示例

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

见 实例 为了更多.

安装

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

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

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

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

 {
   "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 密码

目前请参见界面文件 :

许可证

这项工作有双重许可证 LGPL 3. 0 数据 财务报告和审定财务报表 MPL 2.0 (韩语)。如果使用此工作,您可以在其中之一中选择.

请看 液态LGPL-3.0 财务报告和审定财务报表 液态. 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 共发布 9 个版本,首次发布于 2022/07/17;过去 12 个月发布了 3 个版本。

版本发布日期距今
1.6.0latest2026/10/161 个月前
1.5.12025/12/0511 个月前
1.5.02025/12/0511 个月前
1.4.02024/02/132 年前
1.3.02023/11/013 年前
1.2.12023/05/293 年前

关于 @glennsl/rescript-json-combinators 的常见问题

@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 和提交记录判断。