Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Function.prototype.apply — poziv s popisom argumenata

Function.prototype.apply poziva funkciju s navedenom vrijednošću this i argumentima pročitanima iz objekta nalik polju. Omogućuje prosljeđivanje pripremljenog popisa umjesto zasebnog navođenja svakog argumenta.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

fn.apply(thisArg, argArray)

Function.prototype.apply odmah poziva funkciju i vraća njezin rezultat. U zapisu fn.apply(thisArg, argArray), thisArg određuje proslijeđenu vrijednost this, dok argArray daje pozicijske argumente. Za usporedbu, fn.call(thisArg, a, b) prima argumente pojedinačno.

argArray može biti polje ili objekt nalik polju s vrijednošću length i indeksiranim svojstvima kao što su 0 i 1. Prosljeđivanje null ili undefined, kao i izostavljanje ovog parametra, znači da nema argumenata. Vrijednosti se čitaju prema indeksu, a ne putem iteratora; indeks koji nedostaje obično daje undefined, ali može biti naslijeđen iz prototipa. Svaka druga primitivna vrijednost, uključujući niz znakova, uzrokuje TypeError.

apply prosljeđuje thisArg nepromijenjen, ali obična funkcija izvan strogog načina rada zamjenjuje null i undefined svojom globalnom vrijednošću this, a ostale primitivne vrijednosti pretvara u objekte. Obična funkcija u strogom načinu rada zadržava proslijeđenu vrijednost. Funkcije strelice i funkcije povezane pomoću bind zanemaruju ovaj odabir vrijednosti this.

U primjeru args nije polje: njegova dva elementa postaju parametri a i b, a context postaje this. Rezultat je 15. Pokušaj korištenja apply s primateljem koji se ne može pozvati uzrokuje TypeError.

Primjeri

function total(a, b) {
  "use strict";
  return this.base + a + b;
}

const context = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(total.apply(context, args));

Rezultat

15

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori