Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Symbol.toPrimitive — prilagojena pretvorba objekta v primitivno vrednost

Symbol.toPrimitive je znani simbol, ki označuje metodo za pretvorbo objekta v primitivno vrednost. Metoda prejme namig "string", "number" ali "default" in ima prednost pred običajno uporabo valueOf() in toString().

Različica: 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 je simbol, ki se uporablja kot ključ metode, ne kot pretvorbena funkcija. Določite [Symbol.toPrimitive](hint) { ... }, da nadzirate pretvorbo objekta v primitivno vrednost. Metoda se pokliče s pretvarjanim objektom kot this.

Argument hint je "string" pri String(obj), "number" pri Number(obj) in "default" pri seštevanju v obj + 3. Namig ne določa vrste rezultata: metoda mora vrniti primitivno vrednost, ki jo lahko okoliška operacija še pretvori. Če vrne objekt, se sproži TypeError, ne da bi se poskusilo uporabiti valueOf() ali toString().

Če ima lastnost vrednost undefined ali null, velja običajna pretvorba: pri nizu kot namigu se najprej poskusi toString(), nato valueOf(); pri številu kot namigu je vrstni red obraten. Brez namiga običajna pretvorba daje prednost številu. Vsaka druga vrednost lastnosti, ki je ni mogoče poklicati, sproži TypeError.

V primeru String(amount) vrne Amount(7), Number(amount) vrne 7, amount + 3 pa vrne 10. Z vsemi tremi namigi ravnajte premišljeno, da se izognete presenetljivim rezultatom operatorja +.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri