Array.prototype.unshift()

Phương thức unshift() thêm một hoặc nhiều phần tử vào vị trí đầu mảng sau đó trả về chiều dài của mảng mới.

Syntax

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

Parameters

elementN
Các phần tử được thêm vào đầu mảng.

Return value

Trả về độ dài mới của mảng length   sau khi thực hiện thêm phần tử.

Description

Phương thức unshift sẽ thêm vào đầu mảng các giá trị được truyền vào.

unshift là "intentionally generic"; this method can be called or applied to objects resembling arrays. Objects which do not contain a length property reflecting the last in a series of consecutive, zero-based numerical properties may not behave in any meaningful manner.

Chú ý rằng, Nếu truyền nhiều phần tử vào cùng lức như một biến, chúng sẽ được thêm vào vị trí đầu tiên của mảng, theo đúng vị trí ban đầu mà chúng được truyền vào. Việc gọi phương thức unshift với n phần tử trong một lần sẽ không trả về cùng kết quả (vị trí các phần tử) so với việc gọi n lần với mỗi lần 1 phần tử.

Xem ví dụ bên dưới

let arr = [4,5,6];
arr.unshift(1,2,3);
console.log(arr); // [1, 2, 3, 4, 5, 6]

arr = [4,5,6]; // resetting the array
arr.unshift(1);
arr.unshift(2);
arr.unshift(3);
console.log(arr); // [3, 2, 1, 4, 5, 6]

Examples

let arr = [1, 2];

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

arr.unshift(-2, -1); // the new array length is 5
// arr is [-2, -1, 0, 1, 2]

arr.unshift([-4, -3]); // the new array length is 6
// arr is [[-4, -3], -2, -1, 0, 1, 2]

arr.unshift([-7, -6], [-5]); // the new array length is 8
// arr is [ [-7, -6], [-5], [-4, -3], -2, -1, 0, 1, 2 ]

Specifications

Specification 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  

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
unshiftChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 5.5Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes

Legend

Full support  
Full support

See also

Sửa đổi lần cuối:

, by MDN contributors
Các chủ đề liên quan
  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()
    10. Array.prototype.filter()
    11. Array.prototype.find()
    12. Array.prototype.findIndex()
    13. Array.prototype.flat() [Translate]
    14. Array.prototype.flatMap() [Translate]
    15. Array.prototype.forEach()
    16. Array.prototype.includes() [Translate]
    17. Array.prototype.indexOf()
    18. Array.prototype.join()
    19. Array.prototype.keys() [Translate]
    20. Array.prototype.lastIndexOf() [Translate]
    21. Array.prototype.map()
    22. Array.prototype.pop()
    23. Array.prototype.push()
    24. Array.prototype.reduce()
    25. Array.prototype.reduceRight()
    26. Array.prototype.reverse()
    27. Array.prototype.shift()
    28. Array.prototype.slice()
    29. Array.prototype.some()
    30. Array.prototype.sort()
    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() [Translate]
    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 [Translate]
    5. Function.length [Translate]
    6. Function.name [Translate]
    7. Function.prototype [Translate]
  8. Methods
    1. Function.prototype.apply() [Translate]
    2. Function.prototype.bind() [Translate]
    3. Function.prototype.call()
    4. Function.prototype.isGenerator() [Translate]
    5. Function.prototype.toSource()
    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()
    11. Object.prototype.unwatch() [Translate]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Translate]
    14. Object.setPrototypeOf() [Translate]