Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Operatore in — verificare l’esistenza di una proprietà

L’operatore `in` verifica la presenza di una proprietà in base alla chiave, non al valore. Se l’oggetto e quelli nella sua catena dei prototipi sono ordinari, considera sia le proprietà proprie sia quelle ereditate. La trap `has` di un `Proxy` può modificare il risultato. L’operando destro deve essere un oggetto; un valore primitivo provoca un `TypeError`.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

propertyKey in object
#privateName in object

Se l’oggetto e tutti gli oggetti nella sua catena dei prototipi sono ordinari, propertyKey in object restituisce true per una proprietà propria o ereditata e false altrimenti. L’operando sinistro viene convertito in una chiave di proprietà: una stringa o un Symbol. L’operando destro deve essere un oggetto; anche null, undefined e le stringhe primitive provocano un TypeError.

La trap has di un Proxy può intercettare la verifica della chiave, anche durante la ricerca nella catena dei prototipi. Per esempio, può indicare come presente una chiave assente sia dall’oggetto bersaglio sia dai suoi prototipi, oppure nascondere una proprietà propria configurabile già presente su un oggetto bersaglio estensibile.

L’esistenza non significa che il valore sia diverso da undefined: una proprietà con quel valore esiste comunque. Per verificare solo le proprietà proprie, usa Object.hasOwn(object, propertyKey). L’operatore in include anche le proprietà non enumerabili; non è un ciclo for...in.

Negli array, in verifica le chiavi degli indici, non la presenza di un valore. Un buco lasciato da delete non è un elemento proprio, anche se il suo indice è minore di length. Se nessun Proxy intercetta la verifica e la ricerca non trova la chiave neanche nella catena dei prototipi, il risultato è false.

La sintassi distinta #privateName in object verifica la presenza di uno specifico elemento privato, non di una proprietà con una stringa come chiave. Il nome privato deve essere dichiarato nell’ambito di una classe che racchiude l’espressione; l’operando destro deve comunque essere un oggetto.

Esempi

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);

Risultato

true
true
false
false
true
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti