弃用警告：JSON 3 已不再维护！

弃用警告：JSON 3 已不再维护！

项目地址:https://gitcode.com/bestiejs/json3

请注意，JSON 3 现已被弃用并停止维护。我们建议您不要在新项目中使用它，并将现有的项目迁移到使用原生的 JSON.parse 和 JSON.stringify 方法。

但是，为了那些仍然寻找历史参考或理解旧代码库的人们，以下是关于 JSON 3 的详细介绍。

JSON 3 简介

JSON 3 是一个针对旧版JavaScript平台的JSON解析和序列化库。作为一个不依赖eval和正则表达式实现的JSON解析器，尽管在旧平台上性能可能较慢，但它严格遵循了ECMAScript规范（除了下文提到的一个日期序列化差异）。

该库由BestieJS团队维护，旨在提供跨平台支持、遵循规范、进行单元测试以及充分的文档说明。

技术分析

JSON 3 提供了两个主要函数：

• stringify() 函数用于将JavaScript值序列化为JSON字符串。
• parse() 函数用于从JSON源字符串中解析出JavaScript值。

与JSON规范相比，JSON 3的一个重要差异在于：它没有定义 Date#toISOString() 或 Date#toJSON() 方法。这样做是为了保持CommonJS兼容性，避免污染原始原型。相反，内部的stringify() 实现会负责处理日期对象的序列化。如果日期对象没有自定义的 toJSON() 方法，它会被序列化为简化版的ISO 8601日期时间字符串。

应用场景

浏览器环境

<script src="https://cdnjs.cloudflare.com/ajax/libs/json3/3.3.2/json3.min.js"></script>
<script>
  JSON.stringify({ "Hello": 123 }); // => '{"Hello":123}'
  JSON.parse('[["Odd", "Even", "Odd"], 1, 2, 3, 4]', function(key, value) {
    if (typeof value === "number") {
      value = value % 2 ? "Odd" : "Even";
    }
    return value;
  });
  // => [["Odd", "Even", "Odd"], "Odd", "Even", "Odd", "Even"]
</script>

JSON 3 在浏览器环境中还提供了额外的 JSON3 对象，包含了 noConflict() 和 runInContext() 函数，以及 stringify() 和 parse() 函数的别名。

模块加载器

对于 RequireJS、curl.js 等异步模块加载器，JSON 3 被定义为匿名模块，可以方便地与其他模块一起使用。

<script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.1.10/require.js"></script>
<script>
  require({
    "paths": {
      "json3": "./path/to/json3"
    }
  }, ["json3"], function(JSON) {
    JSON.parse("[1, 2, 3]");
  });
</script>

常见JavaScript引擎

如 Node.js、io.js、RingoJS、Narwhal 以及其他JavaScript环境也都可以使用JSON 3。

项目特点

• 兼容旧版JavaScript平台。
• 遵循ECMAScript 5.1规范，除了日期序列化的差异。
• 不修改原始 Date 类型，以保证CommonJS兼容性。
• 可通过 noConflict() 函数恢复全局 JSON 对象到其原始状态。
• 支持异步模块加载系统如 RequireJS。
• 经过多种浏览器和JavaScript环境的广泛测试。

尽管不再维护，但JSON 3的历史价值和在老项目中的作用仍不可忽视。如果您仍在使用这些旧平台，或者需要了解过去的技术解决方案，JSON 3是一个值得回顾的资源。

项目地址:https://gitcode.com/bestiejs/json3