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.