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

CKTIS / JavaScript

Reflect.apply — chamar uma função com this e argumentos explícitos

Reflect.apply chama uma função com o valor de `this` fornecido e argumentos lidos de um objeto passado à chamada. Devolve o resultado da função sem ler a propriedade `apply` desta.

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

Reflect.apply(target, thisArgument, argumentsList)

Reflect.apply(target, thisArgument, argumentsList) chama target, fornecendo thisArgument como valor de this e os elementos de argumentsList como argumentos sucessivos. Devolve o resultado da chamada; as exceções propagam-se. Não cria uma instância nem substitui o operador new.

argumentsList tem de ser um objeto, mas não precisa de ter uma propriedade length nem propriedades indexadas. O método lê length, converte o valor num comprimento e, em seguida, lê as propriedades indexadas correspondentes. Se não existir length, o comprimento é considerado zero: por exemplo, {} é aceite e não fornece argumentos. Também se pode passar um array ou um objeto como o do exemplo. O método não usa o protocolo de iteração, pelo que não passa os elementos de um Set como argumentos individuais. A leitura de propriedades pode executar getters.

Se target não for invocável ou argumentsList não for um objeto, ocorre um TypeError. Ao contrário de Function.prototype.apply, omitir argumentsList ou usar null ou undefined não significa uma lista vazia — passa []. O método não lê target.apply, pelo que também funciona quando essa propriedade foi ocultada.

Fornecer thisArgument não altera as regras da função de destino: uma função arrow mantém o seu this léxico e uma função associada através de bind mantém o seu this associado. Uma função normal em modo estrito recebe o valor fornecido sem alterações; fora do modo estrito, aplicam-se as regras habituais de conversão de this.

Exemplos

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

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