JSON5

在 Bun 中，JSON5 与 JSON、TOML 和 YAML 一样是一等公民。您可以：

使用 Bun.JSON5.parse 和 Bun.JSON5.stringify 解析和序列化 JSON5
在运行时 import 和 require JSON5 文件作为模块（包括热重载和监视模式支持）
在前端应用中使用 Bun 的打包器 import 和 require JSON5 文件

一致性

Bun 的 JSON5 解析器使用 Rust 编写，并通过了 100% 的官方 JSON5 测试套件。翻译后的测试套件列出了每个测试用例。

运行时 API

`Bun.JSON5.parse()`

将 JSON5 字符串解析为 JavaScript 值。

import { JSON5 } from "bun";

const data = JSON5.parse(`{
  // JSON5 支持注释
  name: 'my-app',
  version: '1.0.0',
  debug: true,

  // 允许尾逗号
  tags: ['web', 'api',],
}`);

console.log(data);
// {
//   name: "my-app",
//   version: "1.0.0",
//   debug: true,
//   tags: ["web", "api"]
// }

支持的 JSON5 特性

JSON5 是基于 ECMAScript 5.1 语法的 JSON 超集。它支持：

注释：单行（//）和多行（/* */）
尾逗号：在对象和数组中
未引用的键：任何有效的 ECMAScript 5.1 标识符
单引号字符串：除了双引号字符串外
多行字符串：使用反斜杠续行
十六进制数字：0xFF
前导和尾随小数点：.5 和 5.
Infinity 和 NaN：正数和负数
显式加号：+42

const data = JSON5.parse(`{
  // 未引用的键
  unquoted: 'keys work',

  // 单引号和双引号
  single: 'single-quoted',
  double: "double-quoted",

  // 尾逗号
  trailing: 'comma',

  // 特殊数字
  hex: 0xDEADbeef,
  half: .5,
  to: Infinity,
  nan: NaN,

  // 多行字符串
  multiline: 'line 1 \
line 2',
}`);

错误处理

Bun.JSON5.parse() 在输入无效 JSON5 时抛出 SyntaxError：

try {
  JSON5.parse("{invalid}");
} catch (error) {
  console.error("Failed to parse JSON5:", error.message);
}

`Bun.JSON5.stringify()`

将 JavaScript 值序列化为 JSON5 字符串。

import { JSON5 } from "bun";

const str = JSON5.stringify({ name: "my-app", version: "1.0.0" });
console.log(str);
// {name:'my-app',version:'1.0.0'}

美化打印

传递 space 参数以格式化输出并添加缩进：

const pretty = JSON5.stringify(
  {
    name: "my-app",
    debug: true,
    tags: ["web", "api"],
  },
  null,
  2,
);

console.log(pretty);
// {
//   name: 'my-app',
//   debug: true,
//   tags: [
//     'web',
//     'api',
//   ],
// }

space 参数可以是数字（空格数）或字符串（用作缩进字符）：

// 制表符缩进
JSON5.stringify(data, null, "\t");

特殊值

与 JSON.stringify 不同，JSON5.stringify 保留特殊的数值：

JSON5.stringify({ inf: Infinity, ninf: -Infinity, nan: NaN });
// {inf:Infinity,ninf:-Infinity,nan:NaN}

模块导入

ES 模块

您可以直接作为 ES 模块导入 JSON5 文件：

config.json5

{
  // 数据库配置
  database: {
    host: "localhost",
    port: 5432,
    name: "myapp",
  },

  features: {
    auth: true,
    rateLimit: true,
    analytics: false,
  },
}

默认导入

app.ts

import config from "./config.json5";

console.log(config.database.host); // "localhost"
console.log(config.features.auth); // true

命名导入

您可以将顶层属性解构为命名导入：

app.ts

import { database, features } from "./config.json5";

console.log(database.host); // "localhost"
console.log(features.rateLimit); // true

CommonJS

您也可以在 CommonJS 中 require JSON5 文件：

app.ts

const config = require("./config.json5");
console.log(config.database.name); // "myapp"

// 解构也能工作
const { database, features } = require("./config.json5");

JSON5 热重载

当您使用 bun --hot 运行应用程序时，Bun 会在 JSON5 文件更改时重新加载它们：

config.json5

{
  server: {
    port: 3000,
    host: "localhost",
  },
  features: {
    debug: true,
    verbose: false,
  },
}

server.ts

import { server, features } from "./config.json5";

Bun.serve({
  port: server.port,
  hostname: server.host,
  fetch(req) {
    if (features.verbose) {
      console.log(`${req.method} ${req.url}`);
    }
    return new Response("Hello World");
  },
});

使用热重载运行：

terminal

bun --hot server.ts

打包器集成

当您使用 Bun 打包时，导入的 JSON5 文件会在构建时解析并作为 JavaScript 模块包含：

terminal

bun build app.ts --outdir=dist

在构建时解析意味着：

生产环境中零运行时 JSON5 解析开销
更小的打包体积
未使用属性的摇树优化（命名导入）

动态导入

JSON5 文件可以被动态导入：

const { default: config } = await import("./config.json5");

开始入门

核心运行时

文件与模块系统

HTTP 服务器

网络通信

数据与存储

并发

进程与系统

互操作与工具

实用工具

标准与兼容性

贡献指南

一致性

运行时 API

`Bun.JSON5.parse()`

支持的 JSON5 特性

错误处理

`Bun.JSON5.stringify()`

美化打印

特殊值

模块导入

ES 模块

默认导入

命名导入

CommonJS

JSON5 热重载

打包器集成

动态导入

​一致性

​运行时 API

​Bun.JSON5.parse()

​支持的 JSON5 特性

​错误处理

​Bun.JSON5.stringify()

​美化打印

​特殊值

​模块导入

​ES 模块

​默认导入

​命名导入

​CommonJS

​JSON5 热重载

​打包器集成

​动态导入

一致性

运行时 API

`Bun.JSON5.parse()`

支持的 JSON5 特性

错误处理

`Bun.JSON5.stringify()`

美化打印

特殊值

模块导入

ES 模块

默认导入

命名导入

CommonJS

JSON5 热重载

打包器集成

动态导入