CKTIS / JavaScript
Object.getOwnPropertySymbols — eigen Symbol-sleutels
Object.getOwnPropertySymbols(obj) geeft een array met Symbol-sleutels terug. Bij gewone objecten zijn dat de sleutels van eigen eigenschappen, ook van niet-enumerabele. De methode laat tekenreekssleutels weg en doorloopt de prototypeketen niet.
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
Object.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) is een statische methode van Object die een nieuwe array maakt met alleen de Symbol-sleutels uit de lijst die de interne operatie [[OwnPropertyKeys]] van het object teruggeeft. De methode geeft sleutels terug, geen waarden of symboolbeschrijvingen. Lees de waarde van een eigenschap met obj[key].
De methode laat tekenreekssleutels weg en doorloopt de prototypeketen niet. Ze controleert geen eigenschapsdescriptoren: een Proxy met een uitbreidbaar doelobject kan via zijn ownKeys-trap een symbool melden, ook als de proxy voor dat symbool geen descriptor van een eigen eigenschap heeft.
Bij gewone objecten bevat het resultaat de sleutels van zowel enumerabele als niet-enumerabele eigen eigenschappen. De symbolen staan in de volgorde waarin die eigenschappen zijn aangemaakt. Object.keys(obj) geeft alleen de tekenreekssleutels van enumerabele eigen eigenschappen terug, Object.getOwnPropertyNames(obj) geeft alle eigen tekenreekssleutels terug en Reflect.ownKeys(obj) geeft beide soorten eigen sleutels terug.
Het argument wordt omgezet naar een object; null en undefined veroorzaken een TypeError. Symbolen bieden geen privacy: met deze methode kun je zulke sleutels vinden, zelfs wanneer enumerable: false geldt.
In het voorbeeld bevat het resultaat visible en hidden, maar niet inherited of name. De vergelijkingen controleren de identiteit van de symbolen, en de laatste regel leest de waarden van de bijbehorende eigenschappen uit.
Voorbeelden
const inherited = Symbol('inherited');
const visible = Symbol('visible');
const hidden = Symbol('hidden');
const obj = Object.create({ [inherited]: 10 });
obj.name = 'demo';
obj[visible] = 20;
Object.defineProperty(obj, hidden, {
value: 30,
enumerable: false
});
const keys = Object.getOwnPropertySymbols(obj);
console.log(keys.length);
console.log(keys[0] === visible, keys[1] === hidden);
console.log(keys.includes(inherited));
console.log(keys.map(key => obj[key]).join(','));Resultaat
2 true true false 20,30
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.