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.