CKTIS / JavaScript
Function.prototype.apply — chamada com uma lista de argumentos
Function.prototype.apply chama uma função com um valor this indicado e argumentos lidos de um objeto semelhante a um array. Permite passar uma lista preparada em vez de escrever cada argumento separadamente.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
fn.apply(thisArg, argArray)Function.prototype.apply chama imediatamente uma função e devolve o resultado. Em fn.apply(thisArg, argArray), thisArg especifica o valor this fornecido, enquanto argArray fornece os argumentos posicionais. Em comparação, fn.call(thisArg, a, b) recebe os argumentos individualmente.
argArray pode ser um array ou um objeto semelhante a um array, com length e propriedades indexadas como 0 e 1. Passar null, passar undefined ou omitir este parâmetro significa que não há argumentos. Os valores são lidos por índice, não através de um iterador; um índice em falta normalmente produz undefined, mas pode ser herdado do protótipo. Qualquer outro valor primitivo, incluindo uma cadeia de caracteres, causa um TypeError.
apply passa thisArg sem o alterar, mas uma função normal fora do modo estrito substitui null e undefined pelo seu valor global de this e converte os outros valores primitivos em objetos. Uma função normal no modo estrito preserva o valor fornecido. As funções seta e as funções associadas com bind ignoram esta escolha de this.
No exemplo, args não é um array: os seus dois elementos tornam-se os parâmetros a e b, e context torna-se this. O resultado é 15. Tentar usar apply com um recetor que não seja chamável causa um TypeError.
Exemplos
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));Resultado
15
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.