Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri