Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje