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

CKTIS / JavaScript

Object.getOwnPropertyDescriptors — descritores das propriedades próprias

Para um objeto comum, Object.getOwnPropertyDescriptors devolve os descritores de todas as suas propriedades próprias, incluindo as não enumeráveis e as que têm chaves Symbol. Permite inspecionar atributos ou copiar propriedades sem converter acessores em valores.

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.getOwnPropertyDescriptors(obj)

Object.getOwnPropertyDescriptors(obj) devolve um novo objeto comum. O método obtém de obj a lista de chaves das propriedades próprias e inclui, para cada chave da lista, o respetivo descritor se obj indicar que existe. Aceita chaves de tipo cadeia de caracteres e Symbol, incluindo as de propriedades não enumeráveis; exclui propriedades herdadas.

O descritor de uma propriedade de dados contém value, writable, enumerable e configurable. Um descritor de acessor contém get e set em vez de value e writable; uma função em falta é representada por undefined. A leitura dos descritores de um objeto comum não invoca os respetivos getters. No entanto, com um Proxy, podem ser executadas armadilhas e ocorrer exceções. O resultado também pode ficar incompleto sem que seja lançada uma exceção: a armadilha ownKeys pode omitir a chave de uma propriedade própria configurável de um objeto-alvo extensível, mesmo que o proxy continue a indicar um descritor de propriedade própria para essa chave. Nesse caso, o método deixa esse descritor de fora do resultado.

Para um objeto comum, o padrão Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) cria uma cópia superficial com o mesmo protótipo e os mesmos atributos das propriedades próprias. Ao contrário de Object.assign, preserva os acessores e as propriedades não enumeráveis. Os objetos aninhados continuam partilhados; não é uma técnica geral para clonar objetos que dependem de slots internos, como Map.

null e undefined provocam um TypeError; os restantes valores primitivos são convertidos em objetos de encapsulamento. O método pertence ao ECMAScript 2017, não às Web APIs. O suporte no navegador de destino tem de ser verificado separadamente — a disponibilidade no Node 24 não o comprova.

Exemplos

let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
  hidden: { value: 7, enumerable: false },
  doubled: {
    get() { reads += 1; return this.hidden * 2; },
    enumerable: true
  }
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);

Resultado

0
7 false
function
14 1
true

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