KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Object.keys — eigen opsombare objectsleutels

Object.keys(obj) retourneert een nieuwe array met de eigen opsombare tekenreekssleutels van een object. Overgeërfde, niet-opsombare eigenschappen en Symbol-sleutels worden uitgesloten. Bij gewone objecten staan sleutels die array-indexen zijn vóór de overige tekenreekssleutels.

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

Object.keys(obj) is een statische methode van Object die een nieuwe array met eigenschapsnamen retourneert. De methode neemt alleen eigen eigenschappen mee: eigenschappen die niet van een prototype zijn geërfd, waarvan het kenmerk enumerable true is en waarvan de sleutel een tekenreeks is. Het resultaat bevat tekenreeksen, ook als de sleutels als getallen zijn geschreven. Symbol-sleutels worden uitgesloten.

Bij gewone objecten staan sleutels die array-indexen zijn in oplopende numerieke volgorde, gevolgd door de overige tekenreekssleutels in de volgorde waarin de eigenschappen zijn aangemaakt. Dit is geen alfabetische sortering en geldt niet voor elke tekenreeks die op een getal lijkt: "02" is geen array-index. Proxy-objecten kunnen de volgorde beïnvloeden en tijdens het opsommen code uitvoeren.

In tegenstelling tot for...in sluit de methode overgeërfde opsombare eigenschappen uit. Reflect.ownKeys(obj) neemt daarentegen ook eigen niet-opsombare eigenschappen en Symbol-sleutels mee. Object.keys leest zelf geen eigenschapswaarden en roept hun getters niet aan; de geretourneerde array wordt niet bijgewerkt wanneer het object verandert.

null en undefined veroorzaken een TypeError. Andere primitieve waarden worden naar objecten omgezet: Object.keys("ab") levert ["0","1"] op, terwijl Object.keys(42) [] oplevert. Dit is een ECMAScript-taal-API, geen browser-API; het uitvoeren van het voorbeeld in Node.js bewijst geen compatibiliteit met een bepaalde browser.

Voorbeelden

const item = Object.create({ inherited: true });
item.name = "Ada";
item[10] = "ten";
item[2] = "two";
Object.defineProperty(item, "hidden", { value: true });
item[Symbol("tag")] = true;

console.log(JSON.stringify(Object.keys(item)));

Resultaat

["2","10","name"]

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