Символы в JavaScript и TypeScript

Принципы

• Каждый Symbol('key') уникален, даже с одинаковым описанием — удобно для скрытых ключей.
• Символы можно использовать как ключи методов/свойств, чтобы избежать конфликтов ([getClassNameSymbol]()).
• В стандарте существует набор well-known символов (Symbol.iterator, Symbol.toStringTag, и т.д.), расширяющих поведение объектов.

Пример

const getClassNameSymbol = Symbol();

class C {
  [getClassNameSymbol]() {
    return 'C';
  }
}

const c = new C();
const className = c[getClassNameSymbol](); // "C"

Практика

• Используйте символы для инвариантов и «приватных» API, которые не должны появляться в автодополнении.
• Реализуйте протоколы итерации, конкатенации и преобразования, определяя методы с well-known символами (Symbol.iterator, Symbol.toPrimitive).
• Храните ссылки на символы в модуле или константе, чтобы разные части кода использовали один и тот же ключ.