Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje