Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Object.hasOwn: verificare una proprietà propria

Object.hasOwn restituisce true se una chiave è una proprietà propria dell’oggetto, indipendentemente da valore ed enumerabilità.

Versione: ECMAScript 2022 onward; example target: Node.js 24.22.2

Sintassi

Object.hasOwn(obj, prop)

Object.hasOwn(obj, prop) esegue prima ToObject(obj) e converte prop con ToPropertyKey, quindi accetta chiavi stringa e Symbol. Il booleano indica se il descrittore appartiene direttamente all’oggetto. Ignora le proprietà ereditate e non confonde un valore undefined esistente con una proprietà assente.

Il test copre proprietà dati e accessor, anche non enumerabili. Su un oggetto ordinario non legge il valore né invoca il getter. È più sicuro di obj.hasOwnProperty(prop) per oggetti con prototipo nullo o che nascondono hasOwnProperty. in e Reflect.has cercano invece nella catena dei prototipi.

Il metodo esiste da ECMAScript 2022. null e undefined generano TypeError; le altre primitive sono boxed, quindi l’indice 1 di "abc" può essere proprio. La conversione della chiave può eseguire codice e generare eccezioni. Per un Proxy si esegue la trap getOwnPropertyDescriptor; eccezioni o violazioni degli invarianti possono produrre TypeError.

Esempi

const token = Symbol("token");
const proto = { inherited: 1 };
const record = Object.create(proto);
Object.defineProperty(record, "hidden", { value: 2 });
record[token] = undefined;

console.log(Object.hasOwn(record, "hidden"), Object.hasOwn(record, "inherited"));
console.log(Object.hasOwn(record, token), Object.hasOwn(record, "missing"));
console.log(Object.hasOwn("abc", 1));
try { Object.hasOwn(null, "x"); } catch (error) { console.log(error.name); }

Risultato

true false
true false
true
TypeError

L’esempio distingue proprietà proprie, ereditate, Symbol, assenti e indice di una stringa boxed.

Fonti