JavaScript Symbol.for() — символ із глобального реєстру

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

правити

Загальний опис

Це прямо протилежно звичайному Symbol(), який щоразу створює новий, унікальний символ. Два виклики Symbol('id') дають два різні символи; два виклики Symbol.for('id') — один і той самий.

Навіщо це? Щоб різні частини коду могли домовитись про ключ, не передаючи посилання одна одній. Дві бібліотеки, два iframe, скрипт і його розширення — усі, хто знає рядок 'app.id', отримають один символ.

Реєстр глобальний на всю сторінку, тож ключі варто робити довгими й унікальними — як імена пакетів.

правити

Порада

Ключ у реєстрі — глобальний. Пиши Symbol.for('css-in-ua.state'), а не Symbol.for('state'), щоб не зіткнутись із чужою бібліотекою.

автор: NagarD правити

+ додати пораду чи нотатку

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	40	36	9	27	12	—

Підтримка: мобільні переглядачі

Переглядач
	40	40	36	9

Підтримка: серверні переглядачі

Переглядач
	0.12.0	1.0

Приклади

+ запропонувати свій приклад у пісочниці

// звичайний Symbol — щоразу НОВИЙ
console.log(Symbol('id') === Symbol('id')); // false

// а з реєстру — ТОЙ САМИЙ
console.log(Symbol.for('app.id') === Symbol.for('app.id')); // true

// бібліотека A
const key = Symbol.for('css-in-ua.state');
window.widget = { [key]: { open: true } };

// бібліотека B — без жодного спільного коду
const sameKey = Symbol.for('css-in-ua.state');
console.log(window.widget[sameKey]); // { open: true }