JavaScript метод apply()

Определение и применение

JavaScript метод apply() позволяет вызывать (выполнять) функцию как метод объекта, устанавливая ее контекст исполнения (this, значения контекста вызова) в указанное значение, передавая при этом необходимые аргументы в виде массива (объекта Array), либо массивоподобного объекта.

Чтобы вызвать функцию (без аргументов) как метод объекта достаточно использовать метод call(), или apply() следующим образом:

JavaScript
func.call( obj );
func.apply( obj );

Все аргументы метода call(), следующие за первым аргументом, который определяет контекст вызова, передаются вызываемой функции. Метод apply() действует подобно методу call(), за исключением того, что аргументы для функции передаются в виде массива, или объекта, подобного массиву, а не перечисляются через запятую:

JavaScript
func.call( obj, 1, 2, 3 );
func.apply( obj, [1, 2, 3] );

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Function.apply
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
apply✓1✓12✓1✓4✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1
ES 5.1: generic array-like object as arguments✓17✓12✓4✓5✓6✓18✓4✓10.1✓6✓1.0✓4.4✓6

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис:

JavaScript
// без передачи дополнительных аргументов
func.apply( thisArg );

// с указанием дополнительных аргументов передаваемых функции
func.apply(thisArg, argsArray);

Спецификация

ECMAScript — Function.prototype.apply().

Значения параметров

apply: справочные сведения
Параметр Описание
thisArg Значение this (контекста вызова) внутри целевой функции. В строгом режиме значение передаётся без преобразования. В нестрогой обычной функции null и undefined заменяются глобальным объектом, а примитивы оборачиваются в объекты. Необязательный параметр.
argsArray Массив, или массивоподобный объект, определяющий аргументы, с которыми функция должна быть вызвана, или null, или undefined, если функция вызывается без аргументов. Необязательный параметр.

Возвращаемое значение

Результат вызова целевой функции, включая undefined, если она ничего не возвращает. Исключения из её тела передаются вызывающему коду.

Исключения

apply: справочные сведения
Тип исключения Описание
TypeError Возникает в том случае, если метод вызывается для объекта, не являющегося функцией.

Примеры, попробуйте сами

Как передать контекст и массив аргументов

Измените поля объекта и числа в массиве аргументов. Сравните результат с вызовом через массивоподобный объект.

index.html
HTML
<p>Результат выполнения выводится в консоль.</p>
main.js
JavaScript
let obj = {
    // инициализируем переменную, содержащую объект
    a: 100,
    b: 200,
}

// функция возвращает сумму четырёх значений
let func = function (c, d) {
    return this.a + this.b + c + d
}

// вызываем функцию как метод объекта
console.log(func.apply(obj, [300, 400])) // возвращаемое значение 1000

// Массивоподобный объект передаёт индексные значения как аргументы.
console.log(func.apply(obj, { 0: 300, 1: 400, length: 2 })) // 1000

В следующем примере мы рассмотрим как с помощью методов push() и apply() добавить один массив к другому:

Как добавить элементы одного массива в другой

Добавьте элемент во второй массив и проверьте, как изменился первый после push.apply().

index.html
HTML
<p>Результат выполнения выводится в консоль.</p>
main.js
JavaScript
// инициализируем переменные, содержащие массив
let arr1 = ['a', 'b']
let arr2 = [1, 2, 3]

// добавляем один массив к другому
arr1.push.apply(arr1, arr2)
console.log(arr1) // возвращаемое значение ["a", "b", 1, 2, 3]

В следующем примере мы рассмотрим как с помощью методов объекта Math и метода apply() вычислить максимальное и минимальное значение в массиве:

Как найти минимум и максимум массива

Измените числа в массиве и сравните результаты Math.min.apply() и Math.max.apply().

index.html
HTML
<p>Результат выполнения выводится в консоль.</p>
main.js
JavaScript
// инициализируем переменную, содержащую массив
let arr = [-10, 22, 5, -2]

// находим минимальное число в массиве
console.log(Math.min.apply(null, arr)) // возвращаемое значение -10

// находим максимальное число в массиве
console.log(Math.max.apply(null, arr)) // возвращаемое значение 22