JavaScript Academy · Урок

Хорошо известные Symbol

Настраивайте поведение с помощью Symbol.iterator и других символов.

«Хорошо известные Symbol» — бесплатный урок JavaScript Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения JavaScript Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс JavaScript Academy содержит 4 уроков всего.

Общеизвестные символы

Общеизвестные символы — это встроенные символы, хранящиеся в объекте Symbol. Они позволяют настраивать поведение объектов при использовании языковых возможностей, например перебора и преобразования.

console.log(typeof Symbol.iterator)
console.log(typeof Symbol.toPrimitive)

Symbol.iterator

Symbol.iterator определяет, как объект перебирается циклом for-of и оператором разворачивания. Встроенные массивы и строки уже предоставляют его.

const arr = [10, 20]
const it = arr[Symbol.iterator]()
console.log(it.next().value)

Создание перебираемого объекта

Чтобы любой объект можно было использовать в цикле for-of, добавьте метод Symbol.iterator, который возвращает итератор с методом next.

const range = {
  from: 1,
  to: 3,
  [Symbol.iterator]() {
    let cur = this.from
    const last = this.to
    return {
      next() {
        return cur <= last ? { value: cur++, done: false } : { value: undefined, done: true }
      }
    }
  }
}
for (const n of range) {
  console.log(n)
}

Перебор с разворачиванием

Поскольку Symbol.iterator также управляет разворачиванием, пользовательский перебираемый объект можно развернуть в массив.

const nums = {
  [Symbol.iterator]() {
    let i = 0
    return { next() { return i < 3 ? { value: i++, done: false } : { value: undefined, done: true } } }
  }
}
console.log([...nums])

Symbol.toPrimitive

Symbol.toPrimitive позволяет объекту управлять преобразованием в примитив в числовом, строковом контексте или контексте по умолчанию.

const money = {
  amount: 50,
  [Symbol.toPrimitive](hint) {
    if (hint === "number") return this.amount
    return "$" + this.amount
  }
}
console.log(+money)
console.log(money + "")

Аргумент-подсказка

Обработчик преобразования получает подсказку со значением number, string или default, что позволяет вернуть подходящее значение для каждой ситуации.

const obj = {
  [Symbol.toPrimitive](hint) {
    return hint
  }
}
console.log(+obj)
console.log(obj + "")
console.log(String(obj))

Symbol.toStringTag

Symbol.toStringTag настраивает текст, который стандартный toString сообщает об объекте, что полезно для пользовательских меток типов.

const widget = {
  [Symbol.toStringTag]: "Widget"
}
console.log(Object.prototype.toString.call(widget))

Symbol.hasInstance

Symbol.hasInstance позволяет классу или объекту настраивать поведение оператора instanceof.

class Even {
  static [Symbol.hasInstance](num) {
    return num % 2 === 0
  }
}
console.log(4 instanceof Even)
console.log(3 instanceof Even)

Встроенные объекты тоже их используют

Массивы, отображения, множества и строки реализуют Symbol.iterator, поэтому они без дополнительных усилий работают с for-of и разворачиванием.

const set = new Set([1, 2, 3])
console.log([...set])

Почему они важны

Общеизвестные символы — это точки расширения: они позволяют объектам естественно взаимодействовать со встроенными языковыми операциями, вместо того чтобы обрабатывать их отдельно.

const list = {
  items: ["a", "b"],
  [Symbol.iterator]() {
    return this.items[Symbol.iterator]()
  }
}
for (const x of list) {
  console.log(x)
}

Как их найти

Объект Symbol предоставляет их как статические свойства. При необходимости на них можно ссылаться как на Symbol.iterator и Symbol.toPrimitive.

console.log(typeof Symbol.iterator)
console.log(typeof Symbol.toStringTag)
console.log(typeof Symbol.hasInstance)

Быстрая проверка

Проверьте свои знания об общеизвестных символах.

Повторение

Повторение: общеизвестные символы настраивают поведение языка.

Symbol.iterator управляет for-of и разворачиванием
Symbol.toPrimitive управляет преобразованиями с помощью подсказки
Symbol.toStringTag задаёт метки объектов
Symbol.hasInstance настраивает instanceof

const r = { [Symbol.iterator]() { let i = 0; return { next() { return i < 2 ? { value: i++, done: false } : { value: 0, done: true } } } } }
console.log([...r])

Часто задаваемые вопросы

Урок «Хорошо известные Symbol» бесплатный?

Да — полный текст урока «Хорошо известные Symbol» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс JavaScript Academy, подпишись на CoddyKit PRO. Курс JavaScript Academy содержит 4 уроков всего.

Чему я научусь в уроке «Хорошо известные Symbol»?

Настраивайте поведение с помощью Symbol.iterator и других символов. Ты практикуешь JavaScript Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать JavaScript Academy?

Предыдущий опыт не требуется. JavaScript Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Хорошо известные Symbol»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке JavaScript Academy?

Да. Каждый урок JavaScript Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к JavaScript Academy