База знанияИзпитен център
BGБългарски
Избери език13

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

Източници