Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Symbol.toPrimitive — prilagođena pretvorba objekta u primitivnu vrijednost

Symbol.toPrimitive poznati je simbol koji označava metodu za pretvorbu objekta u primitivnu vrijednost. Metoda prima naznaku "string", "number" ili "default" i ima prednost pred uobičajenom upotrebom valueOf() i toString().

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

Sintaksa

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

Symbol.toPrimitive simbol je koji se upotrebljava kao ključ metode, a ne funkcija za pretvorbu. Definirajte [Symbol.toPrimitive](hint) { ... } kako biste upravljali pretvorbom objekta u primitivnu vrijednost. Metoda se poziva tako da je objekt koji se pretvara njezin this.

Argument hint ima vrijednost "string" za String(obj), "number" za Number(obj) i "default" pri zbrajanju u obj + 3. Naznaka ne nameće vrstu rezultata: metoda mora vratiti primitivnu vrijednost, koju okolna operacija može dodatno pretvoriti. Vraćanje objekta uzrokuje TypeError, bez pokušaja pozivanja valueOf() ili toString().

Ako je vrijednost svojstva undefined ili null, primjenjuje se uobičajena pretvorba: uz naznaku za niz najprije se pokušava toString(), a zatim valueOf(); uz naznaku za broj redoslijed je obrnut. Bez naznake uobičajena pretvorba daje prednost broju. Svaka druga vrijednost svojstva koja se ne može pozvati uzrokuje TypeError.

U primjeru String(amount) daje Amount(7), Number(amount) daje 7, a amount + 3 daje 10. Promišljeno obradite sve tri naznake kako biste izbjegli neočekivane rezultate operatora +.

Primjeri

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

Rezultat

Amount(7)
7
10

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori