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

CKTIS / JavaScript

JSON — парсване и сериализиране на данни

JSON е вграденият обект на JavaScript за четене и записване на JSON текст. JSON.parse създава стойности от текст, а JSON.stringify сериализира стойности, но не запазва всички типове и структури на обектите в JavaScript.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

JSON.parse(text[, reviver])
JSON.stringify(value[, replacer[, space]])

JSON е вграден обект на ECMAScript, а не конструктор или функция: не използвайте new JSON() или JSON(). Форматът JSON описва обекти, масиви, низове, числа, булеви стойности и null. Имената на свойствата и низовете трябва да са в двойни кавички; коментари и крайни запетаи не са разрешени.

JSON.parse(text, reviver) прочита текст; невалидният синтаксис води до SyntaxError. Незадължителният reviver преобразува стойностите от вложените елементи към корена; връщането на undefined изтрива свойството. Успешното парсване не проверява очакваната схема на данните, а големите цели числа може да загубят точност като стойности Number.

JSON.stringify(value, replacer, space) връща текст или undefined. replacer може да е функция, която преобразува стойности, или масив от имена, който избира свойствата на обектите; space управлява отстъпите. При обекти, които не са масиви, по подразбиране се сериализират собствените изброими свойства с низови ключове. При масивите се четат стойностите на индексите от 0 до length - 1, дори когато съответните свойства са наследени или неизброими. Допълнителните свойства, чиито имена не са индекси, се игнорират, дори да са изброими. Ако съществува метод toJSON, той може да промени представянето.

Свойствата със стойност undefined, функция или символ се пропускат в обектите, но съответните елементи на масивите стават null. NaN и безкрайностите също стават null. Циклите и непреобразуваните стойности BigInt водят до TypeError. Затова повторното сериализиране и парсване не е универсален начин за дълбоко копиране.

Този запис и примерът обхващат основните методи, а не всички по-нови разширения. Актуалният проект на спецификацията описва и JSON.rawJSON, и JSON.isRawJSON; преди употреба проверете дали са налични в целевата среда. Резултат в Node 24 не доказва поддръжка в браузърите.

Примери

const text = '{"name":"Ada","scores":[3,5]}';
const data = JSON.parse(text);
data.scores.push(8);
console.log(JSON.stringify(data));
console.log(JSON.stringify({ missing: undefined, items: [undefined] }));

Резултат

{"name":"Ada","scores":[3,5,8]}
{"items":[null]}

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници