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 objectSe 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.