Type: Array

Колекція корисних методів для розширення Array.

Див. також

• Array

Array Method: min

Викликає Math.min на масиві і повертає його найменше значення.

Синтаксис

myArray.min();

Приклад

[1, 2, 3].min();
//returns 1

Повертає

• (number) найменше число в масиві

Array Method: max

Викликає Math.max на масиві і повертає його найбільше значення.

Синтаксис

myArray.max();

Приклад

[1, 2, 3].max();
//returns 3

Повертає

• (number) найбільше число в масиві

Array Method: average

Обчислює середнє значення масиву.

Синтаксис

myArray.average();

Приклад

[1, 2, 3].average();
//returns 2

Повертає

• (number) середнє значення масиву

Array Method: shuffle

Рандомізує масив (змінюючи його).

Синтаксис

myArray.shuffle();

Приклад

[1, 2, 3].shuffle();

Повертає

• (array) масив.

Примітка

Виклик цього методу змінює масив; він не просто повертає новий масив з тим самим вмістом, перемішаним випадковим чином. Він однак повертає сам себе.

Array Method: sum

Підсумовує всі значення в масиві.

Синтаксис

myArray.sum();

Приклад

$$('ul.menu li').getWidth().sum();
//returns the width of all li elements inside ul.menu as a sum

Повертає

• (number) число, що містить суму всіх значень у даному масиві

Array Method: unique

Повертає новий масив без повторюваних значень.

Синтаксис

myArrayWithoutDupes = myArray.unique();

Приклад

var fruits = ['apple', 'lemon', 'pear', 'lemon', 'apple'].unique();
//fruits == ['apple', 'lemon', 'pear']

Повертає

• (array) новий масив без дублікатів.

Array Method: reduce

Застосовує функцію до акумулятора та кожного значення масиву (зліва направо), щоб звести його до єдиного значення.

Синтаксис

result = myArray.reduce(fn[, value]);

Аргументи:

1. fn - (function) Function для виконання на кожному значенні в масиві.
2. value - (mixed) Значення для використання як перший аргумент при першому виклику fn

Сигнатура:

fn(previousValue, currentValue, index, array)

Приклад

[0, 1, 2, 3, 4].reduce(function(a, b){
    return a + b;
}); // returns 10
 
[0, 1, 2, 3, 4].reduce(function(a, b){
    return a + b;
}, 20); // returns 30

Повертає

• (mixed) Повертає зведене єдине значення масиву.

Див. також:

• MDC Array.reduce

Array Method: reduceRight

Застосовує функцію одночасно до двох значень масиву (справа наліво), щоб звести його до єдиного значення.

Синтаксис

result = myArray.reduceRight(fn[, value]);

Аргументи:

1. fn - (function) Function для виконання на кожному значенні в масиві.
2. value - (mixed) Значення для використання як перший аргумент при першому виклику fn

Сигнатура:

fn(previousValue, currentValue, index, array)

Приклад

var flattened = [[0, 1], [2, 3], [4, 5]].reduceRight(function(a, b) {
    return a.concat(b);
}, []);
// flattened is [4, 5, 2, 3, 0, 1]

Повертає

• (mixed) Повертає зведене єдине значення масиву.

Див. також:

• MDC Array.reduceRight