CKTIS / JavaScript
Symbol — unieke waarden en property keys
Symbol() maakt een unieke, onveranderlijke primitieve waarde die als property key van een object kan dienen. De beschrijving bepaalt de identiteit van een symbool niet; Symbol.for() maakt het mogelijk een symbool via een register te delen.
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
Symbol()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)Symbol(description) geeft een nieuwe, unieke primitieve waarde van het type symbol terug, geen object. De optionele beschrijving helpt het symbool te herkennen, maar is niet de identiteit ervan: twee aanroepen van Symbol("id") leveren verschillende waarden op. new Symbol() veroorzaakt een TypeError.
Een symbool kan als property key dienen, onafhankelijk van stringkeys. { [first]: "internal" } maakt een property met de waarde in first als sleutel, en record[first] leest de waarde ervan. De property record.id heeft een andere sleutel en kan zonder conflict daarnaast bestaan.
Symbol.for(key) zoekt een symbool op in het globale register of maakt er een aan: dezelfde stringkey levert hetzelfde symbool op. Symbol.keyFor(symbol) geeft de registersleutel terug, of undefined als het symbool niet geregistreerd is. Dit verschilt van het maken van een nieuw symbool met Symbol().
Een symbol-key biedt geen privacy: hij kan worden gevonden met Object.getOwnPropertySymbols(), hoewel Object.keys() hem overslaat. Ingebouwde symbolen zoals Symbol.iterator vormen een aparte groep vooraf gedefinieerde sleutels die door taalprotocollen worden gebruikt.
Voorbeelden
const first = Symbol("id");
const second = Symbol("id");
const record = { id: "public", [first]: "internal" };
console.log(typeof first);
console.log(first === second);
console.log(record.id);
console.log(record[first]);
console.log(Symbol.for("app.id") === Symbol.for("app.id"));
console.log(Symbol.keyFor(Symbol.for("app.id")));Resultaat
symbol false public internal true app.id
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.