CKTIS / JavaScript
Symbol.toStringTag — vlastní značka objektu
Symbol.toStringTag je známý symbol používaný jako klíč vlastnosti, který poskytuje značku ve výstupu Object.prototype.toString(). Mění popis objektu, nikoli jeho skutečný typ.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const value = { [Symbol.toStringTag]: "Widget" };
Object.prototype.toString.call(value);Symbol.toStringTag je známý symbol, nikoli metoda. Vlastnost objektu s tímto klíčem může poskytnout řetězec, který Object.prototype.toString.call(value) použije k vytvoření výsledku, jako je [object Widget]. Symbolový klíč není totéž co řetězcový klíč "Symbol.toStringTag".
Metoda tuto vlastnost čte také v řetězci prototypů. Pokud její hodnota není řetězec, použije výchozí značku, například Object pro běžný objekt; hodnotu na řetězec nepřevádí. Getter se může spustit a každá výjimka, kterou vyvolá, se předá dál.
Značka slouží k popisu, nejde o spolehlivou kontrolu typu: lze ji zfalšovat. Nemění typeof, prototyp ani vnitřní schopnosti objektu. Nenahrazuje ani vlastní metodu toString() a obecně neřídí převod na primitivní hodnotu — to je úloha Symbol.toPrimitive.
Pří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ýsledek
[object Widget] [object Object] object
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.