База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Function.prototype.apply — извикване със списък от аргументи

Function.prototype.apply извиква функция с подадена стойност this и аргументи, прочетени от обект, подобен на масив. Така може да се подаде подготвен списък, вместо всеки аргумент да се изписва отделно.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

fn.apply(thisArg, argArray)

Function.prototype.apply извиква функция незабавно и връща резултата ѝ. В fn.apply(thisArg, argArray) thisArg задава подадената стойност this, а argArray предоставя позиционните аргументи. За сравнение, fn.call(thisArg, a, b) приема аргументите поотделно.

argArray може да бъде масив или обект, подобен на масив, със свойство length и индексирани свойства като 0 и 1. Подаването на null, подаването на undefined или пропускането на този параметър означава, че няма аргументи. Стойностите се четат по индекс, а не чрез итератор; липсващ индекс обикновено дава undefined, но може да бъде наследен от прототипа. Всяка друга примитивна стойност, включително низ, причинява TypeError.

apply предава thisArg без промяна, но обикновена функция извън строг режим заменя null и undefined с глобалната си стойност this, а другите примитивни стойности обвива в обекти. Обикновена функция в строг режим запазва подадената стойност. Стрелковите функции и функциите, свързани с bind, пренебрегват този избор на this.

В примера args не е масив: двата му елемента стават параметри a и b, а context става this. Резултатът е 15. Опитът да се използва apply с получател, който не може да бъде извикан, причинява TypeError.

Примери

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));

Резултат

15

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници