KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Object.getOwnPropertyNames — namen van eigen eigenschappen

Object.getOwnPropertyNames(obj) retourneert een nieuwe array met tekenreekssleutels. Bij gewone objecten zijn dat de tekenreekssleutels van alle eigen eigenschappen, ook van niet-enumerabele eigenschappen. Symbol-sleutels ontbreken en de ownKeys-trap van een Proxy kan de lijst beïnvloeden.

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.getOwnPropertyNames(obj)

Object.getOwnPropertyNames(obj) is een statische methode: roep deze aan op Object, niet op het onderzochte object. De methode retourneert een nieuwe array met alleen de tekenreekssleutels uit het resultaat van de interne bewerking [[OwnPropertyKeys]], zonder eigenschapsdescriptors te controleren. Bij gewone objecten zijn dat alle eigen tekenreekssleutels, ongeacht het attribuut enumerable, maar geen sleutels van overgeërfde eigenschappen. De methode retourneert sleutels, geen waarden van eigenschappen.

Bij gewone objecten bevat Object.keys(obj) alleen de sleutels van enumerabele eigen eigenschappen met tekenreekssleutels. Object.getOwnPropertySymbols(obj) retourneert eigen Symbol-sleutels, terwijl Reflect.ownKeys(obj) zowel eigen tekenreekssleutels als eigen Symbol-sleutels retourneert, ook die van niet-enumerabele eigenschappen. ‘Eigen’ en ‘enumerabel’ zijn verschillende kenmerken.

Bij gewone objecten verschijnen namen die array-indexen zijn eerst, in oplopende numerieke volgorde; andere tekenreekssleutels volgen de volgorde waarin de eigenschappen zijn aangemaakt. Dit is geen alfabetische sortering. Proxy-objecten kunnen de lijst en volgorde aanpassen via de ownKeys-trap, binnen de beperkingen van de specificatie. Als het doelobject uitbreidbaar is, kan de trap een tekenreekssleutel opgeven zonder bijbehorende descriptor voor een eigen eigenschap, of de tekenreekssleutel van een configureerbare eigen eigenschap van het doelobject weglaten.

null en undefined veroorzaken een TypeError; andere primitieve waarden worden omgezet in objecten. Het voorbeeld laat de volgorde van indexen zien en dat hidden wordt opgenomen; bij dit gebruik van Object.defineProperty is die eigenschap standaard niet-enumerabel. De eigenschap inherited en de Symbol-sleutel worden weggelaten.

Voorbeelden

const obj = Object.create({ inherited: true });
obj[10] = 'ten';
obj[2] = 'two';
obj.label = 'demo';
Object.defineProperty(obj, 'hidden', { value: 42 });
obj[Symbol('token')] = 'secret';

console.log(JSON.stringify(Object.getOwnPropertyNames(obj)));
console.log(JSON.stringify(Object.keys(obj)));

Resultaat

["2","10","label","hidden"]
["2","10","label"]

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