Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes