Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect.construct — invocare un costruttore con un elenco di argomenti

Reflect.construct invoca un costruttore con argomenti letti da un oggetto. Il parametro newTarget facoltativo consente di separare il costruttore eseguito dal valore di new.target e dalla normale scelta del prototipo.

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

Sintassi

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

Reflect.construct(target, argumentsList) esegue una costruzione, non una normale chiamata di funzione. Funziona anche con le classi. A differenza di Reflect.apply, non accetta un this già esistente.

argumentsList deve essere un oggetto. Reflect.construct ne legge la proprietà length per determinare quali proprietà indicizzate leggere. Se length manca, la lunghezza è considerata pari a 0: se target è un costruttore, Reflect.construct(target, {}) lo invoca senza argomenti. La sintassi spread in new target(...argumentsList), invece, ricava gli argomenti dall’iteratore. Un array con un iteratore personalizzato può quindi passare argomenti diversi allo stesso costruttore nelle due chiamate. La sola iterabilità non basta; un Set non fornisce i propri elementi a Reflect.construct. Sia target sia l’eventuale newTarget specificato devono essere costruttori: le funzioni freccia non lo sono. Gli argomenti non validi causano un TypeError; le eccezioni del costruttore vengono propagate.

Se newTarget viene omesso, il valore predefinito è target; passare esplicitamente undefined causa un TypeError. Reflect.construct passa newTarget all’operazione interna [[Construct]] di target. Se target è una normale funzione costruttrice, nel corpo della funzione new.target vale newTarget. Se invece target è un Proxy, la sua trap construct può ignorare newTarget e invocare il costruttore sottostante con un valore diverso di new.target. Durante la normale creazione di un oggetto, il suo prototipo proviene da newTarget.prototype se tale valore è un oggetto. Questo non esegue il corpo di newTarget. Se target restituisce esplicitamente un oggetto, questo può sostituire l’istanza creata.

Nell’esempio, Person imposta i campi, ma il prototipo proviene da Alternate. Il risultato quindi non è un’istanza di Person. Si tratta di una funzionalità del linguaggio ECMAScript, non di una Web API; la disponibilità nei singoli browser va verificata separatamente.

Esempi

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

Risultato

Ada
true
true
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti