Ноутбуки 

JQuery - Перебор массива, объекта и элементов. Как создать ассоциативный массив в JavaScript I

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

JavaScript метод forEach() позволяет выполнить переданную функцию один раз для каждого элемента в массиве в порядке возрастания индекса.

Обращаю Ваше внимание, что функция обратного вызова, переданная в качестве параметра метода forEach() не будет вызвана для удалённых, или пропущенных элементов массива.

Диапазон элементов, обрабатываемых с помощью метода forEach() устанавливается перед первым вызовом функции обратного вызова. Если элементы были добавлены к массиву после её вызова, то на таких элементах функция вызвана не будет.

Если значения существующих элементов массива изменяются в момент выполнения, то в качестве передаваемого значения функции будет значение в тот момент времени, когда метод forEach() посещает их. Если элементы удаляются до их посещения, то такие элементы посещены не будут. Если элементы, которые уже посещены, удаляются во время прохода по массиву, то более поздние элементы будут пропущены.

Поддержка браузерами Метод
Opera
IExplorer
Edge
forEach() Да Да Да Да 9.0 Да
JavaScript синтаксис: // только с callback функцией array .forEach(function (currentValue , index , arr )); // с использованием объекта, на который может ссылаться ключевое слово this array .forEach(function (currentValue , index , arr ), thisValue ); Версия JavaScript ECMAScript 5.1 (Реализовано в JavaScript 1.6) Значения параметров Параметр Описание
function Функция обратного вызова, которая будет выполнена один раз для каждого элемента в массиве. Функция принимает следующие параметры:
  • currentValue - значение текущего элемента
  • index - индекс массива текущего элемента.
  • arr - массив, к которому принадлежит текущий элемент (по которому происходит проход).

Если в качестве параметра метода передается что-то, что не является объектом функции, то будет вызвано исключение TypeError . Обязательный параметр.

thisValue Объект, на который может ссылаться ключевое слово this внутри функции обратного вызова. Если параметр thisValue не используется, то в качестве значения this будет использоваться undefined (в конечном счете this будет зависеть от обычных правил контекста выполнения функции). Необязательный параметр.
Пример использования

В следующем примере мы рассмотрим как получить сумму всех элементов массива с использованием JavaScript метода forEach() :

var array = ; var sum = 0 ; // инициализируем переменную, содержащую числовое значение array .forEach(// перебираем все элементы массива array function sumNumber(currentValue ) { sum += currentValue ; } ); console .log(sum ); // выводим значение переменной sum равное 50

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

var numbers = ; // инициализируем переменную, содержащую массив числовых значений var squared = ; // инициализируем переменную, содержащую пустой массив var myObject = { // инициализируем переменную, содержащую объект square: function (currentValue ) { // метод объекта, который принимает значение return currentValue * currentValue ; // и возвращает его возведенным в квадрат } } ; numbers .forEach(// перебираем все элементы массива numbers function (currentValue ) { squared .push(this .square(currentValue )); // добавляем в массив squared возвращаемое значение метода square объекта myObject } , myObject // объект, на который мы ссылаемся с использованием ключевого слова this ); console .log(squared ); // выводим значение переменной squared равное ;

Статья, в которой рассмотрим на примерах использование функции и метода библиотеки 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
$("ul#myList").children().each(function(){ console.log($(this).text()); }); // Результат: // HTML // CSS // 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 Description

forEach() 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:

  • the value of the element
  • the index of the element
  • the Array object being traversed

    • 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 array

    Note: 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 thisArg

    The 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 function

    The 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 array

    The 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 Specification Status Comment
    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.
    Browser compatibility

    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 forEach
    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
    • I. Перебор настоящих массивов
    • Метод forEach и родственные методы
    • Цикл for
    • Правильное использование цикла for...in
    • Цикл for...of (неявное использование итератора)
    • Явное использование итератора
    • Использование способов перебора настоящих массивов
    • Преобразование в настоящий массив
    • Замечание по объектам среды исполнения
    I. Перебор настоящих массивов На данный момент есть три способа перебора элементов настоящего массива:
  • метод Array.prototype.forEach ;
  • классический цикл for ;
  • «правильно» построенный цикл for...in .
    • Кроме того, в скором времени, с появлением нового стандарта ECMAScript 6 (ES 6), ожидается еще два способа:
  • цикл for...of (неявное использование итератора);
  • явное использование итератора.
    • 1. Метод forEach и родственные методы Если ваш проект рассчитан на поддержку возможностей стандарта ECMAScript 5 (ES5), вы можете использовать одно из его нововведений - метод forEach .

    Пример использования:
    var a = ["a", "b", "c"]; a.forEach(function(entry) { console.log(entry); });
    В общем случае использование forEach требует подключения библиотеки эмуляции es5-shim для браузеров, не имеющих нативной поддержки этого метода. К ним относятся IE 8 и более ранние версии, которые до сих пор кое-где еще используются.

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

    Если вас беспокоят возможные затраты на вызов колбека для каждого элемента, не волнуйтесь и прочитайте это .

    ForEach предназначен для перебора всех элементов массива, но кроме него ES5 предлагает еще несколько полезных методов для перебора всех или некоторых элементов плюс выполнения при этом каких-либо действий с ними:

    • every - возвращает true , если для каждого элемента массива колбек возвращает значение приводимое к true .
    • some - возвращает true , если хотя бы для одного элемента массива колбек возвращает значение приводимое к true .
    • filter - создает новый массив, включающий те элементы исходного массива, для которых колбек возвращает true .
    • map - создает новый массив, состоящий из значений возращаемых колбеком.
    • reduce - сводит массив к единственному значению, применяя колбек по очереди к каждому элементу массива, начиная с первого (может быть полезен для вычисления суммы элементов массива и других итоговых функций).
    • reduceRight - работает аналогично reduce, но перебирает элементы в обратном порядке.
    2. Цикл forСтарый добрый for рулит :

    Var a = ["a", "b", "c"]; var index; for (index = 0; index < a.length; ++index) { console.log(a); }
    Если длина массива неизменна в течение всего цикла, а сам цикл принадлежит критическому в плане производительности участку кода (что маловероятно), то можно использовать «более оптимальную» версию for с хранением длины массива:

    Var a = ["a", "b", "c"]; var index, len; for (index = 0, len = a.length; index < len; ++index) { console.log(a); }
    Теоретически этот код должен выполняться чуть быстрее, чем предыдущий.

    Если порядок перебора элементов не важен, то можно пойти еще дальше в плане оптимизации и избавиться от переменной для хранения длины массива, изменив порядок перебора на обратный:

    Var a = ["a", "b", "c"]; var index; for (index = a.length - 1; index >= 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