Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Reflect.apply — llamar a una función con this y argumentos explícitos

Reflect.apply llama a una función con un valor de `this` proporcionado y argumentos leídos de un objeto que se le pasa. Devuelve el resultado de la función sin leer la propiedad `apply` de esta.

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

Reflect.apply(target, thisArgument, argumentsList)

Reflect.apply(target, thisArgument, argumentsList) llama a target, proporcionando thisArgument como su valor de this y los elementos de argumentsList como argumentos sucesivos. Devuelve el resultado de la llamada; las excepciones se propagan. No crea una instancia ni sustituye al operador new.

argumentsList debe ser un objeto, pero no necesita tener una propiedad length ni propiedades indexadas. El método lee length, convierte su valor en una longitud y luego lee las propiedades indexadas correspondientes. Si no hay una propiedad length, la longitud se considera cero: por ejemplo, se admite {} y no se pasa ningún argumento. También se puede pasar un array o un objeto como el del ejemplo. El método no usa el protocolo de iteración, por lo que no pasa los elementos de un Set como argumentos individuales. La lectura de propiedades puede ejecutar getters.

Si target no es invocable o argumentsList no es un objeto, se produce un TypeError. A diferencia de Function.prototype.apply, omitir argumentsList o usar null o undefined no significa que la lista esté vacía: pasa []. El método no lee target.apply, por lo que también funciona cuando esa propiedad se ha ocultado.

Proporcionar thisArgument no anula las reglas de la función de destino: una función flecha conserva su this léxico, y una función vinculada mediante bind conserva su this vinculado. Una función ordinaria en modo estricto recibe el valor proporcionado sin cambios; fuera del modo estricto se aplican las reglas habituales de conversión de this.

Ejemplos

function total(a, b) {
  "use strict";
  return this.base + a + b;
}

const receiver = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(Reflect.apply(total, receiver, 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.

Fuentes