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

See also