CKTIS / JavaScript
Object.hasOwn: testar uma propriedade própria
Object.hasOwn devolve true quando uma chave é propriedade própria do objeto, independentemente do valor e de ser enumerável.
Versão: ECMAScript 2022 onward; example target: Node.js 24.22.2
Sintaxe
Object.hasOwn(obj, prop)Object.hasOwn(obj, prop) primeiro executa ToObject(obj) e converte prop com ToPropertyKey, aceitando chaves de texto e Symbol. O booleano indica se o descritor pertence diretamente ao objeto. Ignora propriedades herdadas e não confunde um valor undefined existente com uma propriedade ausente.
O teste cobre propriedades de dados e accessors, incluindo não enumeráveis. Num objeto normal não lê o valor nem invoca o getter. É mais seguro que obj.hasOwnProperty(prop) quando o objeto tem protótipo nulo ou esconde hasOwnProperty. in e Reflect.has respondem a outra questão, pois percorrem a cadeia de protótipos.
O método existe desde ECMAScript 2022. null e undefined causam TypeError; outras primitivas são encapsuladas, logo o índice 1 de "abc" pode ser próprio. Converter a chave pode executar código e lançar. Num Proxy é executada a trap getOwnPropertyDescriptor; a sua exceção ou violação de invariantes pode produzir TypeError.
Exemplos
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); }Resultado
true false true false true TypeError
O exemplo distingue propriedades próprias, herdadas, Symbol, ausentes e índice de texto encapsulado.