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

CKTIS / JavaScript

Object.getOwnPropertyDescriptor — inspecionar uma propriedade própria

Object.getOwnPropertyDescriptor devolve uma descrição de uma propriedade própria do objeto: o seu valor ou os seus acessores, juntamente com as marcas dos seus atributos. Não percorre a cadeia de protótipos e devolve undefined se o objeto não tiver essa propriedade própria.

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

Object.getOwnPropertyDescriptor(obj, key)

Object.getOwnPropertyDescriptor(obj, key) lê o descritor de uma única propriedade própria, incluindo uma que não seja enumerável. Não procura nos protótipos. O resultado é um novo objeto descritor ou undefined se a propriedade não estiver diretamente em obj. Uma propriedade existente cujo valor seja undefined continua a ter um descritor.

Um descritor de propriedade de dados contém value, writable, enumerable e configurable. Um descritor de propriedade acessora contém get e set em vez de value e writable; um acessor em falta tem o valor undefined. Num objeto comum, ler o descritor não invoca o getter. writable determina se uma atribuição pode alterar o valor, enumerable se a propriedade é incluída numa enumeração e configurable se pode ser eliminada ou reconfigurada.

Alterar os campos do objeto devolvido não altera a propriedade original. Para aplicar um descritor, use Object.defineProperty, tendo em conta as restrições da propriedade existente. O descritor não é uma cópia profunda: um objeto guardado em value continua a ser a mesma referência.

key é convertido numa chave de propriedade: uma string ou um símbolo. Passar null ou undefined como obj provoca um TypeError; os outros valores primitivos são convertidos em objetos wrapper. Num Proxy, a operação pode invocar a trap getOwnPropertyDescriptor, pelo que pode ter efeitos secundários ou lançar uma exceção.

Exemplos

const obj = Object.create({ inherited: 1 });
Object.defineProperty(obj, "score", {
  value: 42,
  writable: false,
  enumerable: true,
  configurable: true
});

const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));

Resultado

42 false
true true
42
undefined

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