Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Reflect.construct — zavolání konstruktoru se seznamem argumentů

Reflect.construct zavolá konstruktor s argumenty načtenými z objektu. Volitelný newTarget umožňuje oddělit vykonávaný konstruktor od hodnoty new.target a obvyklého výběru prototypu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)

Reflect.construct(target, argumentsList) provádí konstrukci, nikoli běžné volání funkce. Funguje také s třídami. Na rozdíl od Reflect.apply nepřijímá již existující this.

argumentsList musí být objekt. Reflect.construct načte jeho vlastnost length a podle ní určí, které vlastnosti s číselnými indexy načíst. Pokud length chybí, délka se považuje za 0. Je-li tedy target konstruktor, Reflect.construct(target, {}) jej zavolá bez argumentů. Naproti tomu syntaxe rozbalení v new target(...argumentsList) získává argumenty z iterátoru. Pole s vlastním iterátorem tak může při těchto dvou voláních předat témuž konstruktoru různé argumenty. Samotná iterovatelnost nestačí; Set metodě Reflect.construct své prvky neposkytuje. target i případný zadaný newTarget musí být konstruktory — šipkové funkce jimi nejsou. Neplatné argumenty způsobí TypeError; výjimky z konstruktoru se předávají dál.

Pokud newTarget vynecháte, použije se jako výchozí hodnota target; při výslovném předání undefined nastane TypeError. Reflect.construct předá newTarget interní operaci [[Construct]] objektu target. Je-li target běžná konstruktorová funkce, má new.target v jejím těle hodnotu newTarget. Pokud je však target objekt Proxy, jeho obslužná metoda construct může newTarget ignorovat a zavolat zabalený konstruktor s jinou hodnotou new.target. Při běžném vytváření objektu pochází jeho prototyp z newTarget.prototype, pokud je tato hodnota objektem. Tím se tělo newTarget nespustí. Pokud target výslovně vrátí objekt, může tento objekt nahradit vytvořenou instanci.

V příkladu nastaví Person pole, ale prototyp pochází z Alternate. Výsledek proto není instancí Person. Jde o funkci jazyka ECMAScript, nikoli o Web API; dostupnost v konkrétních prohlížečích je třeba ověřit samostatně.

Příklady

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);

Výsledek

Ada
true
true
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje