From 95aca4b4d8fa62815d4bd412fff1a364f842814a Mon Sep 17 00:00:00 2001 From: Ryan Johnson Date: Thu, 29 Apr 2021 16:16:42 -0700 Subject: remove retired locales (#699) --- .../reference/global_objects/json/index.html | 158 ---------- .../reference/global_objects/json/parse/index.html | 133 --------- .../global_objects/json/stringify/index.html | 321 --------------------- 3 files changed, 612 deletions(-) delete mode 100644 files/uk/web/javascript/reference/global_objects/json/index.html delete mode 100644 files/uk/web/javascript/reference/global_objects/json/parse/index.html delete mode 100644 files/uk/web/javascript/reference/global_objects/json/stringify/index.html (limited to 'files/uk/web/javascript/reference/global_objects/json') diff --git a/files/uk/web/javascript/reference/global_objects/json/index.html b/files/uk/web/javascript/reference/global_objects/json/index.html deleted file mode 100644 index af5818da2a..0000000000 --- a/files/uk/web/javascript/reference/global_objects/json/index.html +++ /dev/null @@ -1,158 +0,0 @@ ---- -title: JSON -slug: Web/JavaScript/Reference/Global_Objects/JSON -tags: - - JSON - - JavaScript - - Довідка - - Об'єкт -translation_of: Web/JavaScript/Reference/Global_Objects/JSON ---- -
{{JSRef}}
- -

Об'єкт JSON містить методи для розбору JavaScript Object Notation ({{glossary("JSON")}}) і конвертації значень у JSON. Його можна або просто викликати, або конструювати; і окрім своїх двох методів він не має у собі іншої корисної функціональності.

- -

Опис

- -

Об'єктна нотація JavaScript

- -

JSON - це синтаксис для серіалізації об'єктів, масивів, чисел, строк, булевих значень, та {{jsxref("null")}}. Він заснований на синтаксисі JavaScript, проте дещо відрізняється від нього: деякий JavaScript не є JSON, і деякий JSON не є JavaScript. Докладніше у JSON: The JavaScript subset that isn't.

- - - - - - - - - - - - - - - - - - - - - - - -
Відмінності JavaScript і JSON
Тип у JavaScriptВідмінність у JSON
Об'єкти та масивиНазви полів повинні являти собою строки у подвійних лапках; прикінцеві коми заборонені.
ЧислаВедучі нулі також заборонені (При виконанні JSON.stringify нулі просто проігноруються, проте JSON.parse викине SyntaxError); після десяткової крапки повинна слідувати хоча б одна цифра.
Строки -

Лише обмежений набір символів можна екранувати; деякі керівні символи заборонені; такі символи юнікоду, як розділювач рядків (U+2028) та розділювач абзаців (U+2029) дозволені; строки повинні виділятись подвійними лапками. Зверніть увагу на наступні приклади, де {{jsxref("JSON.parse()")}} нормально працює, проте при обчисленні виразу як JavaScript-коду буде отримана помилка {{jsxref("SyntaxError")}}:

- - 
-var code = '"\u2028\u2029"';
-JSON.parse(code); // працює
-eval(code); // помилка
-
-
- -

Повний синтаксис JSON виглядає так:

- -
JSON = null
-    або true або false
-    або JSONNumber
-    або JSONString
-    або JSONObject
-    або JSONArray
-
-JSONNumber = - PositiveNumber
-          чи PositiveNumber
-PositiveNumber = DecimalNumber
-              або DecimalNumber . Digits
-              або DecimalNumber . Digits ExponentPart
-              або DecimalNumber ExponentPart
-DecimalNumber = 0
-             або OneToNine Digits
-ExponentPart = e Exponent
-            чи E Exponent
-Exponent = Digits
-        або + Digits
-        або - Digits
-Digits = Digit
-      чи Digits Digit
-Digit = від 0 до 9
-OneToNine = від 1 до 9
-
-JSONString = ""
-          чи " StringCharacters "
-StringCharacters = StringCharacter
-                чи StringCharacters StringCharacter
-StringCharacter = будь-який символ
-                  за виключенням " або \ або від U+0000 до U+001F
-               або EscapeSequence
-EscapeSequence = \" або \/ або \\ або \b або \f або \n або \r або \t
-              або \u HexDigit HexDigit HexDigit HexDigit
-HexDigit = від 0 до 9
-        або від A до F
-        або від a до f
-
-JSONObject = { }
-          чи { Members }
-Members = JSONString : JSON
-       чи Members , JSONString : JSON
-
-JSONArray = [ ]
-         чи [ ArrayElements ]
-ArrayElements = JSON
-             чи ArrayElements , JSON
-
- -

Беззмістовні пробільні символи можуть бути будь-де за винятком JSONNumber (числа не повинні містити пробіли) або JSONString (де це сприймається за частину строки, або призведе до помилки). Символ табуляції (U+0009), повернення каретки (U+000D), початку рядка (U+000A) та пробіл (U+0020) - це всі дійсні пробільні символи.

- -

Методи

- -
-
{{jsxref("JSON.parse()")}}
-
Розбирає строку як JSON, як опція — перетворює результат і його властивості, та повертає його.
-
{{jsxref("JSON.stringify()")}}
-
Повертає строку JSON відповідно до поданого значення. Як опція — може включити до результату лише певні поля чи замінити значення полів згідно з побажаннями користувача.
-
- -

Специфікації

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецифікаціяСтатусПримітка
{{SpecName('ES5.1', '#sec-15.12', 'JSON')}}{{Spec2('ES5.1')}}Первинне визначення.
{{SpecName('ES6', '#sec-json-object', 'JSON')}}{{Spec2('ES6')}} 
{{SpecName('ESDraft', '#sec-json-object', 'JSON')}}{{Spec2('ESDraft')}} 
- -

Підтримка у браузерах

- -
-
-
- - -

{{Compat("javascript.builtins.JSON")}}

-
-
-
- -

Дивіться також

- - diff --git a/files/uk/web/javascript/reference/global_objects/json/parse/index.html b/files/uk/web/javascript/reference/global_objects/json/parse/index.html deleted file mode 100644 index 685832a864..0000000000 --- a/files/uk/web/javascript/reference/global_objects/json/parse/index.html +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: JSON.parse() -slug: Web/JavaScript/Reference/Global_Objects/JSON/parse -tags: - - ECMAScript5 - - JSON - - JavaScript - - Method - - Довідка -translation_of: Web/JavaScript/Reference/Global_Objects/JSON/parse ---- -
{{JSRef}}
- -
Метод JSON.parse() розбирає рядок із JSON, створюючи відповідне до його вмісту значення чи об'єкт. Якщо вказати функцію reviver — другий необов'язковий параметр — її буде використано для перетворення створеного об'єкта та його властивостей перед поверненням. - -
 
- -
{{EmbedInteractiveExample("pages/js/json-parse.html")}}
- - -
- -

Синтаксис

- -
JSON.parse(text[, reviver])
- -

Параметри

- -
-
text
-
Рядок, що його має бути розібрано, як JSON. Докладні відомості про синтаксис JSON наведено в статті про об'єкт {{jsxref("JSON")}}.
-
reviver {{optional_inline}}
-
Якщо вказано функцію, її буде використано для перетворення отриманих значень перед поверненням.
-
- -

Вертає

- -

{{jsxref("Object", "Об'єкт")}}, що відповідає переданому JSON-рядку.

- -

Винятки

- -

Викидає виняток {{jsxref("Global_Objects/SyntaxError", "SyntaxError")}}, якщо вміст переданого рядка не є належним JSON.

- -

Приклади

- -

Використання JSON.parse()

- -
JSON.parse('{}');                   // {}
-JSON.parse('{"x": {"value": 1}}');  // {x: {value: 1}}
-JSON.parse('true');                 // true
-JSON.parse('"щось навіщось"');      // "щось навіщось"
-JSON.parse('[1, 5, "false"]');      // [1, 5, "false"]
-JSON.parse('null');                 // null
-
- -

Використання параметра reviver

- -

Якщо reviver вказано, то його буде використано для перетворення кожного значення, отриманого шляхом розбору JSON-рядка. Кожне значення (об'єкт та всі його властивості) окремо піддається перетворенню за допомогою reviver в порядку зсередини назовні (від властивостей найглибше вкладених об'єктів). Задля перетворення чергової властивості до функції reviver передається два аргументи: ім'я властивості (рядок) та її значення. Посилання this вказує на об'єкт, що містить зазначену властивість.

- -

Якщо функція reviver повертає {{jsxref("undefined")}} (або взагалі не вертає значення), властивість буде видалено з об'єкта. Інакше повернуте значення буде встановлено замість попереднього. Отже, якщо ви маєте на меті перетворити лише деякі значення, для решти функція reviver має вертати значення другого аргументу без змін.

- -
JSON.parse('{"p": 5, "x": "5"}', function (key, value) {
-  return typeof value === 'number'
-    ? value * 2 // Повернути подвоєне значення, якщо це число.
-    : value     // Решту значень повернути без змін.
-});
-
-// { p: 10, x: "5" }
-
-JSON.parse('{"1": 1, "2": 2, "3": {"4": 4, "5": {"6": 6}}}', function (key, value) {
-  // Вивести ім'я чергової властивості (для останньої це порожній рядок — "").
-  console.log(key);
-
-  // Повернути значення властивості без змін.
-  return value;
-});
-
-// 1
-// 2
-// 4
-// 6
-// 5
-// 3
-// ""
-
- -

Прикінцеві коми вважаються за помилку

- -
// Обидва виклики викидають SyntaxError.
-JSON.parse('[1, 2, 3, 4, ]');
-JSON.parse('{"foo" : 1, }');
-
- -

Специфікації

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецифікаціяСтатусКоментар
{{SpecName('ES5.1', '#sec-15.12.2', 'JSON.parse')}}{{Spec2('ES5.1')}}Початкова виознака. Запроваджено у JavaScript 1.7.
{{SpecName('ES6', '#sec-json.parse', 'JSON.parse')}}{{Spec2('ES6')}} 
{{SpecName('ESDraft', '#sec-json.parse', 'JSON.parse')}}{{Spec2('ESDraft')}} 
- -

Підтримка веб-переглядачами

- -
- - -

{{Compat("javascript.builtins.JSON.parse")}}

-
- -

Див. також

- - diff --git a/files/uk/web/javascript/reference/global_objects/json/stringify/index.html b/files/uk/web/javascript/reference/global_objects/json/stringify/index.html deleted file mode 100644 index ca0fdc87fc..0000000000 --- a/files/uk/web/javascript/reference/global_objects/json/stringify/index.html +++ /dev/null @@ -1,321 +0,0 @@ ---- -title: JSON.stringify() -slug: Web/JavaScript/Reference/Global_Objects/JSON/stringify -tags: - - JSON - - JavaScript - - stringify - - Довідка - - метод -translation_of: Web/JavaScript/Reference/Global_Objects/JSON/stringify ---- -
{{JSRef}}
- -

Метод JSON.stringify() подає об'єкт чи {{glossary("Primitive", "просту величину")}} як JSON-рядок, певним чином перетворюючи або оминаючи ті чи ті властивості, якщо вказано необов'язковий другий аргумент — функцію або масив replacer.

- -
{{EmbedInteractiveExample("pages/js/json-stringify.html")}}
- - - -

Синтаксис

- -
JSON.stringify(value[, replacer[, space]])
- -

Параметри

- -
-
value
-
Значення, яке слід перетворити на рядок JSON.
-
replacer {{optional_inline}}
-
Функція, що змінює значення перед їхнім перетворенням на JSON, або масив {{jsxref("Global_Objects/String", "рядків")}} та {{jsxref("Global_Objects/Number", "чисел")}}, що окреслюють множину властивостей, які буде включено у створений JSON-рядок. Якщо цей аргумент відсутній чи вказано null, до створеного JSON-рядка потраплять всі наявні властивості об'єкта без змін.
-
space {{optional_inline}}
-
Значення типу {{jsxref("Global_Objects/String", "String")}} або {{jsxref("Число", "Number")}} що використовується для додавання відступів у JSON задля покращення легкочитності. Якщо вказано число — воно означає кількість пропусків в одному відступі. Якщо передати число більше за 10, буде використано 10. Значення менші за 1 вказують на те що відступи не використовуватимуться. Якщо вказано рядок, то його (або перші 10 символів, якщо він задовгий) буде використано як відступ. Якщо ж параметр не вказано (або null), відступи не додаватимуться.
-
- -

Вертає

- -

Рядок JSON, створений із вказаного значення.

- -

Винятки

- -

Викидає виняток {{jsxref("TypeError")}} ("cyclic object value") у випадку, якщо знайдено циклічне посилання.

- -

Опис

- -

Функція JSON.stringify() перетворює значення на рядок, що містить JSON-запис того значення:

- - - -
JSON.stringify({});                   // '{}'
-JSON.stringify(true);                 // 'true'
-JSON.stringify('foo');                // '"foo"'
-JSON.stringify([1, 'false', false]);  // '[1,"false",false]'
-JSON.stringify([NaN, null, Infinity]); // '[null,null,null]'
-JSON.stringify({ x: 5 });             // '{"x":5}'
-
-JSON.stringify(new Date(2006, 0, 2, 15, 4, 5))
-// '"2006-01-02T15:04:05.000Z"'
-
-JSON.stringify({ x: 5, y: 6 });
-// '{"x":5,"y":6}' or '{"y":6,"x":5}'
-JSON.stringify([new Number(1), new String('false'), new Boolean(false)]);
-// '[1,"false",false]'
-
-JSON.stringify({ x: [10, undefined, function(){}, Symbol('')] });
-// '{"x":[10,null,null,null]}'
-
-// Стандартні структури даних
-JSON.stringify([new Set([1]), new Map([[1, 2]]), new WeakSet([{a: 1}]), new WeakMap([[{a: 1}, 2]])]);
-// '[{},{},{},{}]'
-
-// TypedArray
-JSON.stringify([new Int8Array([1]), new Int16Array([1]), new Int32Array([1])]);
-// '[{"0":1},{"0":1},{"0":1}]'
-JSON.stringify([new Uint8Array([1]), new Uint8ClampedArray([1]), new Uint16Array([1]), new Uint32Array([1])]);
-// '[{"0":1},{"0":1},{"0":1},{"0":1}]'
-JSON.stringify([new Float32Array([1]), new Float64Array([1])]);
-// '[{"0":1},{"0":1}]'
-
-// toJSON()
-JSON.stringify({ x: 5, y: 6, toJSON(){ return this.x + this.y; } });
-// '11'
-
-// Значення типу Symbol:
-JSON.stringify({ x: undefined, y: Object, z: Symbol('') });
-// '{}'
-JSON.stringify({ [Symbol('foo')]: 'foo' });
-// '{}'
-JSON.stringify({ [Symbol.for('foo')]: 'foo' }, [Symbol.for('foo')]);
-// '{}'
-JSON.stringify({ [Symbol.for('foo')]: 'foo' }, function(k, v) {
-  if (typeof k === 'symbol') {
-    return 'a symbol';
-  }
-});
-// '{}'
-
-// Неперелічувані властивості:
-JSON.stringify( Object.create(null, { x: { value: 'x', enumerable: false }, y: { value: 'y', enumerable: true } }) );
-// '{"y":"y"}'
-
-
- -

Параметер replacer

- -

Параметр replacer може бути функцією або масивом. Якщо то функція, вона прийматиме два параметри: ключ та значення, яке са́ме перетворюється. Об'єкт, якому належить перетворювана властивість, доступний всередині replacer через this. Спершу функцію буде викликано з порожнім рядком замість ключа й тим об'єктом, який має бути перетворено, а відтак для кожної властивості того об'єкта буде здійснено окремий виклик replacer. Кожен виклик має вертати значення, що належить додати до рядка JSON:

- - - -
Заувага: Вилучати елементи масиву за допомогою replacer неможливо — якщо повернути undefined, значення елемента лише обернеться на null.
- -
Note: If you wish the replacer to distinguish an initial object from a key with an empty string property (since both would give the empty string as key and potentially an object as value), you will have to keep track of the iteration count (if it is beyond the first iteration, it is a genuine empty string key).
- -

Приклад із функцією

- -
function replacer(key, value) {
-  // Фільтрація властивостей
-  if (typeof value === 'string') {
-    return undefined;
-  }
-  return value;
-}
-
-var foo = {foundation: 'Mozilla', model: 'box', week: 45, transport: 'car', month: 7};
-JSON.stringify(foo, replacer);
-// '{"week":45,"month":7}'
- -

Приклад із масивом

- -

Якщо replacer являється масивом, його значення позначають імена властивостей вхідного об'єкту, що будуть включені в результат.

- -

 

- -
JSON.stringify(foo, ['week', 'month']);
-// '{"week":45,"month":7}', будуть збережені лише властивості "week" та "month"
- -

Параметер space

- -

Аргумент space може застосовуватись для управління відступами в результуючому рядку. Якщо в якості аргументу дано число, кожен із наступних рівнів серіалізації матиме відступ у вигляді відповідної поданому числу кількості пробілів (але не більше 10). Якщо ж в якості аргументу дано рядок, його і буде використано для виконання відступу (або ж 10 перших символів, якщо сам рядок довший).

- -
JSON.stringify({ a: 1, b: {c: 2} }, null, 3);
-// Вертає рядок:
-// '{
-//    "a": 1,
-//    "b": {
-//       "c": 2
-//    }
-// }'
-
- -

А тут замість пропусків буде вжито символ табуляції:

- -
JSON.stringify({ a: 1, b: {c: 2} }, null, '\t');
-// Вертає рядок:
-// '{
-//     "a": 1,
-//     "b": {
-//         "c": 2
-//     }
-// }'
-
- -

Особливий метод toJSON()

- -

Й хоча методи перетворюваних об'єктів загалом нехтуються, метод з ім'ям toJSON має особливе призначення. Якщо перетворюваний об'єкт має метод toJSON(), його буде викликано, а повернене значення вжито (перетворено на JSON) замість самого об'єкту. JSON.stringify() викликає метод toJSON з одним аргументом:

- -

 

- - - -

Наприклад:

- -

 

- -
var obj = {
-    data: 'data',
-
-    toJSON(key){
-        if(key)
-            return `Тепер я вкладений об'єкт під ключем '${key}'`;
-
-        else
-            return this;
-    }
-};
-
-JSON.stringify(obj);
-// '{"data":"data"}'
-
-JSON.stringify({ obj })
-// '{"obj":"Тепер я вкладений об'єкт під ключем 'obj'"}'
-
-JSON.stringify([ obj ])
-// '["Тепер я вкладений об'єкт під ключем '0'"]'
- -

Проблема із JSON.stringify() при серіалізації циклічних посилань

- -

Зауважте, що, оскільки JSON format не підтримує об'єктні посилання (хоча є чорновик IETF), при спробі кодування об'єкту із циклічними посиланнями буде отримано {{jsxref("TypeError")}}.

- -
const circularReference = {};
-circularReference.myself = circularReference;
-
-// Серіалізація циклічного посилання викине "TypeError: cyclic object value"
-JSON.stringify(circularReference);
- -

Для виконання серіалізації циклічних посилань ви можете використати бібліотеку, що їх підтримує (зокрема cycle.js від Douglas Crockford), або ж реалізувати рішення самостійно, для чого знадобиться пошук і заміна (або видалення) циклічних посилань на підходящі для серіалізації значення.

- -

Тлумачення отриманого JSON як коду JavaScript

- -

Завважте, що JSON не є точнісінькою підмножиною JavaScript. Два розділювачі (рядка та параграфу) не треба екранувати у JSON, але потрібно у JavaScript. Тож якщо ви маєте намір застосувати функцію eval() або скористатися JSONP, доведеться здійснити невеличкі перетворення:

- -

 

- -
function jsFriendlyJSONStringify (s) {
-    return JSON.stringify(s).
-        replace(/\u2028/g, '\\u2028').
-        replace(/\u2029/g, '\\u2029');
-}
-
-var s = {
-    a: String.fromCharCode(0x2028),
-    b: String.fromCharCode(0x2029)
-};
-try {
-    eval('(' + JSON.stringify(s) + ')');
-} catch (e) {
-    console.log(e); // "SyntaxError: unterminated string literal"
-}
-
-// Якщо ловити виключення не має потреби
-eval('(' + jsFriendlyJSONStringify(s) + ')');
-
-// console.log у Firefox знімає екранування Юнікоду, якщо
-// виводиться в консоль, тому застосуймо alert
-alert(jsFriendlyJSONStringify(s)); // {"a":"\u2028","b":"\u2029"}
- -

Приклад застосування JSON.stringify() із localStorage

- -

У випадку, якщо ви хочете зберегти об'єкт, створений вашим користувачем і дозволити відновити його навіть після закриття браузера, ось наступний приклад із моделлю застосування JSON.stringify():

- -
// Створення зразка JSON
-var session = {
-  'screens': [],
-  'state': true
-};
-session.screens.push({ 'name': 'screenA', 'width': 450, 'height': 250 });
-session.screens.push({ 'name': 'screenB', 'width': 650, 'height': 350 });
-session.screens.push({ 'name': 'screenC', 'width': 750, 'height': 120 });
-session.screens.push({ 'name': 'screenD', 'width': 250, 'height': 60 });
-session.screens.push({ 'name': 'screenE', 'width': 390, 'height': 120 });
-session.screens.push({ 'name': 'screenF', 'width': 1240, 'height': 650 });
-
-// Конвертація рядка JSON через JSON.stringify()
-// далі збереження у localStorage із іменем "session"
-localStorage.setItem('session', JSON.stringify(session));
-
-// Приклад, як перетворити рядок, отриманий за допомогою  
-// JSON.stringify() і збережений у localStorage назад у JSON-об'єкт
-var restoredSession = JSON.parse(localStorage.getItem('session'));
-
-// Тепер змінна restoredSession містить об'єкт, що був раніше збережений
-// у localStorage
-console.log(restoredSession);
- -

Специфікації

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецифікаціяСтатусКоментар
{{SpecName('ES5.1', '#sec-15.12.3', 'JSON.stringify')}}{{Spec2('ES5.1')}}Первинне визначення. Запроваджено у JavaScript 1.7.
{{SpecName('ES6', '#sec-json.stringify', 'JSON.stringify')}}{{Spec2('ES6')}} 
{{SpecName('ESDraft', '#sec-json.stringify', 'JSON.stringify')}}{{Spec2('ESDraft')}} 
- -

Підтримка веб-переглядачами

- - - -
{{Compat("javascript.builtins.JSON.stringify")}}
- -

Див. також

- - -- cgit v1.2.3-54-g00ecf