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

CKTIS / JavaScript

Object.getPrototypeOf: protótipo imediato de um valor

Object.getPrototypeOf devolve o protótipo imediato atual de um objeto, ou null para um objeto sem protótipo.

Versão: ECMAScript 5 onward; primitive coercion since ECMAScript 2015; example target: Node.js 24.22.2

Sintaxe

Object.getPrototypeOf(obj)

Object.getPrototypeOf(obj) executa ToObject e invoca o método interno [[GetPrototypeOf]]. Para um objeto devolve a referência ao protótipo imediato ou null; não percorre toda a cadeia nem copia o protótipo. Desde ECMAScript 2015, primitivas exceto null e undefined são encapsuladas, logo um texto aponta para String.prototype.

Serve para inspecionar herança, reconhecer dicionários Object.create(null) ou examinar objetos criados por classes. A referência descreve o estado no momento da chamada; um Object.setPrototypeOf posterior pode alterar o próximo resultado. Não lê propriedades normais nem invoca os seus getters.

O método existe desde ECMAScript 5, em que argumentos primitivos lançavam TypeError. null e undefined continuam a lançá-lo. Um Proxy pode executar a trap getPrototypeOf; esta tem de devolver objeto ou null e, num alvo não extensível, o protótipo real do alvo, senão é lançado TypeError.

Exemplos

const proto = { kind: "record" };
const value = Object.create(proto);
const root = Object.create(null);

console.log(Object.getPrototypeOf(value) === proto, Object.getPrototypeOf(root));
console.log(Object.getPrototypeOf("x") === String.prototype);

const fixed = Object.preventExtensions({});
const proxy = new Proxy(fixed, { getPrototypeOf() { return null; } });
try { Object.getPrototypeOf(proxy); } catch (error) { console.log(error.name); }
try { Object.getPrototypeOf(null); } catch (error) { console.log(error.name); }

Resultado

true null
true
TypeError
TypeError

O exemplo lê um protótipo normal e um nulo, mostra encapsulamento de texto e dois casos TypeError.

Fontes