CKTIS / JavaScript
Object.hasOwn: test vlastní vlastnosti
Object.hasOwn vrací true, když je klíč vlastní vlastností objektu, bez ohledu na její hodnotu a vyčíslitelnost.
Verze: ECMAScript 2022 onward; example target: Node.js 24.22.2
Syntaxe
Object.hasOwn(obj, prop)Object.hasOwn(obj, prop) nejprve provede ToObject(obj) a převede prop přes ToPropertyKey, takže fungují řetězcové i Symbol klíče. Boolean říká, zda deskriptor patří přímo objektu. Zděděné vlastnosti ignoruje a existující hodnotu undefined nezamění za chybějící vlastnost.
Test zahrnuje datové vlastnosti i accessory, také nevyčíslitelné. U běžného objektu hodnotu nečte ani nevolá getter. Je bezpečnější než obj.hasOwnProperty(prop) pro objekt s nulovým prototypem či překrytou metodou hasOwnProperty. in a Reflect.has naopak procházejí řetězec prototypů.
Metoda existuje od ECMAScript 2022. null a undefined vyvolají TypeError; ostatní primitivní hodnoty se zabalí, takže index 1 v "abc" může být vlastní. Převod klíče může spustit kód a vyhodit výjimku. U Proxy běží past getOwnPropertyDescriptor; výjimka nebo porušení invariantů může dát TypeError.
Příklady
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); }Výsledek
true false true false true TypeError
Příklad rozlišuje vlastní, zděděné, Symbol, chybějící a indexové vlastnosti zabaleného řetězce.