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

CKTIS / JavaScript

Reflect.setPrototypeOf — definir o protótipo de um objeto

Reflect.setPrototypeOf(target, proto) tenta definir o protótipo de um objeto e devolve um valor booleano. Distingue uma alteração recusada de argumentos inválidos, que provocam TypeError.

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.setPrototypeOf(target, proto)

Reflect.setPrototypeOf(target, proto) invoca a operação interna [[SetPrototypeOf]] do objeto target. O protótipo é utilizado para procurar propriedades herdadas; o método não as copia para o objeto. proto tem de ser um objeto ou null, que significa que não existe protótipo. Isto não altera a propriedade .prototype de uma função.

O resultado true indica sucesso, mesmo quando o protótipo pedido já está definido. O resultado false indica uma recusa. Num objeto comum, a mudança para outro protótipo depois de Object.preventExtensions(target) devolve false. Voltar a definir o mesmo protótipo continua a ser permitido, mesmo num objeto não extensível. Ao verificar se se formaria um ciclo num objeto comum, a operação devolve false se, ao percorrer a cadeia a partir de proto, chegar a target. Contudo, a verificação para assim que encontra um objeto que não usa o método interno comum [[GetPrototypeOf]]. Por isso, um Proxy na cadeia pode permitir a formação de um ciclo, mesmo quando target é um objeto comum.

Um resultado booleano não garante a ausência de exceções: um target primitivo ou um proto inválido provoca TypeError. Os erros da operação interna, incluindo os de uma armadilha Proxy, são propagados. Em contrapartida, quando target é um objeto, Object.setPrototypeOf devolve o objeto em caso de sucesso e lança TypeError quando a operação interna devolve false.

O exemplo demonstra a herança sem cópia e a diferença entre manter e alterar o protótipo depois de impedir extensões. A especificação da linguagem não é uma tabela de compatibilidade dos browsers; utilizar Node 24 num repositório não comprova o suporte nos browsers.

Exemplos

const proto = { label: "shared" };
const item = {};

console.log(Reflect.setPrototypeOf(item, proto));
console.log(item.label);
console.log(Object.hasOwn(item, "label"));

Object.preventExtensions(item);
console.log(Reflect.setPrototypeOf(item, proto));
console.log(Reflect.setPrototypeOf(item, null));
console.log(Object.getPrototypeOf(item) === proto);

Resultado

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