Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Object.hasOwn: preverjanje lastne lastnosti

Object.hasOwn vrne true, kadar je ključ lastna lastnost objekta, ne glede na njeno vrednost ali naštevnost.

Različica: ECMAScript 2022 onward; example target: Node.js 24.22.2

Sintaksa

Object.hasOwn(obj, prop)

Object.hasOwn(obj, prop) najprej izvede ToObject(obj) in pretvori prop z ToPropertyKey, zato delujejo nizovni in Symbol ključi. Boolean pove, ali deskriptor pripada neposredno objektu. Podedovane lastnosti prezre in obstoječe vrednosti undefined ne zamenja z manjkajočo lastnostjo.

Test zajema podatkovne lastnosti in accessorje, tudi nenaštevne. Pri navadnem objektu vrednosti ne bere in getterja ne kliče. Varnejši je od obj.hasOwnProperty(prop) za objekt z ničelnim prototipom ali prekrito metodo hasOwnProperty. in in Reflect.has pa prehodita verigo prototipov.

Metoda obstaja od ECMAScript 2022. null in undefined sprožita TypeError; druge primitivne vrednosti se ovijejo, zato je indeks 1 v "abc" lahko lasten. Pretvorba ključa lahko izvede kodo in sproži izjemo. Pri Proxy se izvede past getOwnPropertyDescriptor; izjema ali kršitev invariant lahko povzroči TypeError.

Primeri

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

Rezultat

true false
true false
true
TypeError

Primer razlikuje lastne, podedovane, Symbol, manjkajoče in indeksne lastnosti ovitega niza.

Viri