Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.hasOwn: test vlastnej vlastnosti

Object.hasOwn vracia true, keď je kľúč vlastnou vlastnosťou objektu, bez ohľadu na jej hodnotu a vyčísliteľnosť.

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

Syntax

Object.hasOwn(obj, prop)

Object.hasOwn(obj, prop) najprv vykoná ToObject(obj) a prevedie prop cez ToPropertyKey, takže fungujú reťazcové aj Symbol kľúče. Boolean hovorí, či deskriptor patrí priamo objektu. Zdedené vlastnosti ignoruje a existujúcu hodnotu undefined nezamení za chýbajúcu vlastnosť.

Test zahŕňa dátové vlastnosti aj accessory, tiež nevyčísliteľné. Pri bežnom objekte hodnotu nečíta ani nevolá getter. Je bezpečnejší než obj.hasOwnProperty(prop) pre objekt s nulovým prototypom či prekrytou metódou hasOwnProperty. in a Reflect.has naopak prechádzajú reťazec prototypov.

Metóda existuje od ECMAScript 2022. null a undefined vyvolajú TypeError; ostatné primitívne hodnoty sa zabalia, takže index 1 v "abc" môže byť vlastný. Prevod kľúča môže spustiť kód a vyhodiť výnimku. Pri Proxy beží pasca getOwnPropertyDescriptor; výnimka alebo porušenie invariantov môže dať TypeError.

Prí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ýsledok

true false
true false
true
TypeError

Príklad rozlišuje vlastné, zdedené, Symbol, chýbajúce a indexové vlastnosti zabaleného reťazca.

Zdroje