CKTIS / JavaScript
Reflect.setPrototypeOf — impostare il prototipo di un oggetto
Reflect.setPrototypeOf(target, proto) prova a impostare il prototipo di un oggetto e restituisce un valore booleano. Distingue un cambiamento rifiutato da argomenti non validi, che causano TypeError.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
Reflect.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) invoca l’operazione interna [[SetPrototypeOf]] dell’oggetto target. Il prototipo viene usato per cercare le proprietà ereditate; il metodo non le copia nell’oggetto. proto deve essere un oggetto oppure null, che indica l’assenza di un prototipo. Non si tratta di modificare la proprietà .prototype di una funzione.
Il risultato true indica il successo, anche quando il prototipo richiesto è già impostato. Il risultato false indica un rifiuto. Per un oggetto ordinario, il passaggio a un prototipo diverso dopo Object.preventExtensions(target) restituisce false. Impostare di nuovo lo stesso prototipo resta consentito anche per un oggetto non estensibile. Durante il controllo dei cicli per un oggetto ordinario, l’operazione restituisce false se, percorrendo la catena a partire da proto, raggiunge target. Il controllo si ferma però quando incontra un oggetto che non usa il metodo interno ordinario [[GetPrototypeOf]]. Un Proxy nella catena può quindi consentire la formazione di un ciclo anche quando target è un oggetto ordinario.
Un risultato booleano non garantisce l’assenza di eccezioni: un target primitivo o un proto non valido causano TypeError. Gli errori dell’operazione interna, compresi quelli di una trap Proxy, vengono propagati. Al contrario, se target è un oggetto, Object.setPrototypeOf restituisce l’oggetto in caso di successo e genera TypeError quando l’operazione interna restituisce false.
L’esempio mostra l’ereditarietà senza copiare e la differenza tra mantenere e modificare il prototipo dopo aver impedito le estensioni. La specifica del linguaggio non è una tabella di compatibilità dei browser; usare Node 24 in un repository non dimostra il supporto nei browser.
Esempi
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);Risultato
true shared false true false true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.