CKTIS / JavaScript
JSON.parse: от JSON текст към JavaScript стойност
JSON.parse прочита текст по строгата JSON граматика и връща JavaScript стойността му; незадължителен reviver може да преобразува резултата от листата към корена.
Версия: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2
Синтаксис
JSON.parse(text[, reviver])JSON.parse(text, reviver?) първо преобразува text в низ, после разпознава точно една JSON стойност: обект, масив, низ, число, true, false или null. JSON изисква двойни кавички и не допуска коментари, крайни запетаи, undefined, NaN или Infinity. Ключ "__proto__" става обикновено собствено свойство за данни; разборът не променя прототипа.
Ако reviver е функция, средата посещава свойствата от децата към родителя; this е държателят на текущото свойство, а коренът използва празен ключ "". Връщане на undefined изтрива свойството, а друг резултат го заменя. От ECMAScript 2026 context е трети аргумент на reviver; за непроменена примитивна стойност context.source съдържа точния отрязък от входа, което позволява голямо цяло число да се възстанови като BigInt въпреки предишното закръгляне до Number.
Невалиден синтаксис хвърля SyntaxError; изключение от reviver се разпространява. JSON.parse не изпълнява текста като код, но данните от ненадежден източник все пак трябва да се проверят спрямо очакваната схема преди употреба. Методът е стандартен от ECMAScript 5, а context.source от ECMAScript 2026.
Примери
const value = JSON.parse(
'{"created":"2024-01-02T03:04:05.006Z","count":9007199254740993}',
function (key, current, context) {
if (key === "created") return new Date(current);
if (key === "count") return BigInt(context.source);
return current;
},
);
console.log(value.created instanceof Date, value.created.toISOString());
console.log(String(value.count));
const order = [];
JSON.parse('{"a":{"b":1}}', (key, current) => {
order.push(key || "<root>");
return current;
});
console.log(order.join(","));
try {
JSON.parse('{"trailing":true,}');
} catch (error) {
console.log(error instanceof SyntaxError);
}Резултат
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true