Native: Array

Набір Array методів.

Див. також:

Array Метод: each

Викликає функцію перебору елементів у масиві.

Синтаксис:

myArray.each(fn[, bind]);

Аргументи:

  1. fn - (function) Функція, яка виконується при отриманні елемента масиву. Ця функція проходить елемент, і він є індексом масиву.
  2. bind - (object, опціонально) Об'єкт буде використаний у функції як 'this'. Додаткова інформація Функція: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументи:
  1. item - (mixed) Поточний елемент масиву.
  2. index - (number) Поточний індекс елемента у масиві.
  3. array - (array) Поточний масив.

Приклади:

//Выведет "0 = apple", "1 = banana", и т.д.:
['apple', 'banana', 'lemon'].each(function(item, index){

    alert(index + " = " + item);
}); //Второй опциональный аргумент связывания здесь не используется.

Див. також:

Примітки:

  • Цей метод доступний лише для браузерів без підтримки власних MDC Array:forEach.

Array Метод: every

Повертає true, якщо кожен елемент масиву відповідає умовам функції. Цей метод доступний лише для браузерів без підтримки власних Array:every.

Синтаксис:

var allPassed = myArray.every(fn[, bind]);

Аргументи:

  1. fn - (function) Функція перевіряє кожен елемент масиву.
  2. bind - (object, опціонально) Об'єкт буде використаний у функції як 'this'. Додаткова інформація Функція: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументи:
  1. item - (mixed) Поточний елемент масиву.
  2. index - (number) Поточний індекс елемента у масиві.
  3. array - (array) Поточний масив.

Повертає:

  • (boolean) Повертає true, якщо кожен елемент масиву відповідає умовам функції. В іншому випадку повертає false.

Приклади:

var areAllBigEnough = [10, 4, 25, 100].every(function(item, index){

    return item > 20;
}); //areAllBigEnough = false

Див. також:

Array Метод: filter

Створює новий масив зі всіма елементами масиву, у разі, якщо елемент передбачає фільтрацію, функція поверне true. Цей метод доступний лише для браузерів без підтримки власних Array: filter.

Синтаксис:

var filteredArray = myArray.filter(fn[, bind]);

Аргументи:

  1. fn - (function) Функція перевіряє кожен елемент масиву. Ця функція проходить кожен елемент, і цей елемент є індексом масиву.
  2. bind - (object, опціонально) Об'єкт буде використаний у функції як 'this'. Додаткова інформація Функція: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументи:
  1. item - (mixed) Поточний елемент масиву.
  2. index - (number) Поточний індекс елемента у масиві.
  3. array - (array) Поточний масив.

Повертає:

  • (array) Новий відфільтрований масив.

Приклади:

var biggerThanTwenty = [10, 3, 25, 100].filter(function(item, index){

    return item > 20;
}); //biggerThanTwenty = [25, 100]

Див. також:

Array Метод: clean

Створює новий масив зі всіма елементами батьківського масиву, які були визначені (тобто не null чи undefined).

Синтаксис:

var cleanedArray = myArray.clean();

Повертає:

  • (array) Новий відфільтрований масив.

Приклади:

var myArray = [null, 1, 0, true, false, "foo", undefined, ""];
myArray.clean() // Возвращает [1, 0, true, false, "foo", ""]

Array Метод: indexOf

Повертає індекс першого елемента масиву, що містить задане значення, або -1, якщо значення не знайдено. Цей метод доступний лише для браузерів без підтримки власних Array: indexOf.

Синтаксис:

var index = myArray.indexOf(item[, from]);

Повертає:

  • (number) Індекс першого елемента масиву, що містить задане значення, або -1, якщо значення не знайдено.

Аргументи:

  1. item - (object) Шукане у масиві значення.
  2. from - (number, опціонально: за замовчуванням з 0) Індекс масиву, з якого почати пошук.

Приклади:

['apple', 'lemon', 'banana'].indexOf('lemon'); //Возвращает 1

['apple', 'lemon'].indexOf('banana'); //Возвращает -1

Див. також:

Array Метод: map

Створює новий масив з результатами застосування функції до кожного елемента масиву. Цей метод доступний лише для браузерів без підтримки власних Array: map.

Синтаксис:

var mappedArray = myArray.map(fn[, bind]);

Аргументи:

  1. fn - (function) Функція створює елемент нового масиву з результату елемента поточного.
  2. bind - (object, опціонально) Об'єкт буде використаний у функції як 'this'. Додаткова інформація Функція: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументи:
  1. item - (mixed) Поточний елемент масиву.
  2. index - (number) Поточний індекс елемента у масиві.
  3. array - (array) Поточний масив.

Повертає:

  • (array) Оброблений масив.

Приклади:

var timesTwo = [1, 2, 3].map(function(item, index){

    return item * 2;
}); // timesTwo = [2, 4, 6];

Див. також:

Array Метод: some

Повертає true, якщо хоча б один елемент масиву задовольняє умову функції. Цей метод доступний лише для браузерів без підтримки власних Array: some.

Синтаксис:

var somePassed = myArray.some(fn[, bind]);

Повертає:

  • (boolean) Повертає true, якщо хоча б один елемент масиву задовольняє умову функції. В іншому випадку повертає false.

Аргументи:

  1. fn - (function) Функція перевіряє кожен елемент масиву. Ця функція проходить кожен елемент, і цей елемент є індексом масиву.
  2. bind - (object, опціонально) Об'єкт буде використаний у функції як 'this'. Додаткова інформація Функція: bind.

Аргумент: fn

Синтаксис:
fn(item, index, array)
Аргументи:
  1. item - (mixed) Поточний елемент масиву.
  2. index - (number) Поточний індекс елемента у масиві.
  3. array - (array) Поточний масив.

Приклади:

var isAnyBigEnough = [10, 4, 25, 100].some(function(item, index){

    return item > 20;
}); //isAnyBigEnough = true

Див. також:

Array Метод: associate

Створює об'єкт ключ-значення з вихідного масиву, представляючи значення зазначеного масиву як ключі.

Синтаксис:

var associated = myArray.associate(obj);

Аргументи:

  1. obj - (array) Ці значення будуть представлені ключами створюваного об'єкта.

Повертає:

  • (object) Новий асоційований об'єкт.

Приклади:

var animals = ['Cow', 'Pig', 'Dog', 'Cat'];

var sounds = ['Moo', 'Oink', 'Woof', 'Miao'];
sounds.associate(animals);

//Возвращает: {'Cow': 'Moo', 'Pig': 'Oink', 'Dog': 'Woof', 'Cat': 'Miao'}

Приймає об'єкт за ключем / функцію пар для визначення значень.

Синтаксис:

var result = Array.link(array, object);

Аргументи:

  1. object - (object) Об'єкт, що містить ключ / функцію пар, який має бути пропущений для подальшого використання як шаблону для представлення значень з іншими ключами.

Повертає:

© Linux.ria.com, 2008-2026