База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.hasOwn: проверка за собствено свойство

Object.hasOwn връща true, когато ключът е собствено свойство на обекта, независимо от стойността и enumerable атрибута.

Версия: ECMAScript 2022 onward; example target: Node.js 24.22.2

Синтаксис

Object.hasOwn(obj, prop)

Object.hasOwn(obj, prop) първо изпълнява ToObject(obj) и преобразува prop с ToPropertyKey, затова работят string и Symbol ключове. Boolean показва дали descriptor принадлежи директно на обекта. Наследените свойства се пропускат и съществуваща стойност undefined не се бърка с липса на свойство.

Тестът обхваща data и accessor свойства, включително non-enumerable. При обикновен обект не чете стойността и не извиква getter. По-безопасен е от obj.hasOwnProperty(prop) за обект с null прототип или скрит hasOwnProperty. in и Reflect.has търсят и по веригата от прототипи.

Методът съществува от ECMAScript 2022. null и undefined хвърлят TypeError; другите примитиви се опаковат, затова индекс 1 в "abc" може да е собствен. Преобразуването на ключ може да изпълни код и да хвърли. При Proxy се изпълнява trap getOwnPropertyDescriptor; изключение или нарушение на invariants може да даде TypeError.

Примери

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

Резултат

true false
true false
true
TypeError

Примерът различава собствени, наследени, Symbol, липсващи и индексни свойства на опакован string.

Източници