dump 2020-12-11

6 files changed, 444 insertions, 0 deletions

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
+---
+<div>{{JSRef}}</div>
+
+<p>Метод <strong><code>[@@toPrimitive]()</code></strong> перетворює об'єкт Symbol на примітивне значення.</p>
+
+<h2 id="Синтаксис">Синтаксис</h2>
+
+<pre class="syntaxbox notranslate">Symbol()[Symbol.toPrimitive](<var>hint</var>)
+</pre>
+
+<h3 id="Повертає">Повертає</h3>
+
+<p>Примітивне значення вказаного об'єкта {{jsxref("Symbol")}}.</p>
+
+<h2 id="Опис">Опис</h2>
+
+<p>Метод <code>[@@toPrimitive]()</code> об'єкта {{jsxref("Symbol")}} повертає примітивне значення об'єкта Symbol у вигляді символьного типу даних. Аргумент <code><var>hint</var></code> не використовується.</p>
+
+<p>JavaScript викликає метод <code>[@@toPrimitive]()</code> для перетворення об'єкта на примітивне значення. Вам рідко знадобиться запускати метод <code>[@@toPrimitive]()</code> власноруч; JavaScript автоматично запускає його, зустрівши об'єкт там, де очікується примітивне значення.</p>
+
+<h2 id="Приклади">Приклади</h2>
+
+<h3 id="Використання_toPrimitive">Використання @@toPrimitive</h3>
+
+<pre class="brush: js notranslate">const sym = Symbol("example");
+sym === sym[Symbol.toPrimitive](); // true
+</pre>
+
+<h2 id="Специфікації">Специфікації</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Специфікація</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('ESDraft', '#sec-symbol.prototype-@@toprimitive', 'Symbol.prototype.@@toPrimitive')}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2>
+
+
+
+<p>{{Compat("javascript.builtins.Symbol.@@toPrimitive")}}</p>
+
+<h2 id="Див._також">Див. також</h2>
+
+<ul>
+ <li>{{jsxref("Symbol.toPrimitive")}}</li>
+</ul>
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
+---
+<div>{{JSRef}}</div>
+
+<p>Метод <strong><code>Symbol.for(key)</code></strong> шукає існуючі символи у загальному реєстрі символів за заданим ключем, та повертає, якщо знаходить. Інакше, у глобальному реєстрі символів створюється новий символ з цим ключем.</p>
+
+<div>{{EmbedInteractiveExample("pages/js/symbol-for.html")}}</div>
+
+<div class="hidden">The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> and send us a pull request.</div>
+
+<h2 id="Синтаксис">Синтаксис</h2>
+
+<pre class="syntaxbox notranslate">Symbol.for(<var>key</var>);</pre>
+
+<h3 id="Параметри">Параметри</h3>
+
+<dl>
+ <dt><code><var>key</var></code></dt>
+ <dd>Рядок, обов'язковий. Ключ для символа (а також використовується для опису символа).</dd>
+</dl>
+
+<h3 id="Повертає">Повертає</h3>
+
+<p>Існуючий символ з наданим ключем, якщо його знайдено; інакше, створюється та повертається новий символ.</p>
+
+<h2 id="Опис">Опис</h2>
+
+<p>На відміну від <code>Symbol()</code>, функція <code>Symbol.for()</code> створює символ, доступний у списку глобального реєстру символів. <code>Symbol.for()</code> також не обов'язково створює новий символ при кожному виклику, а спочатку перевіряє, чи існує вже символ з наданим ключем <code>key</code> у реєстрі. В такому випадку повертається цей символ. Якщо символ з наданим ключем не знайдений, <code>Symbol.for()</code> створить новий глобальний символ.</p>
+
+<h3 id="Глобальний_реєстр_символів">Глобальний реєстр символів</h3>
+
+<p>Глобальний реєстр символів - це список з наступною структурою запису, який ініціалізується порожнім:</p>
+
+<table class="standard-table">
+ <caption>Запис у глобальному реєстрі символів</caption>
+ <tbody>
+  <tr>
+   <th>Ім'я поля</th>
+   <th>Значення</th>
+  </tr>
+  <tr>
+   <td>[[key]]</td>
+   <td>Рядковий ключ для ідентифікації символа.</td>
+  </tr>
+  <tr>
+   <td>[[symbol]]</td>
+   <td>Символ, що зберігається глобально.</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Приклади">Приклади</h2>
+
+<h3 id="Використання_Symbol.for">Використання Symbol.for()</h3>
+
+<pre class="brush: js notranslate">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)"
+</pre>
+
+<p>Щоб уникнути конфліктів між іменами ваших ключів глобальних символів та іншими (код бібліотеки) глобальними символами, може бути гарною ідеєю додавати до ваших символів префікс:</p>
+
+<pre class="brush: js notranslate">Symbol.for('mdn.foo');
+Symbol.for('mdn.bar');
+</pre>
+
+<h2 id="Специфікації">Специфікації</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Специфікація</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('ESDraft', '#sec-symbol.for', 'Symbol.for')}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2>
+
+
+
+<p>{{Compat("javascript.builtins.Symbol.for")}}</p>
+
+<h2 id="Див._також">Див. також</h2>
+
+<ul>
+ <li>{{jsxref("Symbol.keyFor()")}}</li>
+</ul>
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
+---
+<div>{{JSRef}}</div>
+
+<p>Метод <strong><code>Symbol.keyFor(sym)</code></strong> отримує ключ спільного символа з глобального реєстру для наданого символа.</p>
+
+<div>{{EmbedInteractiveExample("pages/js/symbol-keyfor.html")}}</div>
+
+
+
+<h2 id="Синтаксис">Синтаксис</h2>
+
+<pre class="syntaxbox notranslate">Symbol.keyFor(<var>sym</var>);</pre>
+
+<h3 id="Параметри">Параметри</h3>
+
+<dl>
+ <dt><code><var>sym</var></code></dt>
+ <dd>Символ, обов'язковий. Символ, для якого потрібно знайти ключ.</dd>
+</dl>
+
+<h3 id="Повертає">Повертає</h3>
+
+<p>Рядкове представлення ключа для наданого символа, якщо він був знайдений у глобальному реєстрі; інакше, {{jsxref("undefined")}}.</p>
+
+<h2 id="Приклади">Приклади</h2>
+
+<h3 id="Використання_keyFor">Використання keyFor()</h3>
+
+<pre class="brush: js notranslate">var globalSym = Symbol.for('foo'); // створити новий глобальний символ
+Symbol.keyFor(globalSym); // "foo"
+
+var localSym = Symbol();
+Symbol.keyFor(localSym); // undefined
+
+// добревідомі символи не є зареєстрованими
+// у глобальному реєстрі символів
+Symbol.keyFor(Symbol.iterator) // undefined
+</pre>
+
+<h2 id="Специфікації">Специфікації</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Специфікація</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('ESDraft', '#sec-symbol.keyfor', 'Symbol.keyFor')}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2>
+
+
+
+<p>{{Compat("javascript.builtins.Symbol.keyFor")}}</p>
+
+<h2 id="Див._також">Див. також</h2>
+
+<ul>
+ <li>{{jsxref("Symbol.for()")}}</li>
+</ul>
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
+---
+<div>{{JSRef}} {{obsolete_header}}</div>
+
+<p>Метод <strong><code>toSource()</code></strong> повертає рядкове представлення першокоду об'єкта.</p>
+
+<p>Цей метод зазвичай викликається внутрішньо у JavaScript.</p>
+
+<h2 id="Синтаксис">Синтаксис</h2>
+
+<pre class="syntaxbox notranslate"><var>Symbol</var>.toSource()
+
+var sym = Symbol()
+sym.toSource()</pre>
+
+<h3 id="Повертає">Повертає</h3>
+
+<p>Рядкове представлення першокоду об'єкта.</p>
+
+<h2 id="Приклади">Приклади</h2>
+
+<h3 id="Вбудована_функція">Вбудована функція</h3>
+
+<p>Для вбудованого об'єкта <code>Symbol</code> метод <code>toSource</code> повертає наступний рядок, який вказує, що першокод недоступний:</p>
+
+<pre class="brush:js notranslate">"function Symbol() {
+   [native code]
+}"</pre>
+
+<p>Для екземплярів <code>Symbol</code>, <code>toSource</code> повертає рядок, що відображає першокод.</p>
+
+<pre class="brush: js notranslate">"Symbol()"</pre>
+
+<h2 id="Специфікації">Специфікації</h2>
+
+<p>Не є частиною жодного стандарту.</p>
+
+<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2>
+
+
+
+<p>{{Compat("javascript.builtins.Symbol.toSource")}}</p>
+
+<h2 id="Див._також">Див. також</h2>
+
+<ul>
+ <li>{{jsxref("Object.prototype.toSource()")}}</li>
+</ul>
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
+---
+<div>{{JSRef}}</div>
+
+<p>Метод <strong><code>toString()</code></strong> повертає рядок, що відображає вказаний об'єкт {{jsxref("Symbol")}}.</p>
+
+<div>{{EmbedInteractiveExample("pages/js/symbol-prototype-tostring.html")}}</div>
+
+<div class="hidden">The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> and send us a pull request.</div>
+
+<h2 id="Синтаксис">Синтаксис</h2>
+
+<pre class="notranslate">Symbol().toString()</pre>
+
+<h3 id="Повертає">Повертає</h3>
+
+<p>Рядкове представлення вказаного об'єкта {{jsxref("Symbol")}}.</p>
+
+<h2 id="Опис">Опис</h2>
+
+<p>Об'єкт {{jsxref("Symbol")}} заміщує метод <code>toString</code> об'єкта {{jsxref("Object")}}; він не успадковує {{jsxref("Object.prototype.toString()")}}. Для об'єктів <code>Symbol</code> метод <code>toString</code> повертає рядкове представлення об'єкта.</p>
+
+<h3 id="Обєднання_з_рядками_не_виконується">Об'єднання з рядками не виконується</h3>
+
+<p>Хоча ви можете викликати <code>toString()</code> на символах, ви не можете об'єднувати їх з рядками:</p>
+
+<pre class="brush: js notranslate">Symbol('foo') + 'bar'        // TypeError: Can't convert symbol to string</pre>
+
+<h2 id="Приклади">Приклади</h2>
+
+<h3 id="Використання_toString">Використання toString()</h3>
+
+<pre class="brush: js notranslate">Symbol('desc').toString()    // "Symbol(desc)"
+
+// добревідомі символи
+Symbol.iterator.toString()   // "Symbol(Symbol.iterator)
+
+// глобальні символи
+Symbol.for('foo').toString() // "Symbol(foo)"
+</pre>
+
+<h2 id="Специфікації">Специфікації</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Специфікація</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('ESDraft', '#sec-symbol.prototype.tostring', 'Symbol.prototype.toString')}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2>
+
+
+
+<p>{{Compat("javascript.builtins.Symbol.toString")}}</p>
+
+<h2 id="Див._також">Див. також</h2>
+
+<ul>
+ <li>{{jsxref("Object.prototype.toString()")}}</li>
+</ul>
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
+---
+<div>{{JSRef}}</div>
+
+<p>Метод <strong><code>valueOf()</code></strong> повертає примітивне значення об'єкта Symbol.</p>
+
+<h2 id="Синтаксис">Синтаксис</h2>
+
+<pre class="notranslate">Symbol().valueOf()
+</pre>
+
+<h3 id="Повертає">Повертає</h3>
+
+<p>Примітивне значення вказаного об'єкта {{jsxref("Symbol")}}.</p>
+
+<h2 id="Опис">Опис</h2>
+
+<p>Метод <code>valueOf()</code> об'єкта {{jsxref("Symbol")}} повертає примітивне значення об'єкта Symbol у вигляді символьного типу даних.</p>
+
+<p>JavaScript викликає метод <code>valueOf()</code> для перетворення об'єкта на примітивне значення. Вам рідко знадобиться викликати метод <code>valueOf()</code> власноруч; JavaScript автоматично запускає його, зустрівши об'єкт там, де очікується примітивне значення.</p>
+
+<h2 id="Приклади">Приклади</h2>
+
+<h3 id="Використання_valueOf">Використання valueOf()</h3>
+
+<pre class="brush: js notranslate">const sym = Symbol("example");
+sym === sym.valueOf(); // true
+</pre>
+
+<h2 id="Специфікації">Специфікації</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Специфікація</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('ESDraft', '#sec-symbol.prototype.valueof', 'Symbol.prototype.valueOf')}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2>
+
+
+
+<p>{{Compat("javascript.builtins.Symbol.valueOf")}}</p>
+
+<h2 id="Див._також">Див. також</h2>
+
+<ul>
+ <li>{{jsxref("Object.prototype.valueOf()")}}</li>
+</ul>