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.