CKTIS / JavaScript
Symbol.toPrimitive — aangepaste omzetting van object naar primitieve waarde
Symbol.toPrimitive is een bekend symbool dat de methode voor het omzetten van een object naar een primitieve waarde aanduidt. De methode krijgt de hint "string", "number" of "default" en heeft voorrang op het gewone gebruik van valueOf() en toString().
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.toPrimitive](hint) { return hint === "string" ? "label" : 10; } };Symbol.toPrimitive is een symbool dat als methodesleutel wordt gebruikt, geen conversiefunctie. Definieer [Symbol.toPrimitive](hint) { ... } om te bepalen hoe een object naar een primitieve waarde wordt omgezet. De methode wordt aangeroepen met het om te zetten object als this.
Het argument hint is "string" voor String(obj), "number" voor Number(obj) en "default" bij de optelling in obj + 3. De hint dwingt het type van het resultaat niet af: de methode moet een primitieve waarde retourneren, die de omringende bewerking verder kan omzetten. Een object retourneren veroorzaakt TypeError, zonder valueOf() of toString() te proberen.
Als de eigenschap de waarde undefined of null heeft, geldt de gewone conversie: bij een stringhint wordt eerst toString() en daarna valueOf() geprobeerd; bij een numberhint is de volgorde omgekeerd. Zonder hint geeft de gewone conversie de voorkeur aan een getal. Elke andere niet-aanroepbare waarde van de eigenschap veroorzaakt TypeError.
In het voorbeeld levert String(amount) Amount(7) op, Number(amount) levert 7 op en amount + 3 levert 10 op. Behandel alle drie de hints bewust om verrassende resultaten met de operator + te voorkomen.
Voorbeelden
const amount = {
value: 7,
[Symbol.toPrimitive](hint) {
if (hint === "string") return `Amount(${this.value})`;
return this.value;
}
};
console.log(String(amount));
console.log(Number(amount));
console.log(amount + 3);Resultaat
Amount(7) 7 10
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.