CKTIS / JavaScript
Function.prototype.apply — chiamata con un elenco di argomenti
Function.prototype.apply chiama una funzione con un valore this specificato e argomenti letti da un oggetto simile a un array. Consente di passare un elenco preparato invece di scrivere ogni argomento separatamente.
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
fn.apply(thisArg, argArray)Function.prototype.apply chiama subito una funzione e ne restituisce il risultato. In fn.apply(thisArg, argArray), thisArg specifica il valore this fornito, mentre argArray fornisce gli argomenti posizionali. In confronto, fn.call(thisArg, a, b) accetta gli argomenti singolarmente.
argArray può essere un array oppure un oggetto simile a un array con length e proprietà indicizzate come 0 e 1. Passare null, passare undefined o omettere questo parametro significa non fornire argomenti. I valori vengono letti tramite indice, non attraverso un iteratore; un indice mancante di solito produce undefined, ma può essere ereditato dal prototipo. Qualsiasi altro valore primitivo, compresa una stringa, causa un TypeError.
apply passa thisArg senza modificarlo, ma una funzione ordinaria fuori dalla modalità strict sostituisce null e undefined con il proprio valore globale di this e converte gli altri valori primitivi in oggetti. Una funzione ordinaria in modalità strict mantiene il valore fornito. Le funzioni freccia e quelle associate con bind ignorano questa scelta di this.
Nell’esempio, args non è un array: i suoi due elementi diventano i parametri a e b, e context diventa this. Il risultato è 15. Tentare di usare apply con un ricevente che non è invocabile causa un TypeError.
Esempi
function total(a, b) {
"use strict";
return this.base + a + b;
}
const context = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(total.apply(context, 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.