CKTIS / JavaScript
Reflect.construct — klic konstruktorja s seznamom argumentov
Reflect.construct pokliče konstruktor z argumenti, prebranimi iz objekta. Izbirni newTarget omogoča ločiti konstruktor, ki se izvede, od vrednosti new.target in običajne izbire prototipa.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) izvede konstrukcijo, ne običajnega klica funkcije. Deluje tudi z razredi. Za razliko od Reflect.apply ne sprejme že obstoječega this.
argumentsList mora biti objekt. Reflect.construct prebere njegovo lastnost length in na tej podlagi določi, katere indeksirane lastnosti naj prebere. Če lastnosti length ni, se dolžina obravnava kot 0. Če je target konstruktor, ga Reflect.construct(target, {}) zato pokliče brez argumentov. Sintaksa razširjanja v new target(...argumentsList) pa argumente pridobi iz iteratorja. Polje z lastnim iteratorjem lahko zato pri teh dveh klicih istemu konstruktorju posreduje različne argumente. Zgolj to, da je objekt iterabilen, ne zadostuje; Set svojih elementov ne posreduje metodi Reflect.construct. Tako target kot navedeni newTarget morata biti konstruktorja — puščične funkcije niso konstruktorji. Neveljavni argumenti povzročijo TypeError; izjeme iz konstruktorja se posredujejo naprej.
Če newTarget izpustite, je njegova privzeta vrednost target; če izrecno podate undefined, pride do TypeError. Reflect.construct posreduje newTarget notranji operaciji [[Construct]] objekta target. Če je target navadna konstruktorska funkcija, ima new.target v njenem telesu vrednost newTarget. Če pa je target objekt Proxy, lahko njegova prestrezna metoda construct prezre newTarget in pokliče konstruktor, ki ga ovija, z drugo vrednostjo new.target. Pri običajnem ustvarjanju objekta njegov prototip izvira iz newTarget.prototype, če je ta vrednost objekt. To ne izvede telesa funkcije newTarget. Če target izrecno vrne objekt, lahko ta nadomesti ustvarjeni primerek.
V primeru Person nastavi polja, prototip pa izvira iz Alternate. Rezultat zato ni primerek Person. To je funkcionalnost jezika ECMAScript, ne spletni API; razpoložljivost v posameznih brskalnikih je treba preveriti ločeno.
Primeri
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);Rezultat
Ada true true false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.