CKTIS / JavaScript
Object.setPrototypeOf — het prototype van een object wijzigen
Bij een gewoon object stelt een geslaagde aanroep van `Object.setPrototypeOf(obj, proto)` het interne prototype in zonder eigenschappen te kopiëren en geeft die hetzelfde object terug. `proto` moet een object of `null` zijn. Bij een `Proxy` met een uitbreidbaar doelobject kan de `setPrototypeOf`-trap succes melden zonder het prototype van het doelobject te wijzigen. De aanroep geeft nog steeds de oorspronkelijke `Proxy` terug.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Object.setPrototypeOf(obj, proto)Bij een gewoon object stelt een geslaagde aanroep van Object.setPrototypeOf(obj, proto) het interne [[Prototype]] van obj in op proto. Overgeërfde eigenschappen worden in de prototypeketen opgezocht in plaats van naar het object gekopieerd. Bij een gewoon object zoals in het voorbeeld blijven de eigen eigenschappen ongewijzigd. Als obj een Proxy met een uitbreidbaar doelobject is, kan de setPrototypeOf-trap succes melden zonder het prototype van het doelobject te wijzigen. De aanroep geeft nog steeds de oorspronkelijke Proxy terug. De trap kan tijdens een geslaagde aanroep ook de eigen eigenschappen van het doelobject wijzigen. Een aanroep van Object.setPrototypeOf is geen toewijzing aan de .prototype-eigenschap van een functie.
proto moet een object of null zijn; elke andere waarde veroorzaakt een TypeError. Ook null of undefined als obj veroorzaakt een TypeError. Andere primitieve waarden worden ongewijzigd teruggegeven, maar pas nadat proto is gecontroleerd. Bij een object geeft een geslaagde aanroep precies obj terug.
Wordt bij het wijzigen van het prototype van een gewoon object een cyclus gedetecteerd, dan volgt een TypeError. De controle stopt echter bij een prototype dat niet de gewone implementatie van de interne methode [[GetPrototypeOf]] gebruikt, zoals een Proxy. Een cyclus die via die Proxy loopt, kan daardoor onopgemerkt blijven zonder een TypeError te veroorzaken. Een poging om het prototype van een niet-uitbreidbaar gewoon object te wijzigen veroorzaakt een TypeError. Bij een gewoon object mag je het huidige prototype opnieuw instellen, ook als het object niet uitbreidbaar is. Bij een Proxy met een niet-uitbreidbaar doelobject kan de setPrototypeOf-trap de bewerking daarentegen weigeren, zelfs als het gevraagde prototype het huidige prototype van het doelobject is. Geeft de trap false terug, dan gooit Object.setPrototypeOf een TypeError. Sommige objecten, waaronder Object.prototype, hebben een onveranderlijk prototype.
Als het prototype van een object wordt gewijzigd in null, wordt de eerdere overervingsketen verbroken; het object kan daardoor de toegang tot overgeërfde methoden verliezen. Als het prototype bekend is wanneer je het object maakt, kun je Object.create(proto) overwegen in plaats van het later te wijzigen. In het voorbeeld wordt role overgeërfd, terwijl name een eigen eigenschap blijft.
Voorbeelden
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);Resultaat
true true reader name true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.