From ba5d6f9610d6bb352eecfa3ded1bb99bc9892916 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Fri, 11 Dec 2020 19:00:14 -0500 Subject: dump 2020-12-11 --- .../global_objects/symbol/@@toprimitive/index.html | 64 ++++++++++++ .../reference/global_objects/symbol/for/index.html | 108 +++++++++++++++++++++ .../global_objects/symbol/keyfor/index.html | 75 ++++++++++++++ .../global_objects/symbol/tosource/index.html | 57 +++++++++++ .../global_objects/symbol/tostring/index.html | 76 +++++++++++++++ .../global_objects/symbol/valueof/index.html | 64 ++++++++++++ 6 files changed, 444 insertions(+) create mode 100644 files/uk/web/javascript/reference/global_objects/symbol/@@toprimitive/index.html create mode 100644 files/uk/web/javascript/reference/global_objects/symbol/for/index.html create mode 100644 files/uk/web/javascript/reference/global_objects/symbol/keyfor/index.html create mode 100644 files/uk/web/javascript/reference/global_objects/symbol/tosource/index.html create mode 100644 files/uk/web/javascript/reference/global_objects/symbol/tostring/index.html create mode 100644 files/uk/web/javascript/reference/global_objects/symbol/valueof/index.html (limited to 'files/uk/web') diff --git a/files/uk/web/javascript/reference/global_objects/symbol/@@toprimitive/index.html b/files/uk/web/javascript/reference/global_objects/symbol/@@toprimitive/index.html new file mode 100644 index 0000000000..d4819f362a --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/symbol/@@toprimitive/index.html @@ -0,0 +1,64 @@ +--- +title: 'Symbol.prototype[@@toPrimitive]' +slug: Web/JavaScript/Reference/Global_Objects/Symbol/@@toPrimitive +tags: + - ECMAScript 2015 + - JavaScript + - Symbol + - Символ + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/@@toPrimitive +--- +
{{JSRef}}
+ +

Метод [@@toPrimitive]() перетворює об'єкт Symbol на примітивне значення.

+ +

Синтаксис

+ +
Symbol()[Symbol.toPrimitive](hint)
+
+ +

Повертає

+ +

Примітивне значення вказаного об'єкта {{jsxref("Symbol")}}.

+ +

Опис

+ +

Метод [@@toPrimitive]() об'єкта {{jsxref("Symbol")}} повертає примітивне значення об'єкта Symbol у вигляді символьного типу даних. Аргумент hint не використовується.

+ +

JavaScript викликає метод [@@toPrimitive]() для перетворення об'єкта на примітивне значення. Вам рідко знадобиться запускати метод [@@toPrimitive]() власноруч; JavaScript автоматично запускає його, зустрівши об'єкт там, де очікується примітивне значення.

+ +

Приклади

+ +

Використання @@toPrimitive

+ +
const sym = Symbol("example");
+sym === sym[Symbol.toPrimitive](); // true
+
+ +

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

+ + + + + + + + + + + + +
Специфікація
{{SpecName('ESDraft', '#sec-symbol.prototype-@@toprimitive', 'Symbol.prototype.@@toPrimitive')}}
+ +

Сумісність з веб-переглядачами

+ + + +

{{Compat("javascript.builtins.Symbol.@@toPrimitive")}}

+ +

Див. також

+ + diff --git a/files/uk/web/javascript/reference/global_objects/symbol/for/index.html b/files/uk/web/javascript/reference/global_objects/symbol/for/index.html new file mode 100644 index 0000000000..e8680798a9 --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/symbol/for/index.html @@ -0,0 +1,108 @@ +--- +title: Symbol.for() +slug: Web/JavaScript/Reference/Global_Objects/Symbol/for +tags: + - ECMAScript 2015 + - JavaScript + - Symbol + - Символ + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/for +--- +
{{JSRef}}
+ +

Метод Symbol.for(key) шукає існуючі символи у загальному реєстрі символів за заданим ключем, та повертає, якщо знаходить. Інакше, у глобальному реєстрі символів створюється новий символ з цим ключем.

+ +
{{EmbedInteractiveExample("pages/js/symbol-for.html")}}
+ + + +

Синтаксис

+ +
Symbol.for(key);
+ +

Параметри

+ +
+
key
+
Рядок, обов'язковий. Ключ для символа (а також використовується для опису символа).
+
+ +

Повертає

+ +

Існуючий символ з наданим ключем, якщо його знайдено; інакше, створюється та повертається новий символ.

+ +

Опис

+ +

На відміну від Symbol(), функція Symbol.for() створює символ, доступний у списку глобального реєстру символів. Symbol.for() також не обов'язково створює новий символ при кожному виклику, а спочатку перевіряє, чи існує вже символ з наданим ключем key у реєстрі. В такому випадку повертається цей символ. Якщо символ з наданим ключем не знайдений, Symbol.for() створить новий глобальний символ.

+ +

Глобальний реєстр символів

+ +

Глобальний реєстр символів - це список з наступною структурою запису, який ініціалізується порожнім:

+ + + + + + + + + + + + + + + + + +
Запис у глобальному реєстрі символів
Ім'я поляЗначення
[[key]]Рядковий ключ для ідентифікації символа.
[[symbol]]Символ, що зберігається глобально.
+ +

Приклади

+ +

Використання Symbol.for()

+ +
Symbol.for('foo'); // створити новий глобальний символ
+Symbol.for('foo'); // отримати вже створений символ
+
+// Один і той самий глобальний символ, але не локально
+Symbol.for('bar') === Symbol.for('bar'); // true
+Symbol('bar') === Symbol('bar'); // false
+
+// Ключ також використовується в якості опису
+var sym = Symbol.for('mario');
+sym.toString(); // "Symbol(mario)"
+
+ +

Щоб уникнути конфліктів між іменами ваших ключів глобальних символів та іншими (код бібліотеки) глобальними символами, може бути гарною ідеєю додавати до ваших символів префікс:

+ +
Symbol.for('mdn.foo');
+Symbol.for('mdn.bar');
+
+ +

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

+ + + + + + + + + + + + +
Специфікація
{{SpecName('ESDraft', '#sec-symbol.for', 'Symbol.for')}}
+ +

Сумісність з веб-переглядачами

+ + + +

{{Compat("javascript.builtins.Symbol.for")}}

+ +

Див. також

+ + diff --git a/files/uk/web/javascript/reference/global_objects/symbol/keyfor/index.html b/files/uk/web/javascript/reference/global_objects/symbol/keyfor/index.html new file mode 100644 index 0000000000..52ae98f144 --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/symbol/keyfor/index.html @@ -0,0 +1,75 @@ +--- +title: Symbol.keyFor() +slug: Web/JavaScript/Reference/Global_Objects/Symbol/keyFor +tags: + - ECMAScript 2015 + - JavaScript + - Symbol + - Символ + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/keyFor +--- +
{{JSRef}}
+ +

Метод Symbol.keyFor(sym) отримує ключ спільного символа з глобального реєстру для наданого символа.

+ +
{{EmbedInteractiveExample("pages/js/symbol-keyfor.html")}}
+ + + +

Синтаксис

+ +
Symbol.keyFor(sym);
+ +

Параметри

+ +
+
sym
+
Символ, обов'язковий. Символ, для якого потрібно знайти ключ.
+
+ +

Повертає

+ +

Рядкове представлення ключа для наданого символа, якщо він був знайдений у глобальному реєстрі; інакше, {{jsxref("undefined")}}.

+ +

Приклади

+ +

Використання keyFor()

+ +
var globalSym = Symbol.for('foo'); // створити новий глобальний символ
+Symbol.keyFor(globalSym); // "foo"
+
+var localSym = Symbol();
+Symbol.keyFor(localSym); // undefined
+
+// добревідомі символи не є зареєстрованими
+// у глобальному реєстрі символів
+Symbol.keyFor(Symbol.iterator) // undefined
+
+ +

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

+ + + + + + + + + + + + +
Специфікація
{{SpecName('ESDraft', '#sec-symbol.keyfor', 'Symbol.keyFor')}}
+ +

Сумісність з веб-переглядачами

+ + + +

{{Compat("javascript.builtins.Symbol.keyFor")}}

+ +

Див. також

+ + diff --git a/files/uk/web/javascript/reference/global_objects/symbol/tosource/index.html b/files/uk/web/javascript/reference/global_objects/symbol/tosource/index.html new file mode 100644 index 0000000000..0abc2fb1cb --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/symbol/tosource/index.html @@ -0,0 +1,57 @@ +--- +title: Symbol.prototype.toSource() +slug: Web/JavaScript/Reference/Global_Objects/Symbol/toSource +tags: + - JavaScript + - Symbol + - Символ + - застарілий + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/toSource +--- +
{{JSRef}} {{obsolete_header}}
+ +

Метод toSource() повертає рядкове представлення першокоду об'єкта.

+ +

Цей метод зазвичай викликається внутрішньо у JavaScript.

+ +

Синтаксис

+ +
Symbol.toSource()
+
+var sym = Symbol()
+sym.toSource()
+ +

Повертає

+ +

Рядкове представлення першокоду об'єкта.

+ +

Приклади

+ +

Вбудована функція

+ +

Для вбудованого об'єкта Symbol метод toSource повертає наступний рядок, який вказує, що першокод недоступний:

+ +
"function Symbol() {
+   [native code]
+}"
+ +

Для екземплярів Symbol, toSource повертає рядок, що відображає першокод.

+ +
"Symbol()"
+ +

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

+ +

Не є частиною жодного стандарту.

+ +

Сумісність з веб-переглядачами

+ + + +

{{Compat("javascript.builtins.Symbol.toSource")}}

+ +

Див. також

+ + diff --git a/files/uk/web/javascript/reference/global_objects/symbol/tostring/index.html b/files/uk/web/javascript/reference/global_objects/symbol/tostring/index.html new file mode 100644 index 0000000000..37d28602a2 --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/symbol/tostring/index.html @@ -0,0 +1,76 @@ +--- +title: Symbol.prototype.toString() +slug: Web/JavaScript/Reference/Global_Objects/Symbol/toString +tags: + - ECMAScript 2015 + - JavaScript + - Symbol + - Символ + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/toString +--- +
{{JSRef}}
+ +

Метод toString() повертає рядок, що відображає вказаний об'єкт {{jsxref("Symbol")}}.

+ +
{{EmbedInteractiveExample("pages/js/symbol-prototype-tostring.html")}}
+ + + +

Синтаксис

+ +
Symbol().toString()
+ +

Повертає

+ +

Рядкове представлення вказаного об'єкта {{jsxref("Symbol")}}.

+ +

Опис

+ +

Об'єкт {{jsxref("Symbol")}} заміщує метод toString об'єкта {{jsxref("Object")}}; він не успадковує {{jsxref("Object.prototype.toString()")}}. Для об'єктів Symbol метод toString повертає рядкове представлення об'єкта.

+ +

Об'єднання з рядками не виконується

+ +

Хоча ви можете викликати toString() на символах, ви не можете об'єднувати їх з рядками:

+ +
Symbol('foo') + 'bar'        // TypeError: Can't convert symbol to string
+ +

Приклади

+ +

Використання toString()

+ +
Symbol('desc').toString()    // "Symbol(desc)"
+
+// добревідомі символи
+Symbol.iterator.toString()   // "Symbol(Symbol.iterator)
+
+// глобальні символи
+Symbol.for('foo').toString() // "Symbol(foo)"
+
+ +

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

+ + + + + + + + + + + + +
Специфікація
{{SpecName('ESDraft', '#sec-symbol.prototype.tostring', 'Symbol.prototype.toString')}}
+ +

Сумісність з веб-переглядачами

+ + + +

{{Compat("javascript.builtins.Symbol.toString")}}

+ +

Див. також

+ + diff --git a/files/uk/web/javascript/reference/global_objects/symbol/valueof/index.html b/files/uk/web/javascript/reference/global_objects/symbol/valueof/index.html new file mode 100644 index 0000000000..253b1eac7c --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/symbol/valueof/index.html @@ -0,0 +1,64 @@ +--- +title: Symbol.prototype.valueOf() +slug: Web/JavaScript/Reference/Global_Objects/Symbol/valueOf +tags: + - ECMAScript 2015 + - JavaScript + - Symbol + - Символ + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/valueOf +--- +
{{JSRef}}
+ +

Метод valueOf() повертає примітивне значення об'єкта Symbol.

+ +

Синтаксис

+ +
Symbol().valueOf()
+
+ +

Повертає

+ +

Примітивне значення вказаного об'єкта {{jsxref("Symbol")}}.

+ +

Опис

+ +

Метод valueOf() об'єкта {{jsxref("Symbol")}} повертає примітивне значення об'єкта Symbol у вигляді символьного типу даних.

+ +

JavaScript викликає метод valueOf() для перетворення об'єкта на примітивне значення. Вам рідко знадобиться викликати метод valueOf() власноруч; JavaScript автоматично запускає його, зустрівши об'єкт там, де очікується примітивне значення.

+ +

Приклади

+ +

Використання valueOf()

+ +
const sym = Symbol("example");
+sym === sym.valueOf(); // true
+
+ +

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

+ + + + + + + + + + + + +
Специфікація
{{SpecName('ESDraft', '#sec-symbol.prototype.valueof', 'Symbol.prototype.valueOf')}}
+ +

Сумісність з веб-переглядачами

+ + + +

{{Compat("javascript.builtins.Symbol.valueOf")}}

+ +

Див. також

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