Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Symbol.toPrimitive — vlastný prevod objektu na primitívnu hodnotu

Symbol.toPrimitive je známy symbol označujúci metódu na prevod objektu na primitívnu hodnotu. Metóda dostáva nápovedu "string", "number" alebo "default" a má prednosť pred bežným použitím valueOf() a toString().

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

Symbol.toPrimitive je symbol používaný ako kľúč metódy, nie prevodná funkcia. Definujte [Symbol.toPrimitive](hint) { ... }, ak chcete riadiť prevod objektu na primitívnu hodnotu. Metóda sa volá s prevádzaným objektom ako this.

Argument hint má hodnotu "string" pre String(obj), "number" pre Number(obj) a "default" pri sčítaní v obj + 3. Nápoveda nevynucuje typ výsledku: metóda musí vrátiť primitívnu hodnotu, ktorú môže okolitá operácia ďalej previesť. Vrátenie objektu vyvolá TypeError, bez pokusu použiť valueOf() alebo toString().

Ak má vlastnosť hodnotu undefined alebo null, použije sa bežný prevod: pri reťazcovej nápovede sa najprv skúša toString() a potom valueOf(); pri číselnej nápovede je poradie opačné. Bez nápovede bežný prevod uprednostňuje číslo. Akákoľvek iná nevolateľná hodnota vlastnosti vyvolá TypeError.

V príklade vráti String(amount) hodnotu Amount(7), Number(amount) hodnotu 7 a amount + 3 hodnotu 10. So všetkými tromi nápovedami zaobchádzajte zámerne, aby ste predišli prekvapivým výsledkom operátora +.

Príklady

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);

Výsledok

Amount(7)
7
10

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje