Функция $.map(): преобразование массива или объекта

Функция $.map() позволяет изменить каждый элемент массива или объекта. Возвращает новый массив. Применяется как обычная функция, объявленная в пространстве имен библиотеки jQuery. Имеет следующий синтаксис:

<Новый массив> = $.map(<Массив или объект>, <Функция обратного вызова>)

В параметре <Функция обратного вызова> указывается ссылка на функцию следующего формата:

function <Название функции>(<Значение>[, <Индекс или свойство>]) {
   // ...
}

Чтобы изменить текущее значение элемента массива, необходимо внутри функции обратного вызова вернуть новое значение. В качестве примера умножим все элементы массива на 2:

var arr = [ 1, 2, 3 ];
arr = $.map(arr, function(val) {
   return val * 2;
});
console.log( arr.join(', ') );

Результат:

2, 4, 6

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

var arr = [ 1, 2, 3 ];
arr = $.map(arr, function(val, ind) {
   if (ind === 1) {
      return val * 2;
   }
   else if (ind === 0) {
      return null;
   }
   else {
      return val;
   }
});
console.log( arr.join(', ') );

Результат:

4, 3

Внутри функции обратного вызова можно вернуть массив со значениями. В качестве примера преобразуем объект в массив:

var obj = { a: 1, b: 2, c: 3 };
var arr = $.map(obj, function(val, key) {
   return [ key, val ];
});
console.log( arr.join(', ') );

Результат:

a, 1, b, 2, c, 3

Учебник по jQuery и AJAX в формате PDF