Объект Array.

  Array - Массивы любых типов данных.
  Экземпляр доступен:

  1. В выражении

        new Array([Значение0[, Значение1[, ...[, ЗначениеN]]]])

            или:

        new Array(Значение)

    где:
    • new - Ключевое слово.
    • Array - Имя функции конструктора объекта Array.
    • Значение - Операнд значения, задающий значение элемента массива.
        Если указано одно значение без квадратных скобок, то оно должно быть целым положительным числом, и это значение воспринимается как размер (количество элементов) массива.

  2. В выражении

        new Object(Массив)

    где:
    • new - Ключевое слово.
    • Object - Имя функции конструктора всех объектов JavaScript.
    • Массив - Любой формат значения массива

  3. В любом операнде значения со значением типа array.

  4. С помощью универсального метода valueOf.
  Свойства.
  length - Содержит количество элементов массива.
  Значение имеет числовой формат.
  Поскольку первый элемент массива имеет номер равный 0, то значение length равно номеру последнего элемента, увеличенному на 1.
  При этом не все элементы с меньшим номером, чем значение length, могут иметь значения, вернее некоторые из этих элементов могут иметь значение undefined.
  То есть значение length не всегда совпадает с количеством значимых элементов массива.
  Значение свойства length не учитывает элементы соответствующего массива с ассоциативными указателями.

    Формат записи в коде скрипта:

  • Экземпляр объекта Array.length[= Значение]

    Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к свойству объекта.
  • length - Ключевое слово.
  • = - Оператор присвоения. Ключевое слово в этом формате.
  • Значение - Количество элементов массива заданное в любом числовом формате.
      Соответственно изменение значения свойства length может привести к потере некоторых элементов.
      Однако после применения некоторых методов (например sort) в массив могут попасть "лишние" элементы со значением undefined. Возможность изменения значения length позволяет избавиться от таких элементов.
  Методы.
  concat - Возвращает новый массив, добавив к массиву, указанному экземпляром объекта, последовательно новые элементы после его последнего элемента.
  Номер последнего элемента массива всегда равен значению length уменьшенному на 1.

    Формат записи в коде скрипта:

  • Экземпляр объекта Array.concat([Значение1[, Значение2[, ...[, ЗначениеN]]]])

    Значения формата записи:

  copyWithin - Замещает заданные элементы в массиве, указанном экземпляром объекта, копиями других заданных элементов из этого же массива.
  Возвращает этот же экземпляр объекта Array с изменёнными значениями элементов.
  Значения замещенных элементов теряются.

    Формат записи в коде скрипта:

  • Экземпляр объекта Array.copyWithin(Начальный индекс цели, Начальный индекс источника
          [, Конечный индекс источника])

    Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • copyWithinf - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Начальный индекс цели - Любой тип значения задающего индекс, с которого должны замещаться элементы.
      Если значение начального индекса цели меньше 0, то оно рассчитывается как length + значение индекса.
      Если значение рассчитанного начального индекса цели будет меньше 0, то оно устанавливается в 0.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • Начальный индекс источника - Любой тип значения задающего индекс, с которого должны копироваться элементы для замены.
      Если значение начального индекса источника меньше 0, то оно рассчитывается как length + значение индекса.
      Если значение рассчитанного начального индекса источника будет меньше 0, то оно устанавливается в 0.
  • Конечный индекс источника - Любой тип значения задающего индекс, до которого (исключительно) должны копироваться элементы для замены.
      Если значение конечного индекса источника меньше 0, то оно рассчитывается как length + значение индекса.
      Если значение рассчитанного конечного индекса источника будет меньше 0, то оно устанавливается в 0.
      Если этот аргумент не указан, или его значение ведет за верхний предел массива, то копируются значения всех оставшихся после начального индекса источника элементов массива.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  Начиная с элемента, на который укажет начальный индекс цели, метод copyWithinf заменит n элементов, где n = конечный индекс источника - начальный индекс источника.
  entries - Возвращает ссылку на интерфейс Array Iterator к последовательности пар индекс - значение каждого элемента массива.
  Каждое значение в последовательности будет являться массивом из двух элементов. Значением первого элемента этого массива будет являться индекс пары, а второго элемента значение пары.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.entries()

Значения формата записи:

  every - Вызывает заданную функцию столько раз, сколько элементов в массиве указанном экземпляром объекта.
  Возвращает значение true, если все вызовы функции вернут значения true.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.every(Функция[, Объект])

Значения формата записи:

  fill - Замещает значения заданных элементов в массиве, указанном экземпляром объекта, одним заданным значением.
  Возвращает этот же экземпляр объекта Array с изменёнными значениями элементов.
  Значения замещенных элементов теряются.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.fill(Значение[, Начальный индекс[, Конечный индекс]])

Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • fill - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Значение - Любой тип значения, которым будут замещены значения соответствующих элементов массива.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • Начальный индекс - Любой тип значения индекса, с которого должны замещаться значения элементов.
      Если значение начального индекса меньше 0, то оно рассчитывается как length + значение индекса.   Если значение рассчитанного начального индекса будет меньше 0, то оно устанавливается в 0.
  • Конечный индекс - Любой тип значения индекса, до которого (исключительно) должны замещаться значения элементов.
      Если значение конечного индекса меньше 0, то оно рассчитывается как length + значение индекса.
      Если значение рассчитанного конечного индекса будет меньше 0, то оно устанавливается в 0.
      Если этот аргумент не указан, или его значение ведет за верхний предел массива, то замещаются значения всех оставшихся после начального индекса элементов массива.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  filter - Вызывает заданную функцию столько раз, сколько элементов в массиве указанном экземпляром объекта.
  Возвращает новый массив с элементами указанного массива, для которых эта функция вернет значение true.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.filter(Функция[, Объект])

Значения формата записи:

  find - Вызывает заданную функцию столько раз, сколько элементов в массиве указанном экземпляром объекта.
  Возвращает первый элемент массива, для которого эта функция вернет значение true.
  Если ни один элемент не выберется, то метод find вернёт значение undefined.
  Перебор всегда ведётся от начала к концу массива.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.find(Функция[, Объект])

Значения формата записи:

  findIndex - Вызывает заданную функцию столько раз, сколько элементов в массиве указанном экземпляром объекта.
  Возвращает индекс первого элемента массива, для которого эта функция вернет значение true.
  Если ни один элемент не выберется, то метод findIndex вернёт значение -1.
  Перебор всегда ведётся от начала к концу массива.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.findIndex(Функция[, Объект])

Значения формата записи:

  forEach - Вызывает заданную функцию один раз для каждого элемента массива указанным экземпляром объекта.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.forEach(Функция[, Объект])

Значения формата записи:

  includes - Проверяет в массиве, указанном экземпляром объекта, наличие элемента с заданным значением.
  Возвращает значение true если искомый элемент найден, и значение false - в противном случае.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.includes(Значение[, Начальный индекс])

Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • includes - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Значение - Любой тип значения элемента для проверки.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • Начальный индекс - Любой тип значения индекса, с которого должны проверяться значения элементов.
      Если значение начального индекса меньше 0, то оно рассчитывается как length + значение индекса.
      Если значение рассчитанного начального индекса будет меньше 0, то оно устанавливается в 0.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  indexOf - Возвращает индекс заданного элемента в массиве указанном экземпляром объекта.
  Если элемент не найдётся в массиве, то метод indexOf вернёт значение -1

Формат записи в коде скрипта:

  • Экземпляр объекта Array.indexOf(Значение[, Индекс])

Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • indexOf - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Значение - Любой тип значения элемента поиска.
      Поиск всгда ведётся от начала к концу массива.
      При поиске применяется строгое сравнение.
      Если элемент с заданным значением повторяется в массиве, то метод indexOf вернёт самый первый его индекс по ходу поиска.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • Индекс - Любой тип значения индекса элемента массива, с которого должен быть начат поиск.
      Если значение индекса больше или равно количества элементов в массиве (с учётом того, что индекс первого элемента равен 0), то метод indexOf вернёт значение -1.
      Если значение индекса меньше 0, то оно рассчитывается как length + значение индекса.
      Если значение рассчитанного индекса будет меньше 0, то оно устанавливается в 0.
      Если значение индекса не задано, то оно считается равным 0 (номер первого элемента).
  • ) - Оператор группировки. Ключевое слово в этом формате.
  join - Возвращает строку всех значений элементов массива, указанного экземпляром объекта, разделенных заданным разделителем.
  Все значения элементов, кроме значений undefined будут преобразованы в строковый формат.
  Значения undefined преобразуются в пустые (не в пробелы!), однако количество разделителей в возвращенной строке будет равно значению length.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.join([Разделитель])

Значения формата записи:

  keys - Возвращает ссылку на интерфейс Array Iterator к последовательности индексов элементов массива.
  Каждое значение в последовательности будет являться значением индекса соответствующего элемента массива.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.keys()

Значения формата записи:

  lastIndexOf - Возвращает индекс заданного элемента в массиве указанном экземпляром объекта.
  Если элемент не найдётся в массиве, то метод lastIndexOf вернёт значение -1.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.lastIndexOf(Значение[, Индекс])

Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • lastIndexOf - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Значение - Любой тип значения элемента поиска.
      Поиск всгда ведётся от конца к началу массива.
      При поиске применяется строгое сравнение.
      Если элемент с заданным значением повторяется в массиве, то метод lastIndexOf вернёт значение первого его индекса по ходу поиска.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • Индекс - Любой тип значения индекса, с которого должен быть начат поиск.
      Если значение индекса больше или равно количества элементов в массиве (с учётом того, что индекс первого элемента равен 0), то метод lastIndexOf вернёт значение -1.
      Если значение индекса меньше 0, то оно рассчитывается как length + значение индекса.
      Если значение рассчитанного индекса будет меньше 0, то оно устанавливается в 0.
      Если значение индекса не задано, то оно считается равным значению length - 1 (номер последнего элемента).
  • ) - Оператор группировки. Ключевое слово в этом формате.
  map - Вызывает заданную функцию столько раз, сколько элементов в массиве указанном экземпляром объекта.
  Возвращает новый массив с элементами, значения которых вернет эта функция при обработке каждого текущего элемента указанного массива.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.map(Функция[, Объект])

Значения формата записи:

  pop - Возвращает значение последнего элемента массива, указанного экземпляром объекта, одновременно удаляя его из массива.
  Номер последнего элемента массива всегда равен значению length уменьшенному на 1.
  Значение возвращается в одном из форматов JavaScript.
  Соответственно изменится значение свойства length.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.pop()

Значения формата записи:

  push - Добавляет последовательно после последнего элемента массива, указанного экземпляром объекта, новые элементы и возвращает их итоговое количество.
  Номер последнего элемента массива всегда равен значению length уменьшенному на 1.
  Значение возвращается в числовом формате.
  Новый экземпляр объекта Array не создается, а в исходном, соответственно, изменится значение свойства length.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.push([Значение1[, Значение2[, ...[,ЗначениеN]]]])

Значения формата записи:

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

Формат записи в коде скрипта:

  • Экземпляр объекта Array.reduce(Функция[, Начальное значение])

Значения формата записи:

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

Формат записи в коде скрипта:

  • Экземпляр объекта Array.reduceRight(Функция[, Начальное значение])

Значения формата записи:

  reverse - Переставляет элементы массива, указанного экземпляром объекта, в обратном порядке от исходного.
  Возвращает новый экземпляр объекта Array.
  В исходном массиве элементы также переставляются (в том числе и элементы со значениями undefined).

Формат записи в коде скрипта:

  • Экземпляр объекта Array.reverse()

Значения формата записи:

  shift - Возвращает значение первого элемента массива, указанного экземпляром объекта, одновременно удаляя его.
  Номер первого элемента массива равен 0.
  Значение возвращается в одном из форматов JavaScript.
  Соответственно изменится значение свойства length.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.shift()

Значения формата записи:

  slice - Возвращает новый массив из заданных элементов массива, указанного экземпляром объекта.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.slice(Начальный номер[, Конечный номер])

Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • slice - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Начальный номер - Номер элемента массива, заданный в любом числовом формате, с которого начинается выборка его фрагмента.
      Если значение начального номера отрицательное, то оно переопределяется итерациями - значение length + значение начального номера до тех пор, пока не получится положительное значение. Оно и будет использоваться для выборки.
      Если значение начального номера больше значения length-1, то метод slice вернёт пустой массив.
      Если аргумент начальный номер опущен а аргумент конечный номер задан, то возникнет ошибка времени выполнения.
  • Конечный номер - Номер элемента массива, заданный в любом числовом формате, на котором заканчивается выборка его фрагмента.
      Сам элемент с конечным номером не выбирается.
      Если значение конечного номера отрицательно, то оно переопределяется итерациями - значение length + значение конечного номера до тех пор, пока не получится положительное значение. Оно и будет использоваться для выборки.
      Если конечный номер не указан, то фрагмент ограничивается последним элементом исходного массива (включительно).
      Если разность значений начального номера и конечного номера получится меньше 2, то метод slice вернёт массив со значением length равным 0.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  Если оба аргумента метода slice опущены, то новый массив получится полностью идентичным исходному.
  some - Вызывает заданную функцию столько раз, сколько элементов в массиве указанного экземпляром объекта.
  Возвращает значение true, если хотя бы один вызов функции вернет значение true.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.some(Функция[, Объект])

Значения формата записи:

  sort - Сортирует элементы массива, указанного экземпляром объекта.
  Возвращает отсортированный массив.
  В исходном массиве элементы также отсортируются.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.sort([Функция])

Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • sort - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Функция - Операнд значения, содержащий функцию.
      У этой функции должны быть определены два аргумента, и она должна возвращать следующие числовые значения:
    1. Отрицательное значение, если значение первого аргумента "меньше" (по критерию разработчика) значения второго аргумента.
    2. Ноль, если значение первого аргумента "равно" (по критерию разработчика) значению второго аргумента.
    3. Положительное значение, если значение первого аргумента "больше" (по критерию разработчика) значения второго аргумента.
      Эта функция будет последовательно вызываться методом sort, пока элементы исходного массива не отсортируются в соответствии с критерием разработчика.
      При вызове метода sort без аргумента, элементы массива отсортируются в порядке возрастания по ASCII.
      При этом все элементы со значением undefined окажутся после последнего значимого элемента массива, но значение length не изменится. Во избежание возможных коллизий разработчику следует позаботиться об этом самому.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  splice - Возвращает новый массив с заданными элементами массива, указанного экземпляром объекта, и удаляет эти элементы из исходного, или замещает их элементами с указанными значениями.
  Соответственно в исходном экземпляре объекта Array изменится значение свойства length.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.splice(Начальный номер, Количество [, Значение1[, Значение2[, ...[, ЗначениеN]]]])

Значения формата записи:

  • Экземпляр объекта Array - Любой операнд значения со значением экземпляра объекта Array.
  • . - Оператор доступа к методу объекта.
  • splice - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Начальный номер - Номер элемента массива, с которого начинается выборка его фрагмента.
      Если значение начального номера отрицательное, то оно переопределяется итерациями - значение length + значение начального номера до тех пор, пока не получится положительное значение. Оно и будет использоваться для выборки.
      Если начальный номер опущен, то возникнет ошибка времени выполнения.
      Если значение начального номера больше значения length-1, то метод splice вернёт пустой массив, а в исходный, при наличии аргументов значение, добавятся новые элементы после его последнего элемента.
  • Количество - Любой операнд значения со значением равным целому положительному числу - количество удаляемых или замещаемых элементов, начиная с элемента, заданного начальным номером.
      Если аргумент опущен, то возникнет ошибка времени выполнения.
      Если значение аргумента больше количества элементов массива, начиная с начального номера, то удалятся или будут замещены все оставшиеся элементы. Соответственно сформируется возвращаемый массив.
      Если значение аргумента равно 0,то метод splice вернёт пустой массив, а в исходный, при наличии аргументов значение, добавятся новые элементы после его элемента с номером равным значению аргумента начальный номер.
  • Значение - Операнд значения, который определяет значение нового элемента массива вместо удаленного.
      Не может быть массивом, а только его элементом.
      Количество аргументов значение может не совпасть со значением аргумента количество - результат понятен.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  toLocaleString - Возвращает строку значений элементов массива, указанного экземпляром объекта, разделенных запятыми.
  Значения элементов, кроме значений undefined будут преобразованы в строковый формат с учетом системного окружения браузера.
  Значения undefined преобразуются в пустые (не в пробелы!), однако количество запятых в возвращаемой строке будет равно значению length.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.toLocaleString()

Значения формата записи:

  unshift - Добавляет новые элементы перед первым элементом массива, указанного экземпляром объекта и возвращает их итоговое количество.
  Номер первого элемента массива равен 0.
  Значение возвращается в числовом формате.
  Новый экземпляр объекта Array не создается, а в исходном изменится значение свойства length.

Формат записи в коде скрипта:

  • Экземпляр объекта Array.unshift([Значение1[, Значение2[, ...[, ЗначениеN]]]])

Значения формата записи: