KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

in-operator — controleren of een eigenschap bestaat

De `in`-operator controleert of een eigenschap met een bepaalde sleutel aanwezig is, niet welke waarde die heeft. Als het object en alle objecten in de prototypeketen gewone objecten zijn, telt de operator eigen en overgeërfde eigenschappen mee. De `has`-trap van een `Proxy` kan het resultaat veranderen. De rechteroperand moet een object zijn; een primitieve waarde veroorzaakt een `TypeError`.

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

propertyKey in object
#privateName in object

Als het object en alle objecten in de prototypeketen gewone objecten zijn, geeft propertyKey in object true terug voor een eigen of overgeërfde eigenschap, en anders false. De linkeroperand wordt omgezet in een eigenschapssleutel: een string of Symbol. De rechteroperand moet een object zijn; ook null, undefined en primitieve strings veroorzaken een TypeError.

De has-trap van een Proxy kan de controle op de eigenschapssleutel onderscheppen, ook tijdens het doorzoeken van de prototypeketen. De trap kan bijvoorbeeld aangeven dat een sleutel aanwezig is terwijl die op het doelobject en zijn prototypes ontbreekt, of een bestaande configureerbare eigen eigenschap van een uitbreidbaar doelobject verbergen.

Bestaan betekent niet dat de waarde iets anders dan undefined is: een eigenschap met die waarde bestaat nog steeds. Gebruik Object.hasOwn(object, propertyKey) om alleen eigen eigenschappen te controleren. De in-operator omvat ook niet-enumerabele eigenschappen; het is geen for...in-lus.

Bij arrays controleert in indexsleutels, niet of een waarde voorkomt. Een gat dat door delete is ontstaan, is geen eigen element, ook niet als de index kleiner is dan length. Als geen Proxy de controle onderschept en de zoekactie de sleutel ook niet in de prototypeketen vindt, is het resultaat false.

De afzonderlijke syntaxis #privateName in object controleert of een specifiek privé-element aanwezig is, niet of er een eigenschap met een string als sleutel bestaat. De privénaam moet in een omvattende klassenscope zijn gedeclareerd; de rechteroperand moet nog steeds een object zijn.

Voorbeelden

const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;

console.log("own" in item);
console.log("inherited" in item);
console.log("missing" in item);
console.log(Object.hasOwn(item, "inherited"));

const values = [undefined];
console.log(0 in values);
delete values[0];
console.log(0 in values);

Resultaat

true
true
false
false
true
false

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