Array.prototype.unshift()
המתודה ()
unshift
מוסיפה אלמנט אחד או יותר לתחילת מערך ומחזירה את גודלו החדש של המערך. Syntax
arr.unshift(element1[, ...[, elementN]])
פרמטרים
elementN
- אלמנטים להוספה לתחילת המערך.
ערך מוחזר
את ערך השדה length
(en-US) החדש של המערך עליו הופעלה המתודה.
תאור
המתודה unshift
מכניסה את ערכי האלמנטים שקיבלה כפרמטר לתחילת אובייקט המערך.
unshift
is intentionally generic; this method can be called (en-US) or applied (en-US) 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.
Examples
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]
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 (ECMA-262) The definition of 'Array.prototype.unshift' in that specification. |
Living Standard |
Browser compatibility
BCD tables only load in the browser