Array.prototype.unshift()

Method unshift() menambahkan satu atau lebih elemen ke indek awal array dan mengembalikan jumlah index array yang baru.

Sintaks

arr.unshift([element1[, ...[, elementN]]])

Parameter

elementN
Elemen yang akan di tambahkan di awal array.

Returns

Properti length baru dari objek teratas dimana method di panggil.

Deskripsi

Method unshift menambahkan nilai yang diberikan ke awal objek array.

unshift biasanya generic; method ini bisa berupa called atau applied ke objek menyerupai array. Objek yang tidak memiliki properti length mencerminkan dari serangkaian urutan, properti numerik berbasis zero kemungkinan tidak berperilaku dengan cara yang berarti.

Contoh

var arr = [1, 2];

arr.unshift(0); // result of call is 3, the new array length
// arr is [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr is [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr is [[-3], -2, -1, 0, 1, 2]

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.unshift' in that specification.		 Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.unshift' in that specification.		 Standard  
ECMAScript Latest Draft (ECMA-262)
The definition of 'Array.prototype.unshift' in that specification.		 Draft  

Kompabilitas Browser

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 1.0 (1.7 or earlier) 5.5 (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Lihat juga

Topik Terkait
  1. Standard built-in objects
  2. Array
  3. Properties
    1. Array.length
    2. Array.prototype [Translate]
    3. Array.prototype[@@unscopables] [Translate]
  4. Methods
    1. Array.from()
    2. Array.isArray()
    3. Array.observe() [Translate]
    4. Array.of()
    5. Array.prototype.concat()
    6. Array.prototype.copyWithin() [Translate]
    7. Array.prototype.entries() [Translate]
    8. Array.prototype.every() [Translate]
    9. Array.prototype.fill() [Translate]
    10. Array.prototype.filter()
    11. Array.prototype.find()
    12. Array.prototype.findIndex() [Translate]
    13. Array.prototype.flat() [Translate]
    14. Array.prototype.flatMap() [Translate]
    15. Array.prototype.forEach()
    16. Array.prototype.includes() [Translate]
    17. Array.prototype.indexOf() [Translate]
    18. Array.prototype.join()
    19. Array.prototype.keys() [Translate]
    20. Array.prototype.lastIndexOf() [Translate]
    21. Array.prototype.map() [Translate]
    22. Array.prototype.pop()
    23. Array.prototype.push()
    24. Array.prototype.reduce() [Translate]
    25. Array.prototype.reduceRight() [Translate]
    26. Array.prototype.reverse()
    27. Array.prototype.shift()
    28. Array.prototype.slice() [Translate]
    29. Array.prototype.some() [Translate]
    30. Array.prototype.sort() [Translate]
    31. Array.prototype.splice()
    32. Array.prototype.toLocaleString() [Translate]
    33. Array.prototype.toSource() [Translate]
    34. Array.prototype.toString() [Translate]
    35. Array.prototype.unshift()
    36. Array.prototype.values()
    37. Array.prototype[@@iterator]() [Translate]
    38. Array.unobserve() [Translate]
    39. get Array[@@species] [Translate]
  5. Inheritance:
  6. Function
  7. Properties
    1. Function.arguments [Translate]
    2. Function.arity [Translate]
    3. Function.caller [Translate]
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  8. Methods
    1. Function.prototype.apply() [Translate]
    2. Function.prototype.bind() [Translate]
    3. Function.prototype.call() [Translate]
    4. Function.prototype.isGenerator() [Translate]
    5. Function.prototype.toSource() [Translate]
    6. Function.prototype.toString() [Translate]
  9. Object
  10. Properties
    1. Object.prototype.__count__ [Translate]
    2. Object.prototype.__noSuchMethod__ [Translate]
    3. Object.prototype.__parent__ [Translate]
    4. Object.prototype.__proto__ [Translate]
    5. Object.prototype.constructor [Translate]
  11. Methods
    1. Object.prototype.__defineGetter__() [Translate]
    2. Object.prototype.__defineSetter__() [Translate]
    3. Object.prototype.__lookupGetter__() [Translate]
    4. Object.prototype.__lookupSetter__() [Translate]
    5. Object.prototype.hasOwnProperty() [Translate]
    6. Object.prototype.isPrototypeOf() [Translate]
    7. Object.prototype.propertyIsEnumerable() [Translate]
    8. Object.prototype.toLocaleString() [Translate]
    9. Object.prototype.toSource() [Translate]
    10. Object.prototype.toString() [Translate]
    11. Object.prototype.unwatch() [Translate]
    12. Object.prototype.valueOf() [Translate]
    13. Object.prototype.watch() [Translate]
    14. Object.setPrototypeOf() [Translate]