Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Symbol.toStringTag — własna etykieta obiektu

Symbol.toStringTag jest standardowym symbolem używanym jako klucz właściwości określającej etykietę w wyniku Object.prototype.toString(). Zmienia opis obiektu, ale nie jego rzeczywisty typ.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const value = { [Symbol.toStringTag]: "Widget" };
Object.prototype.toString.call(value);

Symbol.toStringTag jest symbolem wbudowanym, a nie metodą. Właściwość obiektu o tym kluczu może dostarczać napis używany przez Object.prototype.toString.call(value) do utworzenia wyniku [object Widget]. Klucz symboliczny nie jest tym samym co klucz tekstowy "Symbol.toStringTag".

Metoda odczytuje tę właściwość także z prototypu. Jeśli wartość nie jest napisem, używa etykiety domyślnej, np. Object dla zwykłego obiektu; nie konwertuje wartości na napis. Getter może zostać wywołany, a zgłoszony przez niego wyjątek zostanie przekazany dalej.

Etykieta służy do opisu, nie do wiarygodnego sprawdzania typu: można ją podrobić. Nie zmienia wyniku typeof, prototypu ani wewnętrznych możliwości obiektu. Nie zastępuje też własnej metody toString() i nie steruje ogólnie konwersją do wartości prymitywnej — do tego służy Symbol.toPrimitive.

Przykłady

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);

Wynik

[object Widget]
[object Object]
object

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła