KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Symbol.toStringTag — een aangepast objectlabel

Symbol.toStringTag is een bekend symbool dat als eigenschapssleutel het label levert in de uitvoer van Object.prototype.toString(). Het verandert de beschrijving van een object, niet het werkelijke type.

Versie: 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 is een bekend symbool, geen methode. Een objecteigenschap met deze sleutel kan de tekenreeks leveren die Object.prototype.toString.call(value) gebruikt voor een resultaat zoals [object Widget]. De symboolsleutel is niet hetzelfde als de tekenreekssleutel "Symbol.toStringTag".

De methode leest deze eigenschap ook via de prototypeketen. Als de waarde geen tekenreeks is, gebruikt ze het standaardlabel, bijvoorbeeld Object voor een gewoon object; de waarde wordt niet naar een tekenreeks omgezet. Een getter kan worden uitgevoerd en elke uitzondering die deze veroorzaakt, wordt doorgegeven.

Het label is beschrijvend en geen betrouwbare typecontrole: het kan worden vervalst. Het verandert typeof, het prototype of de interne mogelijkheden van het object niet. Het vervangt ook geen aangepaste toString()-methode en regelt niet in het algemeen de omzetting naar een primitieve waarde — dat is de rol van Symbol.toPrimitive.

Voorbeelden

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

Resultaat

[object Widget]
[object Object]
object

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen