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

CKTIS / JavaScript

Function.prototype.bind — associar this e argumentos iniciais

Function.prototype.bind cria uma nova função com um valor this guardado e, opcionalmente, argumentos iniciais. Não invoca a função original; o resultado pode ser chamado mais tarde ou passado como callback.

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

const boundFn = fn.bind(thisArg, ...boundArgs);

Function.prototype.bind devolve uma nova função que envolve a função original. fn.bind(thisArg, ...boundArgs) guarda thisArg e os argumentos boundArgs sem executar fn. Numa chamada normal, os argumentos associados surgem antes dos argumentos fornecidos mais tarde — isto é aplicação parcial.

Numa chamada normal, nem call nem apply podem substituir o this associado. Outro bind também não o pode alterar, embora possa adicionar argumentos. Uma função arrow mantém o seu this léxico; bind só pode associar os seus argumentos. Numa chamada normal, uma função de destino que não esteja em modo estrito continua a aplicar as conversões habituais de this: por exemplo, usa o valor global de this do seu ambiente de execução (realm) em vez de null. Num navegador, esse valor pode ser um WindowProxy em vez do objeto Window subjacente.

Cada chamada a bind cria um objeto função distinto, por isso guarda o resultado se precisares da mesma referência mais tarde. No exemplo, greet mantém user como this e "Hello, " como argumento inicial; nem mesmo call com outro objeto altera o recetor.

Se a função original for um construtor, o resultado pode ser chamado com new: nesse caso, o thisArg associado é ignorado, mas os argumentos associados permanecem. Uma função associada não tem uma propriedade prototype própria. Usar Function.prototype.bind com um valor não invocável lança um TypeError.

Exemplos

"use strict";

function format(prefix, suffix) {
  return `${prefix}${this.name}${suffix}`;
}

const user = { name: "Ada" };
const greet = format.bind(user, "Hello, ");

console.log(greet("!"));
console.log(greet.call({ name: "Lin" }, "?"));
console.log(greet === format.bind(user, "Hello, "));

Resultado

Hello, Ada!
Hello, Ada?
false

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