CKTIS / JavaScript
Reflect.setPrototypeOf — het prototype van een object instellen
Reflect.setPrototypeOf(target, proto) probeert het prototype van een object in te stellen en geeft een booleaanse waarde terug. Zo is een geweigerde wijziging te onderscheiden van ongeldige argumenten, die een TypeError veroorzaken.
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
Reflect.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) roept de interne bewerking [[SetPrototypeOf]] van het object target aan. Het prototype wordt gebruikt om overgeërfde eigenschappen op te zoeken; de methode kopieert ze niet naar het object. proto moet een object of null zijn, wat betekent dat er geen prototype is. Dit verandert niet de eigenschap .prototype van een functie.
Het resultaat true betekent dat de bewerking is geslaagd, ook als het opgegeven prototype al is ingesteld. Het resultaat false betekent dat de wijziging is geweigerd. Bij een gewoon object geeft een wijziging naar een ander prototype na Object.preventExtensions(target) false terug. Hetzelfde prototype opnieuw instellen blijft ook bij een niet-uitbreidbaar object toegestaan. Bij de controle op een cyclus voor een gewoon object geeft de bewerking false terug als ze bij het doorlopen van de keten vanaf proto het object target bereikt. De controle stopt echter zodra ze een object tegenkomt dat niet de gewone interne methode [[GetPrototypeOf]] gebruikt. Een Proxy in de keten kan dus een cyclus mogelijk maken, zelfs als target een gewoon object is.
Een booleaans resultaat garandeert niet dat er geen uitzonderingen optreden: een primitieve target of een ongeldige proto veroorzaakt een TypeError. Fouten van de interne bewerking, waaronder fouten van een Proxy-trap, worden doorgegeven. Daarentegen geeft Object.setPrototypeOf bij een object als target het object terug wanneer de bewerking slaagt, en veroorzaakt het een TypeError wanneer de interne bewerking false teruggeeft.
Het voorbeeld laat overerving zonder kopiëren zien en het verschil tussen het behouden en wijzigen van het prototype nadat uitbreidingen zijn voorkomen. De taalspecificatie is geen browsercompatibiliteitstabel; het gebruik van Node 24 in een repository bewijst geen ondersteuning in browsers.
Voorbeelden
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);Resultaat
true shared false true false 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.