Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes