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

CKTIS / JavaScript

Function.prototype.call — invocar uma função com um this explícito

Function.prototype.call invoca imediatamente uma função com um valor this explícito e argumentos fornecidos individualmente. Saiba como o modo estrito afeta this e por que motivo as funções arrow e as funções associadas ignoram o recetor fornecido.

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.call(thisArg, ...args)

Function.prototype.call invoca uma função fn através de fn.call(thisArg, ...args). O primeiro argumento especifica this; os restantes são passados, pela ordem indicada, aos parâmetros da função. O método devolve o resultado da função e propaga qualquer exceção que esta lance. No exemplo, a mesma função lê name de dois objetos diferentes.

O próprio método passa thisArg sem o converter. Uma função normal em modo estrito mantém esse valor, incluindo null, undefined e valores primitivos. Em modo não estrito, null e undefined são substituídos pelo valor global de this, enquanto os outros valores primitivos são convertidos em objetos wrapper.

call não pode substituir o this léxico de uma função arrow nem o this fixado de uma função associada com bind. Ao contrário de apply, aceita os argumentos individualmente; bind cria uma função em vez de a invocar imediatamente. Usar Function.prototype.call com um recetor que não possa ser invocado provoca um TypeError.

Exemplos

function describe(prefix, suffix) {
  "use strict";
  return prefix + this.name + suffix;
}

const person = { name: "Ada" };
console.log(describe.call(person, "Hello, ", "!"));
console.log(describe.call({ name: "Lin" }, "Hi, ", "."));

Resultado

Hello, Ada!
Hi, Lin.

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