Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect.has — verificare se una proprietà esiste

`Reflect.has(target, propertyKey)` restituisce un valore booleano. Se l’oggetto e tutti i suoi prototipi sono oggetti ordinari, distingue una proprietà mancante da una proprietà propria o ereditata che esiste, anche se il suo valore è `undefined`. La trappola `has` di un `Proxy` può cambiare il risultato.

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

Reflect.has(target, propertyKey)

Reflect.has(target, propertyKey) verifica l’esistenza di una proprietà, non il suo valore. Se l’oggetto e tutti i suoi prototipi sono oggetti ordinari, cerca nell’oggetto e nella sua catena di prototipi e restituisce true o false. Una proprietà il cui valore è undefined esiste comunque; la sua enumerabilità non ha importanza.

È la forma funzionale di propertyKey in target. Se vuoi verificare solo le proprietà proprie, usa Object.hasOwn(target, propertyKey): a differenza di Reflect.has, esclude le proprietà ereditate.

target deve essere un oggetto; un valore primitivo, incluso null o undefined, causa un TypeError. propertyKey viene convertito in una chiave di proprietà: una stringa o un simbolo. Per esempio, il numero 0 indica la chiave "0". Gli errori di conversione vengono propagati al chiamante.

Il metodo richiama l’operazione interna [[HasProperty]]. Se la ricerca incontra un Proxy, può attivare la sua trappola has. La trappola può cambiare il risultato booleano: può segnalare come presente una proprietà assente oppure nascondere una proprietà propria configurabile presente su un oggetto bersaglio estensibile. Il controllo può anche avere effetti collaterali o generare un’eccezione. Nell’esempio, own esiste nonostante il valore undefined, mentre inherited viene trovato solo con il controllo che considera il prototipo.

Esempi

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

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

Risultato

true
true
false
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