CKTIS / JavaScript
Function.prototype.apply — llamada con una lista de argumentos
Function.prototype.apply llama a una función con un valor this proporcionado y argumentos leídos de un objeto similar a un array. Permite pasar una lista preparada en lugar de escribir cada argumento por separado.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
fn.apply(thisArg, argArray)Function.prototype.apply llama a una función de inmediato y devuelve su resultado. En fn.apply(thisArg, argArray), thisArg especifica el valor this proporcionado, mientras que argArray aporta los argumentos posicionales. En cambio, fn.call(thisArg, a, b) recibe los argumentos por separado.
argArray puede ser un array o un objeto similar a un array con length y propiedades indexadas como 0 y 1. Pasar null, pasar undefined u omitir este parámetro significa que no hay argumentos. Los valores se leen por índice, no mediante un iterador; un índice ausente suele producir undefined, pero puede heredarse del prototipo. Cualquier otro valor primitivo, incluida una cadena, provoca un TypeError.
apply pasa thisArg sin modificar, pero una función ordinaria fuera del modo estricto sustituye null y undefined por su valor global de this y convierte otros valores primitivos en objetos. Una función ordinaria en modo estricto conserva el valor proporcionado. Las funciones flecha y las funciones vinculadas con bind ignoran esta elección de this.
En el ejemplo, args no es un array: sus dos elementos se convierten en los parámetros a y b, y context se convierte en this. El resultado es 15. Intentar usar apply con un receptor que no sea invocable provoca un TypeError.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.