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.

Catatan: Concatenating array/nilai akan membiarkan aslinya tidak tersentuh. Selanjutnya, setiap operasi pada array baru tidak akan mempengaruhi array yang asli, begitupun sebaliknya.

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

Spesifikasi Status Comment
ECMAScript 3rd Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.concat' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.concat' in that specification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
The definition of 'Array.prototype.concat' in that specification.
Draft  

Kompabilitas Browser

Fitur Chrome Firefox (Gecko) Internet Explorer Opera Safari
Dukungan dasar 1.0 1.0 (1.7 or earlier) 5.5 (Yes) (Yes)
Fitur Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Dukungan dasar (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Lihat Juga

Tag Dokumen dan Kontributor

Tag: 
 Kontributor untuk laman ini: rmsubekti
 Terakhir diperbarui oleh: rmsubekti,