★ wanayoo — archive 1999 https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Array/concatNouvelle recherche | Portail wanayoo

Check out Firefox Developer Edition, the first browser built for developers like you. http://mzl.la/112VrtT

mozilla
Your Search Results

    Array.prototype.concat()

    Сводка

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

    Синтаксис

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

    Параметры

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

    Описание

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

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

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

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

    Примеры

    Пример: соединение двух массивов

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

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

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

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

    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]
    

    Пример: соединение значений в массив

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

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

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

    Спецификация Статус Комментарии
    ECMAScript 3-е издание Стандарт Изначальное определение. Реализована в JavaScript 1.2.
    ECMAScript 5.1 (ECMA-262)
    Определение 'Array.prototype.concat' в этой спецификации.
    Стандарт  
    ECMAScript 6 (ECMA-262)
    Определение 'Array.prototype.concat' в этой спецификации.
    Черновик  

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

    Help improve compatibility tables by filling out this 11 question survey.
    Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Базовая поддержка 1.0 1.0 (1.7 или ранее) 5.5 (Да) (Да)
    Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

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

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

    Метки документа и участники

    На данную страницу внесли свой вклад: Mingun
    Обновлялась последний раз: Mingun,
    Скрыть боковую панель