CKTIS / JavaScript
Reflect.construct — een constructor aanroepen met een argumentenlijst
Reflect.construct roept een constructor aan met argumenten die uit een object worden gelezen. Met de optionele newTarget kun je de uitgevoerde constructor scheiden van de waarde van new.target en de gebruikelijke keuze van het prototype.
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.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) voert een constructie uit en geen gewone functieaanroep. Het werkt ook met klassen. In tegenstelling tot Reflect.apply accepteert het geen bestaande this.
argumentsList moet een object zijn. Reflect.construct leest de eigenschap length van dat object om te bepalen welke geïndexeerde eigenschappen het moet lezen. Als length ontbreekt, wordt de lengte als 0 behandeld. Als target een constructor is, roept Reflect.construct(target, {}) die dus zonder argumenten aan. De spread-syntaxis in new target(...argumentsList) haalt de argumenten daarentegen uit de iterator. Een array met een aangepaste iterator kan bij de twee aanroepen dus verschillende argumenten aan dezelfde constructor doorgeven. Alleen itereerbaar zijn is niet voldoende; een Set levert zijn elementen niet aan Reflect.construct. Zowel target als een opgegeven newTarget moeten constructors zijn — pijlfuncties zijn dat niet. Ongeldige argumenten veroorzaken een TypeError; uitzonderingen uit de constructor worden doorgegeven.
Als newTarget wordt weggelaten, is de standaardwaarde target; expliciet undefined meegeven veroorzaakt een TypeError. Reflect.construct geeft newTarget door aan de interne [[Construct]]-operatie van target. Als target een gewone constructorfunctie is, heeft new.target in de functiebody de waarde newTarget. Als target daarentegen een Proxy is, kan de construct-trap newTarget negeren en de onderliggende constructor aanroepen met een andere waarde voor new.target. Bij het normaal aanmaken van een object komt het prototype van newTarget.prototype, als die waarde een object is. Dit voert de body van newTarget niet uit. Als target expliciet een object teruggeeft, kan dat object de aangemaakte instantie vervangen.
In het voorbeeld stelt Person de velden in, maar komt het prototype van Alternate. Het resultaat is daarom geen instantie van Person. Dit is een voorziening van de ECMAScript-taal en geen Web-API; de beschikbaarheid in specifieke browsers moet afzonderlijk worden gecontroleerd.
Voorbeelden
function Person(name) {
this.name = name;
this.usedAlternate = new.target === Alternate;
}
function Alternate() {
throw new Error("Must not run");
}
const person = Reflect.construct(Person, ["Ada"], Alternate);
console.log(person.name);
console.log(person.usedAlternate);
console.log(Object.getPrototypeOf(person) === Alternate.prototype);
console.log(person instanceof Person);Resultaat
Ada true true false
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.