CKTIS / JavaScript
Function.prototype.apply — appel avec une liste d’arguments
Function.prototype.apply appelle une fonction avec une valeur this fournie et des arguments lus depuis un objet semblable à un tableau. Cela permet de transmettre une liste préparée au lieu d’écrire chaque argument séparément.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
fn.apply(thisArg, argArray)Function.prototype.apply appelle immédiatement une fonction et renvoie son résultat. Dans fn.apply(thisArg, argArray), thisArg indique la valeur this fournie, tandis que argArray fournit les arguments positionnels. En comparaison, fn.call(thisArg, a, b) reçoit les arguments individuellement.
argArray peut être un tableau ou un objet semblable à un tableau, avec length et des propriétés indexées telles que 0 et 1. Passer null, passer undefined ou omettre ce paramètre signifie qu’aucun argument n’est fourni. Les valeurs sont lues par index et non au moyen d’un itérateur ; un index manquant donne généralement undefined, mais peut être hérité du prototype. Toute autre valeur primitive, y compris une chaîne, provoque un TypeError.
apply transmet thisArg sans le modifier, mais une fonction ordinaire hors mode strict remplace null et undefined par sa valeur globale de this et encapsule les autres valeurs primitives dans des objets. Une fonction ordinaire en mode strict conserve la valeur fournie. Les fonctions fléchées et celles liées avec bind ignorent ce choix de this.
Dans l’exemple, args n’est pas un tableau : ses deux éléments deviennent les paramètres a et b, et context devient this. Le résultat est 15. Tenter d’utiliser apply avec un receveur qui n’est pas appelable provoque un TypeError.
Exemples
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));Résultat
15
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.