JavaScript метод apply()
Определение и применение
JavaScript метод apply() позволяет вызывать (выполнять) функцию как метод объекта, устанавливая ее
контекст исполнения (this, значения контекста вызова) в указанное значение, передавая при этом
необходимые аргументы в виде массива (объекта
Array), либо массивоподобного объекта.
Чтобы вызвать функцию (без аргументов) как метод объекта достаточно использовать метод
call(), или apply() следующим образом:
func.call( obj );
func.apply( obj );
Все аргументы метода call(), следующие за первым аргументом, который определяет контекст вызова,
передаются вызываемой функции. Метод apply() действует подобно методу call(), за исключением
того, что аргументы для функции передаются в виде массива, или объекта, подобного массиву, а не перечисляются через
запятую:
func.call( obj, 1, 2, 3 );
func.apply( obj, [1, 2, 3] );
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 синтаксис:
// без передачи дополнительных аргументов
func.apply( thisArg );
// с указанием дополнительных аргументов передаваемых функции
func.apply(thisArg, argsArray);
Спецификация
ECMAScript — Function.prototype.apply().
Значения параметров
| Параметр | Описание |
|---|---|
thisArg |
Значение this (контекста вызова) внутри целевой функции. В строгом режиме значение передаётся без
преобразования. В нестрогой обычной функции null и undefined заменяются глобальным
объектом, а примитивы оборачиваются в объекты.
Необязательный параметр.
|
argsArray
|
Массив, или массивоподобный объект, определяющий аргументы, с которыми функция должна быть вызвана, или
null, или undefined, если функция вызывается без аргументов.
Необязательный параметр.
|
Возвращаемое значение
Результат вызова целевой функции, включая undefined, если она ничего не возвращает. Исключения из её тела
передаются вызывающему коду.
Исключения
| Тип исключения | Описание |
|---|---|
TypeError |
Возникает в том случае, если метод вызывается для объекта, не являющегося функцией. |
Примеры, попробуйте сами
Как передать контекст и массив аргументов
Измените поля объекта и числа в массиве аргументов. Сравните результат с вызовом через массивоподобный объект.
index.html
<p>Результат выполнения выводится в консоль.</p>
main.js
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
<p>Результат выполнения выводится в консоль.</p>
main.js
// инициализируем переменные, содержащие массив
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
<p>Результат выполнения выводится в консоль.</p>
main.js
// инициализируем переменную, содержащую массив
let arr = [-10, 22, 5, -2]
// находим минимальное число в массиве
console.log(Math.min.apply(null, arr)) // возвращаемое значение -10
// находим максимальное число в массиве
console.log(Math.max.apply(null, arr)) // возвращаемое значение 22