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

CKTIS / JavaScript

Reflect.getPrototypeOf — ler o protótipo de um objeto

Reflect.getPrototypeOf(target) devolve o protótipo imediato de um objeto ou null. Exige um objeto: os valores primitivos causam um TypeError, em vez de serem convertidos em objetos de encapsulamento, como acontece com Object.getPrototypeOf.

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

Reflect.getPrototypeOf(target)

Reflect.getPrototypeOf(target) chama o método interno [[GetPrototypeOf]] do argumento. Para um objeto comum, lê o seu protótipo imediato sem percorrer toda a cadeia. O resultado é um objeto ou null, que significa que não existe protótipo. Não se trata de ler a propriedade .prototype que as funções podem ter.

O argumento target tem de ser um objeto; as funções também são objetos. Qualquer valor primitivo, incluindo null e undefined, causa um TypeError. Omitir o argumento também causa um TypeError, porque o seu valor passa a ser undefined.

Para objetos, Object.getPrototypeOf(target) utiliza a mesma operação interna. A diferença diz respeito aos valores primitivos: Object.getPrototypeOf converte-os em objetos de encapsulamento, mas rejeita null e undefined. Assim, Object.getPrototypeOf("abc") devolve String.prototype, enquanto Reflect.getPrototypeOf("abc") lança uma exceção.

No caso de um Proxy, a leitura pode invocar a armadilha getPrototypeOf, pelo que não é necessariamente isenta de efeitos secundários. A armadilha tem de devolver um objeto ou null; para um objeto-alvo não extensível, o resultado tem de corresponder ao seu protótipo real. A violação destas regras ou a utilização de um proxy revogado causa um TypeError; as exceções da armadilha são propagadas.

Exemplos

const proto = { role: "base" };
const item = Object.create(proto);

console.log(Reflect.getPrototypeOf(item) === proto);
console.log(Reflect.getPrototypeOf(Object.create(null)) === null);
console.log(Object.getPrototypeOf("abc") === String.prototype);

try {
  Reflect.getPrototypeOf("abc");
} catch (error) {
  console.log(error instanceof TypeError);
}

Resultado

true
true
true
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