KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Reflect.ownKeys — alle eigen property-sleutels

Reflect.ownKeys(target) vereist een object. Voor een gewoon object retourneert de methode een array met alle eigen sleutels: strings en symbolen, ook die van niet-enumerable properties. Overgeërfde properties worden uitgesloten. De ownKeys-trap van een Proxy kan bepalen dat andere sleutels worden geretourneerd.

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

Reflect.ownKeys(target)

Reflect.ownKeys(target) maakt een nieuwe array met sleutels. Als target een gewoon object is, bevat de array de sleutels van alle eigen properties, zowel enumerable als niet-enumerable. De elementen zijn strings of symbolen, niet de propertywaarden. De prototypeketen wordt niet doorzocht. Een argument dat geen object is, waaronder null of een string, veroorzaakt een TypeError; het wordt niet automatisch omgezet in een object.

Bij gewone objecten komen sleutels die array-indexen zijn eerst, in oplopende numerieke volgorde. Daarna volgen andere strings in de volgorde waarin de properties zijn aangemaakt, en ten slotte symbolen in de aanmaakvolgorde van de bijbehorende properties. Daarom staat "2" vóór "10", zelfs als ze in omgekeerde volgorde zijn toegevoegd; de sleutels zelf blijven strings.

Object.keys retourneert daarentegen alleen enumerable stringsleutels. Object.getOwnPropertyNames omvat eigen stringsleutels, terwijl Object.getOwnPropertySymbols eigen symbolen omvat. Gebruik Reflect.ownKeys als je beide soorten sleutels nodig hebt zonder op enumerability te filteren.

De methode roept de interne operatie [[OwnPropertyKeys]] aan. Bij een Proxy kan hierdoor de ownKeys-trap worden geactiveerd. Er kan dus gebruikerscode worden uitgevoerd, een uitzondering worden gegenereerd of de sleutels kunnen worden geretourneerd in een andere toegestane volgorde dan bij een gewoon object. De trap kan ook wijzigen welke sleutels worden geretourneerd: als het doelobject van de proxy uitbreidbaar is, mag de trap sleutels van configureerbare eigen properties weglaten of extra sleutels opgeven waarvoor het doelobject geen descriptor voor een eigen property heeft. Sleutels van niet-configureerbare eigen properties moeten worden opgenomen. Als het doelobject niet uitbreidbaar is, moet de geretourneerde verzameling sleutels exact overeenkomen met zijn eigen sleutels. Ga er niet van uit dat elk exotisch object de gewone volgorde gebruikt. Dit is een ECMAScript-taal-API; alleen de aanwezigheid van Node 24 in een repository bewijst niet dat de doelbrowser dit ondersteunt.

Voorbeelden

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

const keys = Reflect.ownKeys(target);
console.log(keys.map(key => String(key)).join(" | "));
console.log(keys[keys.length - 1] === tag);

Resultaat

2 | 10 | name | hidden | Symbol(tag)
true

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