CKTIS / JavaScript
Function.prototype.apply — klic s seznamom argumentov
Function.prototype.apply pokliče funkcijo s podano vrednostjo this in argumenti, prebranimi iz objektu, podobnega polju. Tako lahko posredujete pripravljen seznam, namesto da vsak argument zapišete posebej.
Različica: 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 funkcijo pokliče takoj in vrne njen rezultat. V zapisu fn.apply(thisArg, argArray) thisArg določa podano vrednost this, argArray pa zagotovi pozicijske argumente. V primerjavi s tem fn.call(thisArg, a, b) sprejme argumente posamično.
argArray je lahko polje ali objekt, podoben polju, z lastnostjo length in indeksiranimi lastnostmi, kot sta 0 in 1. Če podate null ali undefined oziroma ta parameter izpustite, to pomeni, da argumentov ni. Vrednosti se berejo po indeksih, ne z iteratorjem; manjkajoči indeks običajno da undefined, lahko pa je podedovan iz prototipa. Katera koli druga primitivna vrednost, tudi niz, povzroči TypeError.
apply posreduje thisArg nespremenjen, vendar običajna funkcija zunaj strogega načina null in undefined zamenja s svojo globalno vrednostjo this, druge primitivne vrednosti pa zavije v objekte. Običajna funkcija v strogem načinu ohrani podano vrednost. Puščične funkcije in funkcije, povezane z bind, to izbiro vrednosti this prezrejo.
V primeru args ni polje: njegova elementa postaneta parametra a in b, context pa postane this. Rezultat je 15. Poskus uporabe apply s prejemnikom, ki ga ni mogoče poklicati, povzroči TypeError.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.