Статья, в которой рассмотрим на примерах использование функции и метода библиотеки jQuery each .
В библиотеке jQuery имеются 2 разные сущности с названием each .
Первая (jQuery.each ) - это универсальная функция jQuery с помощью которой можно осуществить перебор элементов массива или объекта.
Вторая (each ) - это метод, который применяется к набору элементов для организации цикла по ним.
Цикл each (jQuery.each). Примеры использованияСинтаксис функции each :
// array или object - массив или объект, элементы или свойства которого необходимо перебрать // callback - функция, которая будет выполнена для каждого элемента массива или свойства объекта $.each(array или object,callback);
Работу с функцией each разберём на примерах.
Пример №1. В нём выполним переберор всех элементов массива (array).
// массив, состоящий из 3 строк var arr = ["Автомобиль","Грузовик","Автобус"]; // переберём массив arr $.each(arr,function(index,value){ // действия, которые будут выполняться для каждого элемента массива // index - это текущий индекс элемента массива (число) // value - это значение текущего элемента массива //выведем индекс и значение массива в консоль console.log("Индекс: " + index + "; Значение: " + value); }); /* Результат (в консоли): Индекс: 0; Значение: Автомобиль Индекс: 1; Значение: Грузовик Индекс: 2; Значение: Автобус */
В вышеприведённом коде функция each используется для перебора массива. Функция имеет 2 обязательных параметра . Первый параметр - это сущность (массив или объект), элементы (свойства) которой необходимо перебрать. В данном случае - это массив arr . Второй параметр - это функция обратного вызова, которая будет выполнена для каждого элемента (в данном случае) массива. Она имеет 2 параметра , которые доступны внутри неё посредством соответствующих переменных. Первый параметр - это порядковый номер элемента (отсчёт выполняется с 0). Второй параметр - это значение текущего элемента массива.
Пример №2. В этом примере осуществим перебор всех свойств объекта.
// объект smartphone, имеющий 5 свойств
var smartphone = {
"name": "LG G5 se",
"year": "2016",
"screen-size": "5.3",
"screen-resolution": "2560 x 1440",
"os" : "Android 6.0 (Marshmallow)"
};
// переберём объект smartphone
$.each(smartphone, function(key, value) {
// действия, которые будут выполняться для каждого свойства объекта
// key - текущее имя свойства массива
// value - значение текущего свойства объекта
// выведем имя свойства и его значение в консоль
console.log("Свойство: " +key + "; Значение: " + value);
});
/*
Результат (в консоли):
Свойство: name; Значение: LG G5 se
Свойство: year; Значение: 2016
Свойство: screen-size; Значение: 5.3
Свойство: screen-resolution; Значение: 2560 x 1440
Свойство: os; Значение: Android 6.0 (Marshmallow)
*/
Функция each может использоваться для перебора JavaScript объектов. Отличие её использования заключается только в том, что параметры функции обратного вызова имеют другие значения. Первый параметр хранит название свойства объекта, а второй - значение этого свойства.
Пример №3. В нём осуществим перебор более сложной структуры (рассмотрим, как использовать вложенные each ).
// объект, состоящий из 2 свойств. Каждое свойство этого объект имеет в качестве значения массив, элементами которого являются тоже объекты var articles = { "Bootstrap": [ {"id":"1", "title":"Введение"}, {"id":"2", "title":"Как установить"}, {"id":"3", "title":"Сетка"} ], "JavaScript": [ {"id":"4", "title":"Основы"}, {"id":"5", "title":"Выборка элементов"} ] }; $.each(articles,function(key,data) { console.log("Раздел: " + key); $.each(data, function(index,value) { console.log("Статья: id = " + value["id"] + "; Название = "+ value["title"]); }); }); /* Результат: Раздел: Bootstrap Статья: id = 1; Название = Введение Статья: id = 2; Название = Как установить Статья: id = 3; Название = Сетка Раздел: JavaScript Статья: id = 4; Название = Основы Статья: id = 5; Название = Выборка элементов */
Как прервать each (выйти из цикла)?Прерывание (break) цикла each осуществляется с помощью оператора return , который должен возвращать значение false .
Например, прервём выполнение цикла each после того как найдём в массиве arr число 7:
// массив, состоящий из 5 чисел var arr = ; // число, которое необходимо найти var find = 7; // переберём массив arr $.each(arr, function (index, value) { // если необходимое число найдено, то.. if (value === find) { // вывести его в консоль console.log("Ура! Число " + find + " найдено! Данное число имеет индекс: " + index); // прервать выполнение цикла return false; } else { // иначе вывести в консоль текущее число console.log("Текущее число: " + value); } }); /* Результат (в консоли): Текущее число: 5 Текущее число: 4 Ура! Число 7 найдено! Данное число имеет индекс: 2 */
Как перейти к следующей итерации (each continue)?В each прерывание выполнения текущей итерации и переход к следующей осуществляется с помощью оператора return , который должен иметь значение отличное от false .
// массив, состоящий из чисел var arr = ; // массив, который должен содержать все элементы массива arr, кроме чётных чисел var newarr = ; // переберём массив arr $.each(arr, function (index, value) { // если элемент чётный, то пропустим его if (value % 2 === 0) { // прервём выполнение текущей итерации и перейдём к следующей return; } // добавить в массив newarr значение value newarr.push(value); }); console.log("Исходный массив (arr): " + arr.join()); console.log("Результирующий массив (newarr): " + newarr.join()); /* Результат (в консоли): Исходный массив (arr): 3,5,4,9,17,19,30,35,40 Результирующий массив (newarr): 3,5,9,17,19,35 */
Перебор текущих элементов (.each)Синтаксис метода each (пременяется только к выбранным элементам):
.each(function);
// function - функция, которая будет выполнена для каждого элемента текущего объекта
Разберём, как работает метод.each на следующем примере (переберём элементы div):
// после загрузки DOM страницы выполнить $(function(){ // перебрать элементы div на странице $("div").each(function (index, element) { // index (число) - текущий индекс итерации (цикла) // данное значение является числом // начинается отсчёт с 0 и заканчивается количеству элементов в текущем наборе минус 1 // element - содержит DOM-ссылку на текущий элемент console.log("Индекс элемента div: " + index + "; id элемента = " + $(element).attr("id")); }); }); // Результат: // Индекс элемента div: 0; id элемента = id1 // Индекс элемента div: 1; id элемента = id2 // Индекс элемента div: 2; id элемента = id3
В вышеприведённом примере метод each использует текущий набор (элементы, выбранные посредством селектора $("div")). В качестве обработчика метода each всегда выступает функция, которая будет выполнена для каждого элемента текущего набора (в данном случае для каждого элемента div). Данная функция имеет 2 необязательных параметра. Один из них (index) представляет собой порядковый номер текущей итерации, а второй (element) - DOM ссылку на текущий элемент. Кроме этого внутри функции доступно ключевое слово this , которое также как и второй параметр, содержит DOM-ссылку на текущий элемент.
Например, выведем в консоль значение атрибута href для всех элементов а на странице:
$("a").each(function() { console.log($(this).attr("href")); });
$("a").each(function() { var link = $(this).attr("href"); if ((link.indexOf("http://") == 0) || (link.indexOf("https://") == 0)) { console.log("href ссылки = " + link); } }); // Если на странице расположены следующие ссылки: // Яндекс // Как работает JavaScript? // Bootstrap // То в консоли увидим следующий результат: // https://www.yandex.ru/ // http://getbootstrap.com/
Например, рассмотрим, как организовать цикл each по элементам DOM, имеющих класс name (переберём все элементы одного класса).
Raspberry pi single-board compute Intel Galileo Gen2 19$ Pine A64 Plus // с помощью функции jQuery.each ($.each) $.each($(".name"),function(index,data) { console.log("Порядковый номер: " + index + " ; Содержимое: " +$(data).text()); }); // с помощью метода jQuery .each $(".name").each(function(index,data) { console.log("Порядковый номер: " + index + " ; Содержимое: " +$(data).text()); }); // Получим следующий ответ: // Порядковый номер: 0 ; Содержимое: Raspberry pi // Порядковый номер: 1 ; Содержимое: Intel Galileo Gen2 // Порядковый номер: 2 ; Содержимое: Pine A64 Plus
Например, разберём, как перебрать все элементы на странице.
$("*").each(function() { console.log(this); });
Например, выведем значение всех элементов input на странице.
$("input").each(function() { console.log($(this).val()); });
Например, переберём все дочерние элементы, расположенные в ul с id="myList" (each children).
- HTML
- JavaScript
Рассмотрим способ, с помощью которого можно определить последний индекс (элемент) в методе jQuery each .
// выбираем элементы var myList = $("ul li"); // определяем количество элементом в выборке var total = myList.length; // осуществляем перебор выбранных элементов myList.each(function(index) { if (index === total - 1) { // это последний элемент в выборке } });
The forEach() method executes a provided function once for each array element.
The source for this interactive example is stored in a GitHub repository. If you"d like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax arr .forEach(callback(currentValue [, index [, array]]) [, thisArg ]) Parameters callback Function to execute on each element. It accepts between one and three arguments: currentValue The current element being processed in the array. index Optional The index currentValue in the array. array Optional The array forEach() was called upon. thisArg Optional Value to use as this when executing callback . Return value DescriptionforEach() calls a provided callback function once for each element in an array in ascending order. It is not invoked for index properties that have been deleted or are uninitialized. (For sparse arrays, .)
callback is invoked with three arguments:
If a thisArg parameter is provided to forEach() , it will be used as callback"s this value. The thisArg value ultimately observable by callback is determined according to the usual rules for determining the this seen by a function .
The range of elements processed by forEach() is set before the first invocation of callback . Elements which are appended to the array after the call to forEach() begins will not be visited by callback . If existing elements of the array are changed or deleted, their value as passed to callback will be the value at the time forEach() visits them; elements that are deleted before being visited are not visited. If elements that are already visited are removed (e.g. using shift()) during the iteration, later elements will be skipped. (See this example, below .)
forEach() executes the callback function once for each array element; unlike map() or reduce() it always returns the value undefined and is not chainable. The typical use case is to execute side effects at the end of a chain.
forEach() does not mutate the array on which it is called. (However, callback may do so)
There is no way to stop or break a forEach() loop other than by throwing an exception. If you need such behavior, the forEach() method is the wrong tool.
Early termination may be accomplished with:
Array methods: every() , some() , find() , and findIndex() test the array elements with a predicate returning a truthy value to determine if further iteration is required.
Examples No operation for uninitialized values (sparse arrays) const arraySparse = let numCallbackRuns = 0 arraySparse.forEach(function(element){ console.log(element) numCallbackRuns++ }) console.log("numCallbackRuns: ", numCallbackRuns) // 1 // 3 // 7 // numCallbackRuns: 3 // comment: as you can see the missing value between 3 and 7 didn"t invoke callback function. Converting a for loop to forEach const items = ["item1", "item2", "item3"] const copy = // before for (let i = 0; i < items.length; i++) { copy.push(items[i]) } // after items.forEach(function(item){ copy.push(item) }) Printing the contents of an arrayNote: In order to display the content of an array in the console, you can use console.table() , which prints a formatted version of the array.
The following example illustrates an alternative approach, using forEach() .
The following code logs a line for each element in an array:
Function logArrayElements(element, index, array) { console.log("a[" + index + "] = " + element) } // Notice that index 2 is skipped, since there is no item at // that position in the array... .forEach(logArrayElements) // logs: // a = 2 // a = 5 // a = 9
Using thisArgThe following (contrived) example updates an object"s properties from each entry in the array:
Function Counter() { this.sum = 0 this.count = 0 } Counter.prototype.add = function(array) { array.forEach(function(entry) { this.sum += entry ++this.count }, this) // ^---- Note } const obj = new Counter() obj.add() obj.count // 3 obj.sum // 16
Since the thisArg parameter (this) is provided to forEach() , it is passed to callback each time it"s invoked. The callback uses it as its this value.
An object copy functionThe following code creates a copy of a given object.
There are different ways to create a copy of an object. The following is just one way and is presented to explain how Array.prototype.forEach() works by using ECMAScript 5 Object.* meta property functions.
Function copy(obj) { const copy = Object.create(Object.getPrototypeOf(obj)) const propNames = Object.getOwnPropertyNames(obj) propNames.forEach(function(name) { const desc = Object.getOwnPropertyDescriptor(obj, name) Object.defineProperty(copy, name, desc) }) return copy } const obj1 = { a: 1, b: 2 } const obj2 = copy(obj1) // obj2 looks like obj1 now
If the array is modified during iteration, other elements might be skipped.The following example logs "one" , "two" , "four" .
When the entry containing the value "two" is reached, the first entry of the whole array is shifted off-resulting in all remaining entries moving up one position. Because element "four" is now at an earlier position in the array, "three" will be skipped.
forEach() does not make a copy of the array before iterating.
Let words = ["one", "two", "three", "four"] words.forEach(function(word) { console.log(word) if (word === "two") { words.shift() } }) // one // two // four
Flatten an arrayThe following example is only here for learning purpose. If you want to flatten an array using built-in methods you can use Array.prototype.flat() (which is expected to be part of ES2019, and is already implemented in some browsers).
/** * Flattens passed array in one dimensional array * * @params {array} arr * @returns {array} */ function flatten(arr) { const result = arr.forEach((i) => { if (Array.isArray(i)) { result.push(...flatten(i)) } else { result.push(i) } }) return result } // Usage const problem = , 8, 9]] flatten(problem) //
Note on using Promises or async functions let ratings = let sum = 0 let sumFunction = async function (a, b) { return a + b } ratings.forEach(async function(rating) { sum = await sumFunction(sum, rating) }) console.log(sum) // Expected output: 14 // Actual output: 0 Specifications| ECMAScript Latest Draft (ECMA-262) |
Draft | |
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of "Array.prototype.forEach" in that specification. |
Standard | |
| ECMAScript 5.1 (ECMA-262) The definition of "Array.prototype.forEach" in that specification. |
Standard | Initial definition. Implemented in JavaScript 1.6. |
The compatibility table in this page is generated from structured data. If you"d like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
| Desktop Mobile Server | ||||||||||||
| Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet Node.js | ||||||||||||
| Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1.5 | IE Full support 9 | Opera Full support Yes | Safari Full support 3 | WebView Android Full support ≤37 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 | nodejs Full support Yes |
Последнее обновление: 26.03.2018
Объект Array представляет массив и предоставляет ряд свойств и методов, с помощью которых мы можем управлять массивом.
Инициализация массиваМожно создать пустой массив, используя квадратные скобки или конструктор Array:
Var users = new Array(); var people = ; console.log(users); // Array console.log(people); // Array
Можно сразу же инициализировать массив некоторым количеством элементов:
Var users = new Array("Tom", "Bill", "Alice"); var people = ["Sam", "John", "Kate"]; console.log(users); // ["Tom", "Bill", "Alice"] console.log(people); // ["Sam", "John", "Kate"]
Можно определить массив и по ходу определять в него новые элементы:
Var users = new Array(); users = "Tom"; users = "Kate"; console.log(users); // "Tom" console.log(users); // undefined
При этом не важно, что по умолчанию массив создается с нулевой длиной. С помощью индексов мы можем подставить на конкретный индекс в массиве тот или иной элемент.
lengthЧтобы узнать длину массива, используется свойство length :
Var fruit = new Array();
fruit = "яблоки";
fruit = "груши";
fruit = "сливы";
document.write("В массиве fruit " + fruit.length + " элемента:
");
for(var i=0; i < fruit.length; i++)
document.write(fruit[i] + "
");
По факту длиной массива будет индекс последнего элемента с добавлением единицы. Например:
Var users = new Array(); // в массиве 0 элементов users = "Tom"; users = "Kate"; users = "Sam"; for(var i=0; i 0) { result = true; } return result; }; var passed = numbers.every(condition); document.write(passed); // false
В метод every() в качестве параметра передается функция, представляющая условие. Эта функция принимает три параметра:
Function condition(value, index, array) { }
Параметр value представляет текущий перебираемый элемент массива, параметр index представляет индекс этого элемента, а параметр array передает ссылку на массив.
В этой функции мы можем проверить переданное значение элемента на соответствие какому-нибудь условию. Например, в данном примере мы проверяем каждый элемент массива, больше ли он нуля. Если больше, то возвращаем значение true , то есть элемент соответствует условию. Если меньше, то возвращаем false - элемент не соответствует условию.
В итоге, когда происходит вызов метода numbers.every(condition) он перебирает все элементы массива numbers и по очереди передает их в функцию condition . Если эта функция возвращает значение true для всех элементов, то и метод every() возвращает true . Если хотя бы один элемент не соответствует условию, то метод every() возвращает значение false .
some()Метод some() похож на метод every() , только он проверяет, соответствует ли хотя бы один элемент условию. И в этом случае метод some() возвращает true . Если элементов, соответствующих условию, в массиве нет, то возвращается значение false:
Var numbers = [ 1, -12, 8, -4, 25, 42 ]; function condition(value, index, array) { var result = false; if (value === 8) { result = true; } return result; }; var passed = numbers.some(condition); // true
filter()Метод filter() , как some() и every() , принимает функцию условия. Но при этом возвращает массив тех элементов, которые соответствуют этому условию:
Var numbers = [ 1, -12, 8, -4, 25, 42 ];
function condition(value, index, array) {
var result = false;
if (value > 0) {
result = true;
}
return result;
};
var filteredNumbers = numbers.filter(condition);
for(var i=0; i < filteredNumbers.length; i++)
document.write(filteredNumbers[i] + "
");
Вывод в браузере:
1 8 25 42
forEach() и map()Методы forEach() и map() осуществляют перебор элементов и выполняют с ними определенный операции. Например, для вычисления квадратов чисел в массиве можно использовать следующий код:
Var numbers = [ 1, 2, 3, 4, 5, 6]; for(var i = 0; i= 0; --index) { console.log(a); }
Тем не менее, в современных движках JavaScript подобные игры с оптимизацией обычно ничего не значат.
3. Правильное использование цикла for...inЕсли вам посоветуют использовать цикл for...in , помните, что перебор массивов - не то, для чего он предназначен . Вопреки распространенному заблуждению цикл for...in перебирает не индексы массива, а перечислимые свойства объекта.
Тем не менее, в некоторых случаях, таких как перебор разреженных массивов , for...in может оказаться полезным, если только соблюдать при этом меры предосторожности, как показано в примере ниже:
// a - разреженный массив var a = ; a = "a"; a = "b"; a = "c"; for (var key in a) { if (a.hasOwnProperty(key) && /^0$|^d*$/.test(key) && key
