diff options
Diffstat (limited to 'files/uk/web/javascript/reference/global_objects')
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> |