CKTIS / JavaScript
Symbol.toStringTag — oznaka objekta po meri
Symbol.toStringTag je znani simbol, ki se uporablja kot ključ lastnosti za oznako v izpisu Object.prototype.toString(). Spremeni opis objekta, ne pa njegovega dejanskega tipa.
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.toStringTag]: "Widget" };
Object.prototype.toString.call(value);Symbol.toStringTag je znani simbol, ne metoda. Lastnost objekta s tem ključem lahko zagotovi niz, ki ga Object.prototype.toString.call(value) uporabi za rezultat, kot je [object Widget]. Simbolni ključ ni enak nizu "Symbol.toStringTag" kot ključu.
Metoda to lastnost prebere tudi vzdolž verige prototipov. Če njena vrednost ni niz, uporabi privzeto oznako, na primer Object za običajen objekt; vrednosti ne pretvori v niz. Getter se lahko izvede, vsaka izjema, ki jo sproži, pa se posreduje naprej.
Oznaka je opisna in ni zanesljivo preverjanje tipa: mogoče jo je ponarediti. Ne spremeni typeof, prototipa ali notranjih zmožnosti objekta. Prav tako ne nadomesti lastne metode toString() in na splošno ne upravlja pretvorbe v primitivno vrednost — to je naloga Symbol.toPrimitive.
Primeri
const item = { [Symbol.toStringTag]: "Widget" };
console.log(Object.prototype.toString.call(item));
item[Symbol.toStringTag] = 42;
console.log(Object.prototype.toString.call(item));
console.log(typeof item);Rezultat
[object Widget] [object Object] object
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.