CKTIS / JavaScript
Symbol.toStringTag — vlastná značka objektu
Symbol.toStringTag je známy symbol používaný ako kľúč vlastnosti, ktorý poskytuje značku vo výstupe Object.prototype.toString(). Mení opis objektu, nie jeho skutočný typ.
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.toStringTag]: "Widget" };
Object.prototype.toString.call(value);Symbol.toStringTag je známy symbol, nie metóda. Vlastnosť objektu s týmto kľúčom môže poskytnúť reťazec, ktorý Object.prototype.toString.call(value) použije na vytvorenie výsledku, napríklad [object Widget]. Symbolový kľúč nie je to isté ako reťazcový kľúč "Symbol.toStringTag".
Metóda číta túto vlastnosť aj v reťazci prototypov. Ak jej hodnota nie je reťazec, použije predvolenú značku, napríklad Object pre bežný objekt; hodnotu na reťazec nekonvertuje. Getter sa môže spustiť a každá výnimka, ktorú vyvolá, sa propaguje ďalej.
Značka je opisná, nie je to spoľahlivá kontrola typu: možno ju sfalšovať. Nemení typeof, prototyp ani vnútorné schopnosti objektu. Nenahrádza ani vlastnú metódu toString() a všeobecne neriadi konverziu na primitívnu hodnotu — to je úloha Symbol.toPrimitive.
Príklady
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);Výsledok
[object Widget] [object Object] object
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.