CKTIS / JavaScript
Function.prototype.bind — svázání this a počátečních argumentů
Function.prototype.bind vytvoří novou funkci s uloženou hodnotou this a případnými počátečními argumenty. Původní funkci nevolá; výsledek lze zavolat později nebo předat jako callback.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const boundFn = fn.bind(thisArg, ...boundArgs);Function.prototype.bind vrací novou funkci, která obaluje původní funkci. fn.bind(thisArg, ...boundArgs) uloží thisArg a argumenty boundArgs, aniž by spustila fn. Při běžném volání předcházejí svázané argumenty argumentům zadaným později — jde o částečnou aplikaci funkce.
Při běžném volání nemohou svázané this nahradit ani call, ani apply. Změnit je nemůže ani další bind, může však přidat argumenty. Šipková funkce si zachovává lexikální this; pomocí bind lze svázat pouze její argumenty. Při běžném volání cílové funkce mimo striktní režim se stále uplatňují obvyklé převody this: místo null například funkce použije globální hodnotu this ze svého běhového prostředí (realm). V prohlížeči může být touto hodnotou WindowProxy, nikoli samotný objekt Window.
Každé volání bind vytvoří samostatný objekt funkce, proto si výsledek ponechte, pokud později potřebujete stejnou referenci. V příkladu si greet zachová user jako this a "Hello, " jako počáteční argument; ani call s jiným objektem příjemce nezmění.
Pokud je původní funkce konstruktorem, lze výsledek volat pomocí new: svázané thisArg se v takovém případě ignoruje, svázané argumenty však zůstávají. Svázaná funkce nemá vlastní vlastnost prototype. Použití Function.prototype.bind s nevolatelnou hodnotou vyvolá TypeError.
Příklady
"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, "));Výsledek
Hello, Ada! Hello, Ada? false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.