move JSON.parse source text access to stable ES

Author: zloirock

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 ### Unreleased
+- [`JSON.parse` source text access proposal](https://github.com/tc39/proposal-json-parse-with-source) :
+  - Built-ins:
+    - `JSON.isRawJSON`
+    - `JSON.parse`
+    - `JSON.rawJSON`
+    - `JSON.stringify`
+  - Moved to stable ES, November 2025 TC39 meeting
+  - Added `es.` namespace modules, `/es/` and `/stable/` namespaces entries
+  - Reworked `JSON.stringify` internals
 - Fixed increasing `.size` in `URLSearchParams.prototype.append` polyfill in IE8-
 - Compat data improvements:
   - [`Map` upsert proposal](https://github.com/tc39/proposal-upsert) features marked as shipped in Safari 26.2

README.md

@@ -163,14 +163,14 @@ structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
       - [`Promise.withResolvers`](#promisewithresolvers)
       - [`Symbol.asyncIterator` for asynchronous iteration](#symbolasynciterator-for-asynchronous-iteration)
       - [`Symbol.prototype.description`](#symbolprototypedescription)
+      - [`JSON.parse` source text access](#jsonparse-source-text-access)
       - [Well-formed `JSON.stringify`](#well-formed-jsonstringify)
       - [Well-formed unicode strings](#well-formed-unicode-strings)
       - [New `Set` methods](#new-set-methods)
       - [`Math.sumPrecise`](#mathsumprecise)
     - [Stage 3 proposals](#stage-3-proposals)
       - [`Iterator` sequencing](#iterator-sequencing)
       - [`Map` upsert](#map-upsert)
-      - [`JSON.parse` source text access](#jsonparse-source-text-access)
       - [`Symbol.metadata` for decorators metadata proposal](#symbolmetadata-for-decorators-metadata-proposal)
     - [Stage 2.7 proposals](#stage-27-proposals)
       - [`Iterator` chunking](#iterator-chunking)
@@ -2132,23 +2132,47 @@ instance.c; // => 42
 ```
 
 #### ECMAScript: JSON[⬆](#index)
-Since `JSON` object is missed only in very old engines like IE7-, `core-js` does not provide a full `JSON` polyfill, however, fix already existing implementations by the current standard, for example, [well-formed `JSON.stringify`](https://github.com/tc39/proposal-well-formed-stringify). `JSON` is also fixed in other modules - for example, `Symbol` polyfill fixes `JSON.stringify` for correct work with symbols.
+Since `JSON` object is missed only in very old engines like IE7-, `core-js` does not provide a full `JSON.{ parse, stringify }` polyfill, however, fix already existing implementations by the current standard.
 
-Module [`es.json.to-string-tag`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.to-string-tag.js) and [`es.json.stringify`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.stringify.js).
+Modules [`es.json.is-raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.is-raw-json.js), [`es.json.parse`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.parse.js), [`es.json.raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.raw-json.js), [`es.json.stringify`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.stringify.js) and [`es.json.to-string-tag`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.to-string-tag.js) .
 ```ts
 namespace JSON {
+  isRawJSON(O: any): boolean;
+  parse(text: string, reviver?: (this: any, key: string, value: any, context: { source?: string }) => any): any;
+  rawJSON(text: any): RawJSON;
   stringify(value: any, replacer?: Array<string | number> | (this: any, key: string, value: any) => any, space?: string | number): string | void;
   @@toStringTag: 'JSON';
 }
 ```
 [*CommonJS entry points:*](#commonjs-api)
 ```
+core-js(-pure)/es|stable|actual|full/json/is-raw-json
+core-js(-pure)/es|stable|actual|full/json/parse
+core-js(-pure)/es|stable|actual|full/json/raw-json
+core-js(-pure)/es|stable|actual|full/json/stringify
 core-js(-pure)/es|stable|actual|full/json/stringify
 core-js(-pure)/es|stable|actual|full/json/to-string-tag
 ```
-[*Examples*](https://is.gd/izZqKn):
+[*Examples*](https://tinyurl.com/34ctm7cn):
 ```js
 JSON.stringify({ '𠮷': ['\uDF06\uD834'] }); // => '{"𠮷":["\\udf06\\ud834"]}'
+
+function digitsToBigInt(key, val, { source }) {
+  return /^\d+$/.test(source) ? BigInt(source) : val;
+}
+
+function bigIntToRawJSON(key, val) {
+  return typeof val === 'bigint' ? JSON.rawJSON(String(val)) : val;
+}
+
+const tooBigForNumber = BigInt(Number.MAX_SAFE_INTEGER) + 2n;
+JSON.parse(String(tooBigForNumber), digitsToBigInt) === tooBigForNumber; // true
+
+const wayTooBig = BigInt(`1${ '0'.repeat(1000) }`);
+JSON.parse(String(wayTooBig), digitsToBigInt) === wayTooBig; // true
+
+const embedded = JSON.stringify({ tooBigForNumber }, bigIntToRawJSON);
+embedded === '{"tooBigForNumber":9007199254740993}'; // true
 ```
 
 #### ECMAScript: globalThis[⬆](#index)
@@ -2631,6 +2655,23 @@ class Symbol {
 ```
 core-js/proposals/symbol-description
 ```
+
+##### [`JSON.parse` source text access](https://github.com/tc39/proposal-json-parse-with-source)[⬆](#index)
+```ts
+namespace JSON {
+  isRawJSON(O: any): boolean;
+  // patched for source support
+  parse(text: string, reviver?: (this: any, key: string, value: any, context: { source?: string }) => any): any;
+  rawJSON(text: any): RawJSON;
+  // patched for `JSON.rawJSON` support
+  stringify(value: any, replacer?: Array<string | number> | (this: any, key: string, value: any) => any, space?: string | number): string | void;
+}
+```
+[*CommonJS entry points:*](#commonjs-api)
+```
+core-js/proposals/json-parse-with-source
+```
+
 ##### [Well-formed `JSON.stringify`](https://github.com/tc39/proposal-well-formed-stringify)[⬆](#index)
 ```ts
 namespace JSON {
@@ -2743,46 +2784,6 @@ map.getOrInsertComputed('c', key => key); // => 'c'
 console.log(map); // => Map { 'a': 1, 'b': 3, 'c': 'c' }
 ```
 
-##### [`JSON.parse` source text access](https://github.com/tc39/proposal-json-parse-with-source)[⬆](#index)
-Modules [`esnext.json.is-raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.is-raw-json.js), [`esnext.json.parse`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.parse.js), [`esnext.json.raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.raw-json.js).
-```ts
-namespace JSON {
-  isRawJSON(O: any): boolean;
-  // patched for source support
-  parse(text: string, reviver?: (this: any, key: string, value: any, context: { source?: string }) => any): any;
-  rawJSON(text: any): RawJSON;
-  // patched for `JSON.rawJSON` support
-  stringify(value: any, replacer?: Array<string | number> | (this: any, key: string, value: any) => any, space?: string | number): string | void;
-}
-```
-[*CommonJS entry points:*](#commonjs-api)
-```
-core-js/proposals/json-parse-with-source
-core-js(-pure)/actual|full/json/is-raw-json
-core-js(-pure)/actual|full/json/parse
-core-js(-pure)/actual|full/json/raw-json
-core-js(-pure)/actual|full/json/stringify
-```
-[*Examples*](https://tinyurl.com/22phm569):
-```js
-function digitsToBigInt(key, val, { source }) {
-  return /^\d+$/.test(source) ? BigInt(source) : val;
-}
-
-function bigIntToRawJSON(key, val) {
-  return typeof val === 'bigint' ? JSON.rawJSON(String(val)) : val;
-}
-
-const tooBigForNumber = BigInt(Number.MAX_SAFE_INTEGER) + 2n;
-JSON.parse(String(tooBigForNumber), digitsToBigInt) === tooBigForNumber; // true
-
-const wayTooBig = BigInt(`1${ '0'.repeat(1000) }`);
-JSON.parse(String(wayTooBig), digitsToBigInt) === wayTooBig; // true
-
-const embedded = JSON.stringify({ tooBigForNumber }, bigIntToRawJSON);
-embedded === '{"tooBigForNumber":9007199254740993}'; // true
-```
-
 ##### [`Symbol.metadata` for decorators metadata proposal](https://github.com/tc39/proposal-decorator-metadata)[⬆](#index)
 Modules [`esnext.symbol.metadata`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.symbol.metadata.js) and [`esnext.function.metadata`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.function.metadata.js).
 ```ts

docs/web/docs/features/ecmascript/json.md

@@ -1,24 +1,45 @@
 # ECMAScript: JSON
-Since `JSON` object is missed only in very old engines like IE7-, `core-js` does not provide a full `JSON` polyfill, however, fix already existing implementations by the current standard, for example, [well-formed `JSON.stringify`](https://github.com/tc39/proposal-well-formed-stringify). `JSON` is also fixed in other modules - for example, `Symbol` polyfill fixes `JSON.stringify` for correct work with symbols.
+Since `JSON` object is missed only in very old engines like IE7-, `core-js` does not provide a full `JSON.{ parse, stringify }` polyfill, however, fix already existing implementations by the current standard.
 
 ## Modules
-[`es.json.to-string-tag`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.to-string-tag.js) and [`es.json.stringify`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.stringify.js).
+[`es.json.is-raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.is-raw-json.js), [`es.json.parse`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.parse.js), [`es.json.raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.raw-json.js), [`es.json.stringify`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.stringify.js) and [`es.json.to-string-tag`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.to-string-tag.js).
 
 ## Built-ins signatures
 ```ts
 namespace JSON {
+  isRawJSON(O: any): boolean;
+  parse(text: string, reviver?: (this: any, key: string, value: any, context: { source?: string }) => any): any;
+  rawJSON(text: any): RawJSON;
   stringify(value: any, replacer?: Array<string | number> | (this: any, key: string, value: any) => any, space?: string | number): string | void;
   @@toStringTag: 'JSON';
 }
 ```
 
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```
-core-js(-pure)/es|stable|actual|full/json/stringify
+core-js(-pure)/es|stable|actual|full/json/is-raw-json
+core-js(-pure)/es|stable|actual|full/json/parse
+core-js(-pure)/es|stable|actual|full/json/raw-json
 core-js(-pure)/es|stable|actual|full/json/to-string-tag
 ```
 
 ## Examples
 ```js
+function digitsToBigInt(key, val, { source }) {
+  return /^\d+$/.test(source) ? BigInt(source) : val;
+}
+
+function bigIntToRawJSON(key, val) {
+  return typeof val === 'bigint' ? JSON.rawJSON(String(val)) : val;
+}
+
+const tooBigForNumber = BigInt(Number.MAX_SAFE_INTEGER) + 2n;
+JSON.parse(String(tooBigForNumber), digitsToBigInt) === tooBigForNumber; // => true
+
+const wayTooBig = BigInt(`1${ '0'.repeat(1000) }`);
+JSON.parse(String(wayTooBig), digitsToBigInt) === wayTooBig; // => true
+
+JSON.stringify({ tooBigForNumber }, bigIntToRawJSON); // => '{"tooBigForNumber":9007199254740993}'
+
 JSON.stringify({ '𠮷': ['\uDF06\uD834'] }); // => '{"𠮷":["\\udf06\\ud834"]}'
 ```

docs/web/docs/features/proposals/json-parse-source-text-access.md

@@ -3,7 +3,7 @@
 [Proposal repo](https://github.com/tc39/proposal-json-parse-with-source)
 
 ## Modules
-[`esnext.json.is-raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.is-raw-json.js), [`esnext.json.parse`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.parse.js), [`esnext.json.raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.raw-json.js).
+[`es.json.is-raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.is-raw-json.js), [`es.json.parse`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.parse.js), [`es.json.raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.json.raw-json.js).
 
 ## Built-ins signatures
 ```ts
@@ -20,10 +20,10 @@ namespace JSON {
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js/proposals/json-parse-with-source
-core-js(-pure)/actual|full/json/is-raw-json
-core-js(-pure)/actual|full/json/parse
-core-js(-pure)/actual|full/json/raw-json
-core-js(-pure)/actual|full/json/stringify
+core-js(-pure)/es|stable|actual|full/json/is-raw-json
+core-js(-pure)/es|stable|actual|full/json/parse
+core-js(-pure)/es|stable|actual|full/json/raw-json
+core-js(-pure)/es|stable|actual|full/json/stringify
 ```
 
 ## Examples

docs/web/docs/menu.json

@@ -217,6 +217,10 @@
                 "title": "Symbol.prototype.description",
                 "url": "{docs-version}/docs/features/proposals/symbol-prototype-description"
               },
+              {
+                "title": "JSON.parse source text access",
+                "url": "{docs-version}/docs/features/proposals/json-parse-source-text-access"
+              },
               {
                 "title": "Well-formed JSON.stringify",
                 "url": "{docs-version}/docs/features/proposals/well-formed-jsonstringify"
@@ -246,10 +250,6 @@
                 "title": "Map upsert",
                 "url": "{docs-version}/docs/features/proposals/map-upsert"
               },
-              {
-                "title": "JSON.parse source text access",
-                "url": "{docs-version}/docs/features/proposals/json-parse-source-text-access"
-              },
               {
                 "title": "Symbol.metadata for decorators metadata proposal",
                 "url": "{docs-version}/docs/features/proposals/symbol-metadata"

packages/core-js-compat/src/data.mjs

@@ -803,13 +803,35 @@ export const data = {
     firefox: '131',
     safari: '18.4',
   },
+  'es.json.is-raw-json': {
+    bun: '1.1.43',
+    chrome: '114',
+    // enabled in 132 and disabled in 133 because of regression, https://bugzilla.mozilla.org/show_bug.cgi?id=1925334
+    firefox: '135', // '132',
+    safari: '18.4',
+  },
+  'es.json.parse': {
+    bun: '1.1.43',
+    chrome: '114',
+    // enabled in 132 and disabled in 133 because of regression, https://bugzilla.mozilla.org/show_bug.cgi?id=1925334
+    firefox: '135', // '132',
+    safari: '18.4',
+  },
+  'es.json.raw-json': {
+    bun: '1.1.43',
+    chrome: '114',
+    // enabled in 132 and disabled in 133 because of regression, https://bugzilla.mozilla.org/show_bug.cgi?id=1925334
+    firefox: '135', // '132',
+    safari: '18.4',
+  },
   'es.json.stringify': {
-    chrome: '72',
-    firefox: '64',
-    hermes: '0.13',
-    'react-native': '0.72',
-    rhino: '1.8.0',
-    safari: '12.1',
+    bun: '1.1.43',
+    chrome: '114', // '72',
+    firefox: '135', // '132', '64',
+    // hermes: '0.13',
+    // 'react-native': '0.72',
+    // rhino: '1.8.0',
+    safari: '18.4', // '12.1',
   },
   'es.json.to-string-tag': {
     chrome: '50',
@@ -2548,27 +2570,12 @@ export const data = {
   },
   'esnext.iterator.zip-keyed': {
   },
-  'esnext.json.is-raw-json': {
-    bun: '1.1.43',
-    chrome: '114',
-    // enabled in 132 and disabled in 133 because of regression, https://bugzilla.mozilla.org/show_bug.cgi?id=1925334
-    firefox: '135', // '132',
-    safari: '18.4',
-  },
-  'esnext.json.parse': {
-    bun: '1.1.43',
-    chrome: '114',
-    // enabled in 132 and disabled in 133 because of regression, https://bugzilla.mozilla.org/show_bug.cgi?id=1925334
-    firefox: '135', // '132',
-    safari: '18.4',
-  },
-  'esnext.json.raw-json': {
-    bun: '1.1.43',
-    chrome: '114',
-    // enabled in 132 and disabled in 133 because of regression, https://bugzilla.mozilla.org/show_bug.cgi?id=1925334
-    firefox: '135', // '132',
-    safari: '18.4',
-  },
+  // TODO: Remove from `core-js@4`
+  'esnext.json.is-raw-json': null,
+  // TODO: Remove from `core-js@4`
+  'esnext.json.parse': null,
+  // TODO: Remove from `core-js@4`
+  'esnext.json.raw-json': null,
   'esnext.map.delete-all': {
   },
   // TODO: Remove from `core-js@4`
@@ -3179,6 +3186,9 @@ export const renamed = new Map([
   ['esnext.iterator.some', 'es.iterator.some'],
   ['esnext.iterator.take', 'es.iterator.take'],
   ['esnext.iterator.to-array', 'es.iterator.to-array'],
+  ['esnext.json.is-raw-json', 'es.json.is-raw-json'],
+  ['esnext.json.parse', 'es.json.parse'],
+  ['esnext.json.raw-json', 'es.json.raw-json'],
   ['esnext.map.group-by', 'es.map.group-by'],
   ['esnext.math.f16round', 'es.math.f16round'],
   ['esnext.math.sum-precise', 'es.math.sum-precise'],

packages/core-js-compat/src/modules-by-versions.mjs

@@ -311,4 +311,9 @@ export default {
     'es.uint8-array.to-base64',
     'es.uint8-array.to-hex',
   ],
+  3.47: [
+    'es.json.is-raw-json',
+    'es.json.parse',
+    'es.json.raw-json',
+  ],
 };

packages/core-js/actual/json/index.js

@@ -1,8 +1,5 @@
 'use strict';
 var parent = require('../../stable/json');
-require('../../modules/es.object.create');
-require('../../modules/es.object.freeze');
-require('../../modules/es.object.keys');
 require('../../modules/esnext.json.is-raw-json');
 require('../../modules/esnext.json.parse');
 require('../../modules/esnext.json.raw-json');

packages/core-js/actual/json/is-raw-json.js

@@ -1,5 +1,5 @@
 'use strict';
+var parent = require('../../stable/json/is-raw-json');
 require('../../modules/esnext.json.is-raw-json');
-var path = require('../../internals/path');
 
-module.exports = path.JSON.isRawJSON;
+module.exports = parent;

packages/core-js/actual/json/parse.js

@@ -1,6 +1,5 @@
 'use strict';
-require('../../modules/es.object.keys');
+var parent = require('../../stable/json/parse');
 require('../../modules/esnext.json.parse');
-var path = require('../../internals/path');
 
-module.exports = path.JSON.parse;
+module.exports = parent;