Movatterモバイル変換


[0]ホーム

URL:


MDN Web Docs

Эта страница была переведена с английского языка силами сообщества. Вы тоже можете внести свой вклад, присоединившись к русскоязычному сообществу MDN Web Docs.

Array.prototype.concat()

BaselineWidely available

Методconcat() возвращает новый массив, состоящий из массива, на котором он был вызван, соединённого с другими массивами и/или значениями, переданными в качестве аргументов.

Интерактивный пример

const array1 = ["a", "b", "c"];const array2 = ["d", "e", "f"];const array3 = array1.concat(array2);console.log(array3);// Expected output: Array ["a", "b", "c", "d", "e", "f"]

Синтаксис

var new_array = old_array.concat(value1[, value2[, ...[, valueN]]])

Параметры

valueN

Массивы и/или значения, соединяемые в новый массив. Смотрите описание ниже.

Возвращаемое значение

Новый экземплярArray.

Описание

Методconcat создаёт новый массив, состоящий из элементов в объекте, на котором он был вызван, за которыми по порядку следуют, для каждого аргумента, все его элементы (если аргумент является массивом), либо сам аргумент (если он массивом не является).

Методconcat не изменяет данный массив или любой из массивов, переданных в аргументах, а вместо этого возвращает поверхностную копию, содержащую копии тех элементов, что были объединены с исходными массивами. Элементы оригинальных массивов копируются в новый массив по следующим правилам:

  • Ссылки на объекты (но не фактические объекты): методconcat копирует ссылки на объекты в новый массив. И оригинал, и новый массив ссылаются на один и тот же объект. То есть, если объект по ссылке будет изменён, изменения будут видны и в новом, и в исходном массивах.
  • Строки, числа и булевы значения (но не объектыString,Number илиBoolean): методconcat копирует значения строк и чисел в новый массив.

Примечание:Соединение массивов и/или значений в новый массив оставит соединяемые массивы/значения неизменными. Кроме того, любая операция над новым массивом (если только элемент не является ссылкой) не будет затрагивать исходные массивы и наоборот.

Примеры

Соединение двух массивов

Следующий код соединяет два массива:

js
var alpha = ["a", "b", "c"],  numeric = [1, 2, 3];var alphaNumeric = alpha.concat(numeric);console.log(alphaNumeric); // Результат: ['a', 'b', 'c', 1, 2, 3]

Соединение трёх массивов

Следующий код соединяет три массива:

js
var num1 = [1, 2, 3],  num2 = [4, 5, 6],  num3 = [7, 8, 9];var nums = num1.concat(num2, num3);console.log(nums); // Результат: [1, 2, 3, 4, 5, 6, 7, 8, 9]

Соединение значений в массив

Следующий код соединяет три значения в массив:

js
var alpha = ["a", "b", "c"];var alphaNumeric = alpha.concat(1, [2, 3]);console.log(alphaNumeric); // Результат: ['a', 'b', 'c', 1, 2, 3]

Спецификации

Specification
ECMAScript® 2026 Language Specification
# sec-array.prototype.concat

Совместимость с браузерами

Смотрите также

  • push /pop — добавление / удаление элементов с конца массива
  • unshift /shift — добавление / удаление элементов с начала массива
  • splice — добавление / удаление элементов в указанной позиции массива
  • String.prototype.concat()
  • Symbol.isConcatSpreadable — управление уменьшением размерности массива

Help improve MDN

Learn how to contribute.

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2025 Movatter.jp