Array.prototype.concat()

Method concat() mengembalikan sebuah array baru yang terdiri dari array yang dipanggil kemudian digabung dengan array dan/atau nilai yang ditambahkan pada argumen.

Syntax

var array_baru = array_lama.concat(value1[, value2[, ...[, valueN]]])

Parameter

valueN

Array dan/atau nilai untuk digabung menjadi array baru. Untuk detailnya lihat deskripsi dibawah.

Deskripsi

concat menciptakan array baru yang terdiri dari unsur - unsur dalam object yang disebut, berdasarkan urutannya, setiap argumen, elemen dari argumen tersebut(Jika argumen adalah array) atau argumennya sendiri (jika argumennya bukan array).

concat tidak mengubah this atau beberapa array yang tersedia sebagai argumen melainkan mengembalikan shallow copy yang berisi salinan dari elemen yang sama digabung dengan array yang asli. Elemen dari array asli disalin ke array baru sebagai berikut:

• Referensi Object (bukan object sebenarnya) : concat menyalin referensi object ke dalam array baru. Kedua array asli dan baru merujuk pada object yang sama. Artinya, jika referensi object diubah, perubahan akan terlihat pada kedua array baru dan asli.
• Strings and numbers (bukan String dan Number objects): concat menyalin nilai string dan numbers ke dalam array baru.

Contoh

Menggabungkan dua Array

Berikut kode untuk menggabunggkan dua array:

var huruf = ['a', 'b', 'c'],
    angka = [1, 2, 3];

var hurufAngka = huruf.concat(angka);

console.log(hurufAngka); // Hasil: ['a', 'b', 'c', 1, 2, 3]

Menggabungkan tiga array

Berikut kode untuk mengabungkan tiga array:

var angka1 = [1, 2, 3],
    angka2 = [4, 5, 6],
    angka3 = [7, 8, 9];

var angkaBaru = angka1.concat(angka2, angka3);

console.log(angkaBaru); // Hasil: [1, 2, 3, 4, 5, 6, 7, 8, 9]

Menggabungkan nilai ke sebuah array

Berikut kode untuk menggabungkan tiga nilai ke sebuah array :

var huruf = ['a', 'b', 'c'];

var hurufAngka = huruf.concat(1, [2, 3]);

console.log(hurufAngka); 
// Hasil: ['a', 'b', 'c', 1, 2, 3]

Spesifikasi

Kompabilitas Browser

Lihat Juga

• push / pop — menambahkan/menghapus element dari akhir array 
• unshift / shift — menambahkan/menghapus element dari awal array
• splice — menambahkan/menghapus element dari lokasi spesifik array
• String.prototype.concat()
• Symbol.isConcatSpreadable – Kontrol Perataan.