CKTIS / JavaScript
Object.setPrototypeOf — alterar o protótipo de um objeto
Num objeto comum, uma chamada bem-sucedida a `Object.setPrototypeOf(obj, proto)` define o protótipo interno sem copiar propriedades e devolve o mesmo objeto. `proto` tem de ser um objeto ou `null`. Se um `Proxy` tiver um objeto-alvo extensível, o seu intersetor `setPrototypeOf` pode indicar que a operação foi bem-sucedida sem alterar o protótipo do alvo. A chamada devolve, ainda assim, o `Proxy` original.
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.setPrototypeOf(obj, proto)Num objeto comum, uma chamada bem-sucedida a Object.setPrototypeOf(obj, proto) define o [[Prototype]] interno de obj com o valor proto. As propriedades herdadas são procuradas na cadeia de protótipos, em vez de serem copiadas para o objeto. Num objeto comum, como o do exemplo, as propriedades próprias permanecem inalteradas. Se obj for um Proxy com um objeto-alvo extensível, o seu intersetor setPrototypeOf pode indicar que a operação foi bem-sucedida sem alterar o protótipo do alvo. A chamada devolve, ainda assim, o Proxy original. O intersetor também pode alterar as propriedades próprias do alvo durante uma chamada bem-sucedida. Uma chamada a Object.setPrototypeOf não é uma atribuição à propriedade .prototype de uma função.
proto tem de ser um objeto ou null; qualquer outro valor causa um TypeError. Passar null ou undefined como obj também causa um TypeError. Os restantes valores primitivos são devolvidos sem alterações, mas só depois de proto ser validado. Para um objeto, uma chamada bem-sucedida devolve exatamente obj.
Ao alterar o protótipo de um objeto comum, a deteção de um ciclo causa um TypeError. No entanto, a verificação termina quando encontra um protótipo que não usa a implementação comum do método interno [[GetPrototypeOf]], como um Proxy. Um ciclo que passe por esse Proxy pode, por isso, não ser detetado nem causar um TypeError. Tentar alterar o protótipo de um objeto comum não extensível causa um TypeError. Num objeto comum, é possível voltar a definir o protótipo atual, mesmo que o objeto não seja extensível. Em contrapartida, se um Proxy tiver um objeto-alvo não extensível, o seu intersetor setPrototypeOf pode rejeitar a operação mesmo que o protótipo pedido seja o protótipo atual do alvo. Se o intersetor devolver false, Object.setPrototypeOf lança um TypeError. Alguns objetos, incluindo Object.prototype, têm um protótipo imutável.
Quando o protótipo de um objeto passa a ser null, a cadeia de herança anterior é interrompida; o objeto pode então perder o acesso a métodos herdados. Se o protótipo for conhecido ao criar o objeto, considere usar Object.create(proto) em vez de o alterar mais tarde. No exemplo, role é herdado, enquanto name permanece uma propriedade própria.
Exemplos
const proto = { role: "reader" };
const user = { name: "Ada" };
const result = Object.setPrototypeOf(user, proto);
console.log(result === user);
console.log(Object.getPrototypeOf(user) === proto);
console.log(user.role);
console.log(Object.getOwnPropertyNames(user).join(","));
Object.setPrototypeOf(user, null);
console.log(user.role === undefined);Resultado
true true reader name 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.