Support `proposal-json-parse-with-source` (`JSON.rawJSON()`, `JSON.isRawJSON()`, `context` parameter of `reviver` function, etc...) · Microsoft/TypeScript#61330

(3 留言) (12 反應) (0 負責人)TypeScript (48,455 star) (6,726 fork)batch import

BugDomain: lib.d.tsHelp Wanted

描述

⚙ Compilation target

ESNext

⚙ Library

ESNext

Missing / Incorrect Definition

JSON.rawJSON() appears to be missing. Apologies if I've missed something or if this is the wrong place to raise an issue. I searched through both PRs and issues in both this repo and https://github.com/microsoft/TypeScript-DOM-lib-generator but couldn't find any references for it.

Sample Code

// https://www.typescriptlang.org/play/?target=99#code/MYewdgzgLgBAHjAvDAUgZQPIDkB0AnAQwHd1sAKAcgAYKBKIA
const x = JSON.rawJSON('0')

Documentation Link

Per https://github.com/microsoft/TypeScript/issues/19044 it seems like TypeScript's policy is to support Stage 3+ features and proposal-json-parse-with-source is stage 3. (If I misunderstood the typescript teams policy on experimental features it would be awesome to have this documented in https://github.com/Microsoft/TypeScript/wiki/FAQ)

MDN also documents this feature here.

Additionally, it appears to have been implemented in V8 and in webkit.

Testing experimentally, it is available in node 22+ and in the latest Chromium as well:

貢獻者指南

技術棧: typescriptjavascriptnodejs
領域: toolingdeveloper experienceapi
議題類型: feature
難度: 3
預計時間: 1-2 days
活動狀態: fresh
清晰度: clear
前置要求: Familiarity with TypeScript built in declarationsUnderstanding of JSON.rawJSON proposal
新手友善度: 80
研究方向: Investigate the current TypeScript lib files for JSON (e.g., lib.es5.d.ts, lib.esnext.d.ts) to understand the existing declarations. Review the proposal json parse with source specification and the implemented changes in V8 and WebKit. Determine where to add the new methods: likely in a new lib file for ESNext. Consider how to handle the context parameter in the reviver function. Consult the linked TypeScript issue #19044 for policy context.