База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Symbol.toPrimitive — персонализирано преобразуване на обект в примитивна стойност

Symbol.toPrimitive е добре познат символ, който обозначава метода за преобразуване на обект в примитивна стойност. Методът получава подсказка "string", "number" или "default" и има предимство пред обичайната употреба на valueOf() и toString().

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const value = { [Symbol.toPrimitive](hint) { return hint === "string" ? "label" : 10; } };

Symbol.toPrimitive е символ, използван като ключ на метод, а не функция за преобразуване. Дефинирайте [Symbol.toPrimitive](hint) { ... }, за да управлявате преобразуването на обект в примитивна стойност. Методът се извиква така, че преобразуваният обект е this.

Аргументът hint е "string" за String(obj), "number" за Number(obj) и "default" при събирането в obj + 3. Подсказката не налага типа на резултата: методът трябва да върне примитивна стойност, която обгръщащата операция може да преобразува допълнително. Връщането на обект предизвиква TypeError, без да се опитва използване на valueOf() или toString().

Ако свойството има стойност undefined или null, се прилага обичайното преобразуване: при подсказка за низ първо се опитва toString(), а след това valueOf(); при подсказка за число редът е обратен. Без подсказка обичайното преобразуване предпочита число. Всяка друга стойност на свойството, която не може да бъде извикана, предизвиква TypeError.

В примера String(amount) дава Amount(7), Number(amount) дава 7, а amount + 3 дава 10. Обработвайте съзнателно и трите подсказки, за да избегнете изненадващи резултати от оператора +.

Примери

const amount = {
  value: 7,
  [Symbol.toPrimitive](hint) {
    if (hint === "string") return `Amount(${this.value})`;
    return this.value;
  }
};

console.log(String(amount));
console.log(Number(amount));
console.log(amount + 3);

Резултат

Amount(7)
7
10

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници