CKTIS / JavaScript
Object.setPrototypeOf — modificare il prototipo di un oggetto
Per un oggetto ordinario, una chiamata riuscita a `Object.setPrototypeOf(obj, proto)` imposta il prototipo interno senza copiare proprietà e restituisce lo stesso oggetto. `proto` deve essere un oggetto o `null`. Se un `Proxy` ha un oggetto bersaglio estensibile, la sua trap `setPrototypeOf` può segnalare che l’operazione è riuscita senza modificare il prototipo del bersaglio. La chiamata restituisce comunque il `Proxy` originale.
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
Object.setPrototypeOf(obj, proto)Per un oggetto ordinario, una chiamata riuscita a Object.setPrototypeOf(obj, proto) imposta il [[Prototype]] interno di obj al valore proto. Le proprietà ereditate vengono cercate nella catena dei prototipi, invece di essere copiate nell’oggetto. Per un oggetto ordinario come quello dell’esempio, le proprietà proprie restano invariate. Se obj è un Proxy con un oggetto bersaglio estensibile, la sua trap setPrototypeOf può segnalare che l’operazione è riuscita senza modificare il prototipo del bersaglio. La chiamata restituisce comunque il Proxy originale. La trap può anche modificare le proprietà proprie del bersaglio durante una chiamata che va a buon fine. Una chiamata a Object.setPrototypeOf non è un’assegnazione alla proprietà .prototype di una funzione.
proto deve essere un oggetto o null; qualsiasi altro valore causa un TypeError. Anche passare null o undefined come obj causa un TypeError. Gli altri valori primitivi vengono restituiti senza modifiche, ma solo dopo la convalida di proto. Per un oggetto, una chiamata riuscita restituisce esattamente obj.
Quando si modifica il prototipo di un oggetto ordinario, il rilevamento di un ciclo causa un TypeError. Il controllo si ferma però quando incontra un prototipo che non usa l’implementazione ordinaria del metodo interno [[GetPrototypeOf]], come un Proxy. Un ciclo che passa per quel Proxy può quindi non essere rilevato e non causare un TypeError. Tentare di modificare il prototipo di un oggetto ordinario non estensibile causa un TypeError. Per un oggetto ordinario, è possibile impostare di nuovo il prototipo attuale anche se l’oggetto non è estensibile. Se invece un Proxy ha un oggetto bersaglio non estensibile, la sua trap setPrototypeOf può rifiutare l’operazione anche se il prototipo richiesto è quello attuale del bersaglio. Se la trap restituisce false, Object.setPrototypeOf genera un TypeError. Alcuni oggetti, tra cui Object.prototype, hanno un prototipo immutabile.
Quando il prototipo di un oggetto viene sostituito con null, la precedente catena di ereditarietà si interrompe; l’oggetto potrebbe quindi perdere l’accesso ai metodi ereditati. Se il prototipo è noto quando si crea l’oggetto, valuta Object.create(proto) invece di modificarlo in seguito. Nell’esempio, role è ereditato, mentre name rimane una proprietà propria.
Esempi
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);Risultato
true true reader name 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.