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.