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.