Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect.apply — chiamare una funzione con this e argomenti espliciti

Reflect.apply chiama una funzione con il valore di `this` fornito e gli argomenti letti dall’oggetto passato. Restituisce il risultato della funzione senza leggere la proprietà `apply` di quest’ultima.

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.apply(target, thisArgument, argumentsList)

Reflect.apply(target, thisArgument, argumentsList) chiama target, fornendo thisArgument come valore di this e gli elementi di argumentsList come argomenti successivi. Restituisce il risultato della chiamata; le eccezioni vengono propagate. Non crea un’istanza e non sostituisce l’operatore new.

argumentsList deve essere un oggetto, ma non è necessario che abbia una proprietà length o proprietà indicizzate. Il metodo legge length, converte il valore in una lunghezza e poi legge le proprietà indicizzate corrispondenti. Se length manca, la lunghezza è considerata pari a zero: ad esempio, {} è accettato e non fornisce alcun argomento. Si può anche passare un array o un oggetto come quello dell’esempio. Il metodo non usa il protocollo di iterazione, quindi non passa gli elementi di un Set come argomenti distinti. La lettura delle proprietà può attivare getter.

Se target non è invocabile o argumentsList non è un oggetto, viene generato un TypeError. A differenza di Function.prototype.apply, omettere argumentsList o passare null o undefined non equivale a una lista vuota: passa []. Il metodo non legge target.apply, quindi funziona anche se questa proprietà è stata mascherata.

Fornire thisArgument non modifica le regole della funzione di destinazione: una funzione freccia mantiene il proprio this lessicale e una funzione associata tramite bind mantiene il this associato. Una funzione ordinaria in modalità strict riceve il valore fornito senza modifiche; fuori dalla modalità strict si applicano le normali regole di conversione di this.

Esempi

function total(a, b) {
  "use strict";
  return this.base + a + b;
}

const receiver = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(Reflect.apply(total, receiver, args));

Risultato

15

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