npm - @qubit-ltd/json - Versions diffs - 1.2.0 → 1.2.2 - Mend

@qubit-ltd/json 1.2.0 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (63) hide show

package/doc/api/LosslessNumber.html +3 -610
package/doc/api/data/search.json +1 -0
package/doc/api/fonts/Inconsolata-Regular.ttf +0 -0
package/doc/api/fonts/OpenSans-Regular.ttf +0 -0
package/doc/api/fonts/WorkSans-Bold.ttf +0 -0
package/doc/api/global.html +3 -1274
package/doc/api/index.html +63 -264
package/doc/api/scripts/core.js +726 -0
package/doc/api/scripts/core.min.js +23 -0
package/doc/api/scripts/resize.js +90 -0
package/doc/api/scripts/search.js +265 -0
package/doc/api/scripts/search.min.js +6 -0
package/doc/api/scripts/{prettify → third-party}/Apache-License-2.0.txt +202 -202
package/doc/api/scripts/third-party/fuse.js +9 -0
package/doc/api/scripts/third-party/hljs-line-num-original.js +369 -0
package/doc/api/scripts/third-party/hljs-line-num.js +1 -0
package/doc/api/scripts/third-party/hljs-original.js +5171 -0
package/doc/api/scripts/third-party/hljs.js +1 -0
package/doc/api/scripts/third-party/popper.js +5 -0
package/doc/api/scripts/third-party/tippy.js +1 -0
package/doc/api/scripts/third-party/tocbot.js +672 -0
package/doc/api/scripts/third-party/tocbot.min.js +1 -0
package/doc/api/styles/clean-jsdoc-theme-base.css +1159 -0
package/doc/api/styles/clean-jsdoc-theme-dark.css +412 -0
package/doc/api/styles/clean-jsdoc-theme-light.css +482 -0
package/doc/api/styles/clean-jsdoc-theme-scrollbar.css +30 -0
package/doc/api/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
package/doc/api/styles/clean-jsdoc-theme.min.css +1 -0
package/doc/json.min.visualization.html +1 -1
package/doc/json.visualization.html +1 -1
package/package.json +2 -3
package/doc/api/fonts/OpenSans-Bold-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Bold-webfont.svg +0 -1838
package/doc/api/fonts/OpenSans-Bold-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-BoldItalic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-BoldItalic-webfont.svg +0 -1838
package/doc/api/fonts/OpenSans-BoldItalic-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Italic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Italic-webfont.svg +0 -1838
package/doc/api/fonts/OpenSans-Italic-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Light-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Light-webfont.svg +0 -1839
package/doc/api/fonts/OpenSans-Light-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-LightItalic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-LightItalic-webfont.svg +0 -1843
package/doc/api/fonts/OpenSans-LightItalic-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Regular-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Regular-webfont.svg +0 -1839
package/doc/api/fonts/OpenSans-Regular-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-Semibold-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-Semibold-webfont.svg +0 -1838
package/doc/api/fonts/OpenSans-Semibold-webfont.ttf +0 -0
package/doc/api/fonts/OpenSans-Semibold-webfont.woff +0 -0
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.eot +0 -0
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.svg +0 -1838
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.ttf +0 -0
package/doc/api/fonts/OpenSans-SemiboldItalic-webfont.woff +0 -0
package/doc/api/scripts/linenumber.js +0 -34
package/doc/api/scripts/prettify/lang-css.js +0 -2
package/doc/api/scripts/prettify/prettify.js +0 -28
package/doc/api/styles/jsdoc-default.css +0 -699
package/doc/api/styles/prettify-jsdoc.css +0 -120
package/doc/api/styles/prettify-tomorrow.css +0 -141

package/doc/api/index.html CHANGED Viewed

@@ -1,99 +1,10 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width,initial-scale=1">
-    <title>Home - Documentation</title>
+<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Home</title><!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124    C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124    c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227    c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6    V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474    c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323    c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848    S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328    c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="dark"><div class="sidebar-container"><div class="sidebar" id="sidebar"><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="LosslessNumber.html">LosslessNumber</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#getUnsafeReason">getUnsafeReason</a></div><div class="sidebar-section-children"><a href="global.html#isBigInt">isBigInt</a></div><div class="sidebar-section-children"><a href="global.html#isInteger">isInteger</a></div><div class="sidebar-section-children"><a href="global.html#isNumber">isNumber</a></div><div class="sidebar-section-children"><a href="global.html#isSafeNumber">isSafeNumber</a></div><div class="sidebar-section-children"><a href="global.html#json">json</a></div><div class="sidebar-section-children"><a href="global.html#toSafeNumberOrThrow">toSafeNumberOrThrow</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section class="readme"><article><h1>增强的 JSON 解析器，支持大整数和集合</h1><p><a href="https://npmjs.com/package/@qubit-ltd/json"><img src="https://img.shields.io/npm/v/@qubit-ltd/json.svg" alt="npm package"></a><a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache-blue.svg" alt="License"></a><a href="README.md"><img src="https://img.shields.io/badge/Document-English-blue.svg" alt="English Document"></a><a href="https://dl.circleci.com/status-badge/redirect/gh/Haixing-Hu/js-json/tree/master"><img src="https://dl.circleci.com/status-badge/img/gh/Haixing-Hu/js-json/tree/master.svg?style=shield" alt="CircleCI"></a><a href="https://coveralls.io/github/Haixing-Hu/js-json?branch=master"><img src="https://coveralls.io/repos/github/Haixing-Hu/js-json/badge.svg?branch=master" alt="Coverage Status"></a></p><p><a href="https://npmjs.com/package/@qubit-ltd/json">@qubit-ltd/json</a> 是一个 JavaScript 库，它扩展了标准 JSON 对象的功能，提供了对超出 JavaScript 安全范围的大数字的强大支持。该库增强了解析和字符串化能力，使其非常适合处理大型数据集和复杂的数值操作， 同时保持 JSON 的结构。</p><h2>主要功能</h2><ul><li><strong><code>BigInt</code> 支持</strong>：在解析 JSON 字符串时，超出 JavaScript 安全整数范围的数字会自动转换为原生 <code>BigInt</code>， 确保精度不丢失。</li><li><strong><code>LosslessNumber</code> 处理</strong>：对于无法在 JavaScript 中准确表示的浮点数，该库引入了 <code>LosslessNumber</code> 对象。 这个轻量级对象以字符串形式保存完整的数值精度，允许灵活地转换为数字或 <code>BigInt</code> 进行数学运算。</li><li><strong>精确的字符串化</strong>：在字符串化过程中，<code>BigInt</code> 值会作为字符串序列化，不带 &quot;n&quot; 后缀，以保持与标准 JSON 格式的兼容性。 同样，<code>LosslessNumber</code> 对象使用其内部字符串表示进行序列化。</li><li><strong>集合序列化</strong>：JavaScript 原生的集合类型如 <code>Set</code> 和 <code>Map</code> 会无缝地序列化为数组，以便更好地与 JSON 结构兼容。</li></ul><p>有关为什么 JSON 解析可能会破坏大数字以及该库如何帮助解决该问题的更多详细信息，请参阅 <a href="https://jsoneditoronline.org/indepth/parse/why-does-json-parse-corrupt-large-numbers/">Why does JSON.parse corrupt large numbers and how to solve this?</a>。</p><h2>安装</h2><p>使用 npm 或 yarn 安装该库：</p><pre class="prettyprint source lang-sh"><code>npm install @qubit-ltd/json
+</code></pre><p>或</p><pre class="prettyprint source lang-sh"><code>yarn add @qubit-ltd/json
+</code></pre><h2>核心功能</h2><h3>类似 JSON 的对象</h3><p>该库提供了一个类似于标准 JSON 对象的对象，但具有增强的功能，用于处理大整数、浮点数以及集合类型如 Set 和 Map。</p><pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
-    <script src="scripts/prettify/prettify.js"></script>
-    <script src="scripts/prettify/lang-css.js"></script>
-    <!--[if lt IE 9]>
-      <script src="https://cdn.bootcdn.net/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
-    <![endif]-->
-    <link type="text/css" rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/ionicons/2.0.1/css/ionicons.min.css">
-    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
-    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
-</head>
-<body>
-<input type="checkbox" id="nav-trigger" class="nav-trigger" />
-<label for="nav-trigger" class="navicon-button x">
-  <div class="navicon"></div>
-</label>
-<label for="nav-trigger" class="overlay"></label>
-<nav>
-    <li class="nav-link nav-home-link"><a href="index.html">Home</a></li><li class="nav-heading">Classes</li><li class="nav-heading"><span class="nav-item-type type-class">C</span><span class="nav-item-name"><a href="LosslessNumber.html">LosslessNumber</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="LosslessNumber.html#toString">toString</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="LosslessNumber.html#valueOf">valueOf</a></span></li><li class="nav-heading"><a href="global.html">Globals</a></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#getUnsafeReason">getUnsafeReason</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#isBigInt">isBigInt</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#isInteger">isInteger</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#isNumber">isNumber</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#isSafeNumber">isSafeNumber</a></span></li><li class="nav-item"><span class="nav-item-type type-member">M</span><span class="nav-item-name"><a href="global.html#json">json</a></span></li><li class="nav-item"><span class="nav-item-type type-function">F</span><span class="nav-item-name"><a href="global.html#toSafeNumberOrThrow">toSafeNumberOrThrow</a></span></li>
-</nav>
-<div id="main">
-    <section class="readme">
-        <article><h1>Enhanced JSON Parsing and Stringification for Large Numbers and Collections</h1>
-<p><a href="https://npmjs.com/package/@qubit-ltd/json"><img src="https://img.shields.io/npm/v/@qubit-ltd/json.svg" alt="npm package"></a>
-<a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache-blue.svg" alt="License"></a>
-<a href="README.zh_CN.md"><img src="https://img.shields.io/badge/%E6%96%87%E6%A1%A3-%E4%B8%AD%E6%96%87%E7%89%88-blue.svg" alt="中文文档"></a>
-<a href="https://dl.circleci.com/status-badge/redirect/gh/Haixing-Hu/js-json/tree/master"><img src="https://dl.circleci.com/status-badge/img/gh/Haixing-Hu/js-json/tree/master.svg?style=shield" alt="CircleCI"></a>
-<a href="https://coveralls.io/github/Haixing-Hu/js-json?branch=master"><img src="https://coveralls.io/repos/github/Haixing-Hu/js-json/badge.svg?branch=master" alt="Coverage Status"></a></p>
-<p><a href="https://npmjs.com/package/@qubit-ltd/json">@qubit-ltd/json</a> is a JavaScript library that extends the functionality of the
-standard JSON object, providing robust support for working with numbers that
-exceed JavaScript's safe range. It offers enhanced parsing and stringifying
-capabilities, making it ideal for handling large datasets and complex numerical
-operations while adhering to JSON's structure.</p>
-<h2>Key Features</h2>
-<ul>
-<li><strong><code>BigInt</code> Support</strong>: When parsing JSON strings, numbers outside JavaScript's safe
-integer range are automatically converted to the native <code>BigInt</code>, ensuring
-precision is maintained.</li>
-<li><strong><code>LosslessNumber</code> Handling</strong>: For floating-point numbers that cannot be accurately
-represented in JavaScript, this library introduces the <code>LosslessNumber</code> object.
-This lightweight object preserves the full precision of the number as a string,
-allowing flexible conversion to number or <code>BigInt</code> for mathematical operations.</li>
-<li><strong>Accurate Stringification</strong>: During the stringify process, <code>BigInt</code> values are
-serialized as strings without the &quot;n&quot; suffix, maintaining compatibility with
-the standard JSON format. Similarly, <code>LosslessNumber</code> objects are serialized
-using their internal string representation.</li>
-<li><strong>Collection Serialization</strong>: JavaScript's native collections like <code>Set</code> and <code>Map</code>
-are seamlessly serialized as arrays, allowing for better compatibility with
-JSON structures.</li>
-</ul>
-<p>For more details on why JSON parsing can corrupt large numbers and how this
-library helps resolve the issue, refer to
-<a href="https://jsoneditoronline.org/indepth/parse/why-does-json-parse-corrupt-large-numbers/">Why does JSON.parse corrupt large numbers and how to solve this?</a>.</p>
-<h2>Installation</h2>
-<p>To install the library, use either npm or yarn:</p>
-<pre class="prettyprint source lang-sh"><code>npm install @qubit-ltd/json
-</code></pre>
-<p>or</p>
-<pre class="prettyprint source lang-sh"><code>yarn add @qubit-ltd/json
-</code></pre>
-<h2>Core Functionality</h2>
-<h3>JSON-like Object</h3>
-<p>The library provides an object similar to the standard JSON object, but with
-enhanced capabilities for handling large integers, floating-point numbers, and
-collections like Set and Map.</p>
-<pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
-// Parse numbers outside the safe range
+// 解析超出安全范围的数字
 const str1 = '{&quot;decimal&quot;:2.370,&quot;big_int&quot;:9123372036854000123,&quot;big_float&quot;:2.3e+500}';
 const obj1 = Json.parse(str1);
 console.log(obj1.decimal);   // 2.37
@@ -101,11 +12,11 @@ console.log(obj1.big_int);   // 9123372036854000123n
 console.log(obj1.big_float); // LosslessNumber { value: '2.3e+500', isLosslessNumber: true }
 console.log(String(obj1.big_float)); // '2.3e+500'
-// Stringify numbers outside the safe range
+// 序列化超出安全范围的数字
 const json1 = Json.stringify(obj1);
 console.log(json1); // '{&quot;decimal&quot;:2.37,&quot;big_int&quot;:9123372036854000123,&quot;big_float&quot;:&quot;2.3e+500&quot;}'
-// Stringify collections
+// 序列化集合类型
 const obj2 = {
   x: new Set([{ a: 1 }, { b: 2 }, { c: 3 }]),
   y: new Map([[1, { a: 2 }], [2, { b: 4 }]]),
@@ -113,10 +24,10 @@ const obj2 = {
 const json2 = Json.stringify(obj2);
 console.log(json2); // '{&quot;x&quot;:[{&quot;a&quot;:1},{&quot;b&quot;:2},{&quot;c&quot;:3}],&quot;y&quot;:[[1,{&quot;a&quot;:2}],[2,{&quot;b&quot;:4}]]}'
-// Pretty-print with indentation
+// 格式化输出（带缩进）
 const json3 = Json.stringify(obj2, null, 2);
 console.log(json3);
-/* Output:
+/* 输出:
 {
   &quot;x&quot;: [
     {
@@ -145,147 +56,106 @@ console.log(json3);
   ]
 }
 */
-</code></pre>
-<h3>LosslessNumber Class</h3>
-<p>The <code>LosslessNumber</code> class is used to handle floating-point numbers with full
-precision, avoiding truncation or rounding issues.</p>
-<pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
+</code></pre><h3>LosslessNumber 类</h3><p><code>LosslessNumber</code> 类用于处理具有完整精度的浮点数，避免截断或舍入问题。</p><pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
 import { LosslessNumber } from '@qubit-ltd/json';
-// Parse a number with high precision
+// 解析高精度数字
 const parsed = Json.parse('{&quot;float&quot;: 1.234567891234567891234}');
 console.log(parsed.float);  // LosslessNumber { value: '1.234567891234567891234' }
-// Convert LosslessNumber to standard number
-console.log(parsed.float.valueOf());  // 1.2345678912345679 (standard JS number, precision loss)
+// 将 LosslessNumber 转换为标准数字
+console.log(parsed.float.valueOf());  // 1.2345678912345679（标准 JS 数字，有精度损失）
-// Create a LosslessNumber directly
+// 直接创建 LosslessNumber
 const largeNumber = new LosslessNumber('9876543210.123456789012345678901234567890');
 console.log(largeNumber.toString());  // '9876543210.123456789012345678901234567890'
-console.log(largeNumber.valueOf());   // 9876543210.123457 (standard JS number with precision loss)
+console.log(largeNumber.valueOf());   // 9876543210.123457（标准 JS 数字，有精度损失）
-// Mathematical operations
+// 数学运算
 const num1 = new LosslessNumber('1234567890.123456789');
 const num2 = 100;
-// For math operations, LosslessNumber is converted to standard number (with potential precision loss)
+// 对于数学运算，LosslessNumber 会转换为标准数字（可能有精度损失）
 console.log(num1 * num2);  // 123456789012.34578
-</code></pre>
-<h3>Utility Functions</h3>
-<p>This library provides a set of utility functions to aid in the handling of large
-numbers and ensure safe conversions.</p>
-<h4><code>isBigInt(value)</code></h4>
-<p>Checks if a string represents a <code>BigInt</code> (i.e., ends with an &quot;n&quot; suffix).</p>
-<pre class="prettyprint source lang-javascript"><code>import { isBigInt } from '@qubit-ltd/json';
+</code></pre><h3>实用函数</h3><p>该库提供了一组实用函数，用于处理大数字并确保安全转换。</p><h4><code>isBigInt(value)</code></h4><p>检查一个字符串是否表示 <code>BigInt</code>（即是否以 &quot;n&quot; 结尾）。</p><pre class="prettyprint source lang-javascript"><code>import { isBigInt } from '@qubit-ltd/json';
 console.log(isBigInt('12345n'));  // true
 console.log(isBigInt('12345'));   // false
-</code></pre>
-<h4><code>isInteger(value)</code></h4>
-<p>Checks if a string represents an integer.</p>
-<pre class="prettyprint source lang-javascript"><code>import { isInteger } from '@qubit-ltd/json';
+</code></pre><h4><code>isInteger(value)</code></h4><p>检查一个字符串是否表示整数。</p><pre class="prettyprint source lang-javascript"><code>import { isInteger } from '@qubit-ltd/json';
 console.log(isInteger('12345'));  // true
 console.log(isInteger('123.45')); // false
-console.log(isInteger('123e5'));  // true (12300000 is an integer)
-console.log(isInteger('123e-5')); // false (0.00123 is not an integer)
-</code></pre>
-<h4><code>isNumber(value)</code></h4>
-<p>Checks if a string represents a number.</p>
-<pre class="prettyprint source lang-javascript"><code>import { isNumber } from '@qubit-ltd/json';
+console.log(isInteger('123e5'));  // true（12300000 是整数）
+console.log(isInteger('123e-5')); // false（0.00123 不是整数）
+</code></pre><h4><code>isNumber(value)</code></h4><p>检查一个字符串是否表示数字。</p><pre class="prettyprint source lang-javascript"><code>import { isNumber } from '@qubit-ltd/json';
 console.log(isNumber('12345'));     // true
 console.log(isNumber('-123.45'));   // true
 console.log(isNumber('1.23e-11'));  // true
 console.log(isNumber('abc'));       // false
 console.log(isNumber('123abc'));    // false
-console.log(isNumber('0xFF'));      // false (hexadecimal notation not supported)
-</code></pre>
-<h4><code>isSafeNumber(value, options)</code></h4>
-<p>Checks if a string represents a number within JavaScript's safe range.</p>
-<pre class="prettyprint source lang-javascript"><code>import { isSafeNumber } from '@qubit-ltd/json';
+console.log(isNumber('0xFF'));      // false（不支持十六进制表示法）
+</code></pre><h4><code>isSafeNumber(value, options)</code></h4><p>检查一个字符串是否表示在 JavaScript 安全范围内的数字。</p><pre class="prettyprint source lang-javascript"><code>import { isSafeNumber } from '@qubit-ltd/json';
 console.log(isSafeNumber('12345'));     // true
-console.log(isSafeNumber('12345678901234567890')); // false (too large for JavaScript's number type)
-console.log(isSafeNumber('123.45678901234567890')); // false (too many significant digits)
+console.log(isSafeNumber('12345678901234567890')); // false（对于 JavaScript 的数字类型来说太大）
+console.log(isSafeNumber('123.45678901234567890')); // false（有效数字太多）
-// With options
+// 使用选项
 console.log(isSafeNumber('123.45678901234567890', {
-  approx: true,         // Allow approximate representation
-  requiredDigits: 16    // Require at least 16 digits of precision
+  approx: true,         // 允许近似表示
+  requiredDigits: 16    // 要求至少保留 16 位有效数字精度
 })); // true
-</code></pre>
-<h4><code>getUnsafeReason(value)</code></h4>
-<p>Explains why a number represented by a string is unsafe, returning one of the
-following reasons:</p>
-<ul>
-<li><code>'overflow'</code>: The number is too large to be represented in JavaScript</li>
-<li><code>'underflow'</code>: The number is too small to be represented in JavaScript</li>
-<li><code>'truncate_integer'</code>: The integer part would be truncated if converted to a JavaScript number</li>
-<li><code>'truncate_float'</code>: The floating-point part would lose precision if converted to a JavaScript number</li>
-<li><code>'none'</code>: The value is safe to convert to a JavaScript number</li>
-</ul>
-<pre class="prettyprint source lang-javascript"><code>import { getUnsafeReason } from '@qubit-ltd/json';
+</code></pre><h4><code>getUnsafeReason(value)</code></h4><p>解释为什么由字符串表示的数字不安全，返回以下原因之一：</p><ul><li><code>'overflow'</code>（溢出）：数字太大，超出了 JavaScript 可表示的范围</li><li><code>'underflow'</code>（下溢）：数字太小，低于 JavaScript 可表示的范围</li><li><code>'truncate_integer'</code>（整数截断）：如果转换为 JavaScript 数字，整数部分会被截断</li><li><code>'truncate_float'</code>（浮点数截断）：如果转换为 JavaScript 数字，浮点部分会失去精度</li><li><code>'none'</code>：值是安全的，可以安全地转换为 JavaScript 数字</li></ul><pre class="prettyprint source lang-javascript"><code>import { getUnsafeReason } from '@qubit-ltd/json';
-console.log(getUnsafeReason('12345'));     // Output: 'none'
-console.log(getUnsafeReason('12345678901234567890')); // Output: 'truncate_integer'
-console.log(getUnsafeReason('-12345678901234567890.123'));  //  Output: 'truncate_float'
-console.log(getUnsafeReason('-1e+1000'));   // Output: 'overflow'
-console.log(getUnsafeReason('1e-324'));     // Output: 'underflow'
-</code></pre>
-<h4><code>toSafeNumberOrThrow(value, options)</code></h4>
-<p>Converts a string into a number if it is safe to do so. Throws an error if the
-number is unsafe, explaining the reason. This is useful for validating numeric inputs.</p>
-<pre class="prettyprint source lang-javascript"><code>import { toSafeNumberOrThrow } from '@qubit-ltd/json';
+console.log(getUnsafeReason('12345'));     // 输出: 'none'
+console.log(getUnsafeReason('12345678901234567890')); // 输出: 'truncate_integer'
+console.log(getUnsafeReason('-12345678901234567890.123'));  //  输出: 'truncate_float'
+console.log(getUnsafeReason('-1e+1000'));   // 输出: 'overflow'
+console.log(getUnsafeReason('1e-324'));     // 输出: 'underflow'
+</code></pre><h4><code>toSafeNumberOrThrow(value, options)</code></h4><p>如果可以安全转换，将字符串转换为数字。如果数字不安全，则抛出错误并解释原因。这对于验证数字输入非常有用。</p><pre class="prettyprint source lang-javascript"><code>import { toSafeNumberOrThrow } from '@qubit-ltd/json';
 try {
   console.log(toSafeNumberOrThrow('-12345678901234567890'));
 } catch (e) {
-  console.error(e.message);  // Output: 'Cannot safely convert to number: the value '-12345678901234567890' would truncate integer and become -12345678901234567000'
+  console.error(e.message);  // 输出: 'Cannot safely convert to number: the value '-12345678901234567890' would truncate integer and become -12345678901234567000'
 }
-// Safe conversion example
-console.log(toSafeNumberOrThrow('9007199254740991'));  // Output: 9007199254740991
+// 安全转换示例
+console.log(toSafeNumberOrThrow('9007199254740991'));  // 输出: 9007199254740991
-// With options
+// 使用选项
 try {
   console.log(toSafeNumberOrThrow('123.45678901234567890', {
-    approx: false,        // Do not allow approximate representation
-    requiredDigits: 20    // Require at least 20 digits of precision
+    approx: false,        // 不允许近似表示
+    requiredDigits: 20    // 要求至少保留 20 位有效数字精度
   }));
 } catch (e) {
-  console.error(e.message);  // Will throw error about precision loss
+  console.error(e.message);  // 将抛出关于精度损失的错误
 }
-</code></pre>
-<h2>Advanced Usage</h2>
-<h3>Custom Parsing Options</h3>
-<p>You can customize how numbers are parsed using options:</p>
-<pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
+</code></pre><h2>高级用法</h2><h3>自定义解析选项</h3><p>您可以使用选项自定义数字的解析方式：</p><pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
 const json = '{&quot;bigInt&quot;: 9007199254740993, &quot;largeFloat&quot;: 1.234567890123456789}';
-// Use custom parsing options
+// 使用自定义解析选项
 const result = Json.parse(json, {
-  useBigInt: true,  // Default is true - convert large integers to BigInt
-  losslessNumbers: true,  // Default is true - use LosslessNumber for high-precision floats
+  useBigInt: true,  // 默认为 true - 将大整数转换为 BigInt
+  losslessNumbers: true,  // 默认为 true - 为高精度浮点数使用 LosslessNumber
 });
 console.log(typeof result.bigInt);  // 'bigint'
 console.log(result.bigInt);         // 9007199254740993n
 console.log(result.largeFloat);     // LosslessNumber { value: '1.234567890123456789' }
-// Disable custom number handling
+// 禁用自定义数字处理
 const standardResult = Json.parse(json, {
   useBigInt: false,
   losslessNumbers: false,
 });
 console.log(typeof standardResult.bigInt);  // 'number'
-console.log(standardResult.bigInt);         // 9007199254740992 (precision loss!)
-console.log(standardResult.largeFloat);     // 1.2345678901234568 (precision loss!)
-</code></pre>
-<h3>Custom Stringification Options</h3>
-<p>You can customize how values are stringified:</p>
-<pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
+console.log(standardResult.bigInt);         // 9007199254740992（精度损失！）
+console.log(standardResult.largeFloat);     // 1.2345678901234568（精度损失！）
+</code></pre><h3>自定义字符串化选项</h3><p>您可以自定义值的字符串化方式：</p><pre class="prettyprint source lang-javascript"><code>import Json from '@qubit-ltd/json';
 const data = {
   bigInt: BigInt('9007199254740993'),
@@ -294,13 +164,13 @@ const data = {
   map: new Map([['a', 1], ['b', 2]]),
 };
-// Default stringification (handles BigInt, LosslessNumber, Set, Map)
+// 默认字符串化（处理 BigInt、LosslessNumber、Set、Map）
 console.log(Json.stringify(data));
 // '{&quot;bigInt&quot;:9007199254740993,&quot;largeFloat&quot;:&quot;1.234567890123456789&quot;,&quot;set&quot;:[1,2,3],&quot;map&quot;:[[&quot;a&quot;,1],[&quot;b&quot;,2]]}'
-// With custom options and indentation
+// 使用自定义选项和缩进
 console.log(Json.stringify(data, null, 2));
-/* Output:
+/* 输出:
 {
   &quot;bigInt&quot;: 9007199254740993,
   &quot;largeFloat&quot;: &quot;1.234567890123456789&quot;,
@@ -321,83 +191,12 @@ console.log(Json.stringify(data, null, 2));
   ]
 }
 */
-</code></pre>
-<h2><span id="contributing">Contributing</span></h2>
-<p>If you find any issues or have suggestions for improvements, please feel free
-to open an issue or submit a pull request to the <a href="https://github.com/Haixing-Hu/js-json">GitHub repository</a>.</p>
-<h3>Development Setup</h3>
-<ol>
-<li>
-<p>Clone the repository:</p>
-<pre class="prettyprint source lang-sh"><code>git clone https://github.com/Haixing-Hu/js-json.git
+</code></pre><h2><span id="contributing">贡献</span></h2><p>如果您发现任何问题或有改进建议，请随时在 <a href="https://github.com/Haixing-Hu/js-json">GitHub 仓库</a> 上提交 issue 或 pull request。</p><h3>开发设置</h3><ol><li><p>克隆仓库：</p><pre class="prettyprint source lang-sh"><code>git clone https://github.com/Haixing-Hu/js-json.git
 cd js-json
-</code></pre>
-</li>
-<li>
-<p>Install dependencies:</p>
-<pre class="prettyprint source lang-sh"><code>yarn install
-</code></pre>
-</li>
-<li>
-<p>Run tests:</p>
-<pre class="prettyprint source lang-sh"><code>yarn test
-</code></pre>
-</li>
-<li>
-<p>Build the library:</p>
-<pre class="prettyprint source lang-sh"><code>yarn build
-</code></pre>
-</li>
-</ol>
-<h3>Release Process</h3>
-<ol>
-<li>Update version in package.json</li>
-<li>Run tests and linting:<pre class="prettyprint source lang-sh"><code>yarn lint && yarn test
-</code></pre>
-</li>
-<li>Build the library:<pre class="prettyprint source lang-sh"><code>yarn build:all
-</code></pre>
-</li>
-<li>Publish to npm:<pre class="prettyprint source lang-sh"><code>yarn deploy
-</code></pre>
-</li>
-</ol>
-<h2><span id="license">License</span></h2>
-<p><a href="https://npmjs.com/package/@qubit-ltd/json">@qubit-ltd/json</a> is distributed under the Apache 2.0 license.
-See the <a href="LICENSE">LICENSE</a> file for more details.</p>
-<h2><span id="acknowledgements">Acknowledgements</span></h2>
-<p>This project builds upon and incorporates code from several open-source libraries
-that have made significant contributions to handling large numbers and custom
-parsing in JSON. We would like to acknowledge and thank the authors of the
-following projects:</p>
-<ul>
-<li><a href="https://github.com/sidorares/json-bigint">json-bigint</a>: Provides support for parsing and stringifying JSON with BigInt,
-allowing for precise handling of large numbers.</li>
-<li><a href="https://github.com/josdejong/lossless-json">lossless-json</a>: A library that offers lossless handling of numbers in JSON,
-ensuring full precision when dealing with floating-point values.</li>
-<li><a href="https://github.com/jawj/json-custom-numbers">json-custom-numbers</a>: Allows for custom handling of numbers in JSON parsing
-and stringifying, offering flexibility in numerical representation.</li>
-</ul>
-<p>We are grateful for the work of these contributors, which has been instrumental
-in shaping the functionality of this library.</p></article>
-    </section>
-</div>
-<br class="clear">
-<footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.4</a>
-     on Wed Apr 16 2025 18:02:33 GMT+0800 (China Standard Time)
-    using the <a href="https://github.com/Haixing-Hu/jsdoc-minami">customized Minami theme</a>.
-</footer>
-<script>prettyPrint();</script>
-<script src="scripts/linenumber.js"></script>
-</body>
-</html>
+</code></pre></li><li><p>安装依赖：</p><pre class="prettyprint source lang-sh"><code>yarn install
+</code></pre></li><li><p>运行测试：</p><pre class="prettyprint source lang-sh"><code>yarn test
+</code></pre></li><li><p>构建库：</p><pre class="prettyprint source lang-sh"><code>yarn build
+</code></pre></li></ol><h3>发布流程</h3><ol><li>更新 package.json 中的版本号</li><li>运行测试和 lint 检查：<pre class="prettyprint source lang-sh"><code>yarn lint && yarn test
+</code></pre></li><li>构建库：<pre class="prettyprint source lang-sh"><code>yarn build:all
+</code></pre></li><li>发布到 npm：<pre class="prettyprint source lang-sh"><code>yarn deploy
+</code></pre></li></ol><h2><span id="license">许可证</span></h2><p><a href="https://npmjs.com/package/@qubit-ltd/json">@qubit-ltd/json</a> 根据 Apache 2.0 许可证分发。详情请参阅 <a href="LICENSE">LICENSE</a> 文件。</p><h2><span id="acknowledgements">致谢</span></h2><p>该项目基于并集成了多个开源库的代码，这些库在处理大数字和自定义 JSON 解析方面做出了重要贡献。我们想特别感谢以下项目的作者：</p><ul><li><a href="https://github.com/sidorares/json-bigint">json-bigint</a>：提供对使用 BigInt 解析和字符串化 JSON 的支持，使得可以精确处理大数字。</li><li><a href="https://github.com/josdejong/lossless-json">lossless-json</a>：一个确保在处理浮点数时保持完全精度的库，提供无损的 JSON 数字处理。</li><li><a href="https://github.com/jawj/json-custom-numbers">json-custom-numbers</a>：允许在 JSON 解析和字符串化过程中自定义数字处理，提供灵活的数值表示。</li></ul><p>我们对这些贡献者的工作表示感谢，这些工作对本库功能的实现起到了至关重要的作用。</p></article></section></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><div class="mobile-nav-links"></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="LosslessNumber.html">LosslessNumber</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#getUnsafeReason">getUnsafeReason</a></div><div class="sidebar-section-children"><a href="global.html#isBigInt">isBigInt</a></div><div class="sidebar-section-children"><a href="global.html#isInteger">isInteger</a></div><div class="sidebar-section-children"><a href="global.html#isNumber">isNumber</a></div><div class="sidebar-section-children"><a href="global.html#isSafeNumber">isSafeNumber</a></div><div class="sidebar-section-children"><a href="global.html#json">json</a></div><div class="sidebar-section-children"><a href="global.html#toSafeNumberOrThrow">toSafeNumberOrThrow</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>