Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Symbol.toStringTag — prilagođena oznaka objekta

Symbol.toStringTag poznati je simbol koji se upotrebljava kao ključ svojstva za oznaku u rezultatu Object.prototype.toString(). Mijenja opis objekta, a ne njegov stvarni tip.

Verzija: 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 poznati je simbol, a ne metoda. Svojstvo objekta s tim ključem može pružiti niz koji Object.prototype.toString.call(value) upotrebljava za rezultat kao što je [object Widget]. Simbolički ključ nije isto što i nizovni ključ "Symbol.toStringTag".

Metoda čita to svojstvo i kroz lanac prototipova. Ako njegova vrijednost nije niz, upotrebljava zadanu oznaku, primjerice Object za običan objekt; vrijednost ne pretvara u niz. Getter se može izvršiti, a svaka iznimka koju izazove prosljeđuje se dalje.

Oznaka je opisna, a ne pouzdana provjera tipa: može se lažirati. Ne mijenja typeof, prototip ni unutarnje mogućnosti objekta. Također ne zamjenjuje prilagođenu metodu toString() niti općenito upravlja pretvorbom u primitivnu vrijednost — to je uloga simbola Symbol.toPrimitive.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori