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

CKTIS / JavaScript

Object.prototype.hasOwnProperty() — verificar propriedades próprias

Object.prototype.hasOwnProperty() verifica se uma propriedade pertence diretamente a um objeto, em vez de pertencer ao respetivo protótipo. Aprende em que difere de `in` e como a chamar em segurança quando o método está substituído.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

obj.hasOwnProperty(prop)
Object.prototype.hasOwnProperty.call(obj, prop)

Object.prototype.hasOwnProperty devolve true quando o objeto tem a propriedade própria indicada e false quando a propriedade é herdada ou não existe. O argumento prop pode ser um nome do tipo string ou um símbolo. Um valor null ou undefined não significa que a propriedade esteja ausente.

O método inclui propriedades enumeráveis e não enumeráveis. O operador in também verifica a cadeia de protótipos, pelo que pode devolver true quando hasOwnProperty() devolve false.

A chamada obj.hasOwnProperty(prop) não é fiável se o objeto substituir esse método, e um objeto criado com Object.create(null) não o herda de todo. Usa Object.prototype.hasOwnProperty.call(obj, prop) para evitar ambos os problemas. Em código novo, prefere Object.hasOwn(obj, prop) se o ambiente de destino o suportar.

Exemplos

const obj = Object.create({ inherited: 1 });
obj.own = undefined;
obj.hasOwnProperty = false;

console.log(Object.prototype.hasOwnProperty.call(obj, "own"));
console.log(Object.prototype.hasOwnProperty.call(obj, "inherited"));
console.log("inherited" in obj);
console.log(Object.prototype.hasOwnProperty.call(obj, "missing"));

Resultado

true
false
true
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes