mozilla

Compare Revisions

Array

Change Revisions

Revision 27824:

Revision 27824 by snearley on

Revision 27825:

Revision 27825 by snearley on

Title:
Array
Array
Slug:
JavaScript/Reference/Global_Objects/Array
JavaScript/Reference/Global_Objects/Array
Tags:
JavaScript, NeedsEditorialReview, "JavaScript Reference"
JavaScript, NeedsEditorialReview, "JavaScript Reference"
Content:

Revision 27824
Revision 27825
n28        A JavaScript array is initialized with the given elementsn28        A JavaScript array is initialized with the given elements
>, except in the case where a single argument is passed to the Jav>, except in the case where a single argument is passed to the&nbs
>aScript&nbsp;<code>Array</code> constructor and that argument is >p;<code>Array</code> constructor and that argument is a number. (
>a number. (See below.) Note that this special case only applies t>See below.) Note that this special case only applies to JavaScrip
>o JavaScript arrays created with the JavaScript&nbsp;<code>Array<>t arrays created with the&nbsp;<code>Array</code> constructor, no
>/code> constructor, not with JavaScript array literals created wi>t with array literals created with the bracket syntax.
>th the bracket syntax. 
n41      JavaScript arrays are list-like objects that come with a sen41      JavaScript arrays are list-like objects that come with a se
>veral built-in methods to perform traversal and mutation operatio>veral built-in methods to perform traversal and mutation operatio
>ns. Neither the size of a JavaScript array nor the types of its e>ns. Neither the size of a JavaScript array nor the types of its e
>lements are fixed.&nbsp; Since a JavaScript array's size can grow>lements are fixed.&nbsp; Since a JavaScript array's size can grow
> or shrink at any time, JavaScript arrays are not guaranteed to b> or shrink at any time, arrays are not guaranteed to be dense.&nb
>e dense.&nbsp; In general, these are convenient characteristics, >sp; In general, these are convenient characteristics, but if thes
>but if these are desirable things to have for your use case, you >e are desirable things to have for your use case, you might consi
>might consider using WebGL typed arrays.>der using WebGL typed arrays.
n50      JavaScript arrays are zero-indexed; the first element of a n50      JavaScript arrays are zero-indexed; the first element of an
>JavaScript array is actually at index <code>0</code>, and the las> array is actually at index <code>0</code>, and the last element 
>t element is at the index one less than the value of the JavaScri>is at the index one less than the value of the array's <a href="/
>pt array's <a href="/en/JavaScript/Reference/Global_Objects/Array>en/JavaScript/Reference/Global_Objects/Array/length" title="en/Ja
>/length" title="en/JavaScript/Reference/Global_Objects/Array/leng>vaScript/Reference/Global_Objects/Array/length"><code>length</cod
>th"><code>length</code></a> property.>e></a> property.
n96      A JavaScript array's <code><a href="/en/JavaScript/Referencn96      A JavaScript array's <code><a href="/en/JavaScript/Referenc
>e/Global_Objects/Array/length" title="en/JavaScript/Reference/Glo>e/Global_Objects/Array/length" title="en/JavaScript/Reference/Glo
>bal_Objects/Array/length">length</a></code> property and numerica>bal_Objects/Array/length">length</a></code> property and numerica
>l properties are connected.&nbsp; Several of the built-in JavaScr>l properties are connected.&nbsp; Several of the built-in JavaScr
>ipt array methods (e.g., <code><a href="/en/JavaScript/Reference/>ipt array methods (e.g., <code><a href="/en/JavaScript/Reference/
>Global_Objects/Array/join" title="en/JavaScript/Reference/Global_>Global_Objects/Array/join" title="en/JavaScript/Reference/Global_
>Objects/Array/join">join</a></code>, <code><a href="/en/JavaScrip>Objects/Array/join">join</a></code>, <code><a href="/en/JavaScrip
>t/Reference/Global_Objects/Array/slice" title="en/JavaScript/Refe>t/Reference/Global_Objects/Array/slice" title="en/JavaScript/Refe
>rence/Global_Objects/Array/slice">slice</a></code>, <code><a href>rence/Global_Objects/Array/slice">slice</a></code>, <code><a href
>="/en/JavaScript/Reference/Global_Objects/Array/indexOf" title="e>="/en/JavaScript/Reference/Global_Objects/Array/indexOf" title="e
>n/JavaScript/Reference/Global_Objects/Array/indexOf">indexOf</a><>n/JavaScript/Reference/Global_Objects/Array/indexOf">indexOf</a><
>/code>, etc.) take into account the value of a JavaScript array's>/code>, etc.) take into account the value of an array's <code>len
> <code>length</code> property when they're called.&nbsp; Other me>gth</code> property when they're called.&nbsp; Other methods (e.g
>thods (e.g., <code><a href="/en/JavaScript/Reference/Global_Objec>., <code><a href="/en/JavaScript/Reference/Global_Objects/Array/p
>ts/Array/push" title="en/JavaScript/Reference/Global_Objects/Arra>ush" title="en/JavaScript/Reference/Global_Objects/Array/push">pu
>y/push">push</a></code>, <code><a href="/en/JavaScript/Reference/>sh</a></code>, <code><a href="/en/JavaScript/Reference/Global_Obj
>Global_Objects/Array/splice" title="en/JavaScript/Reference/Globa>ects/Array/splice" title="en/JavaScript/Reference/Global_Objects/
>l_Objects/Array/splice">splice</a></code>, etc.) also result in u>Array/splice">splice</a></code>, etc.) also result in updates to 
>pdates to a JavaScript array's <code>length</code> property.>an array's <code>length</code> property.
n105      When setting a property on a JavaScript array when the propn105      When setting a property on a JavaScript array when the prop
>erty is a valid array index and that index is outside the current>erty is a valid array index and that index is outside the current
> bounds of the JavaScript array, the JavaScript array will grow t> bounds of the array, the array will grow to a size large enough 
>o a size large enough to accommodate an element at that index, an>to accommodate an element at that index, and the engine will upda
>d the engine will update the JavaScript array's <code>length</cod>te the array's <code>length</code> property accordingly:
>e> property accordingly: 
t278      The following example creates a JavaScript array, <code>msgt278      The following example creates a JavaScript array, <code>msg
>Array</code>, with a length of 0, then assigns values to <code>ms>Array</code>, with a length of 0, then assigns values to <code>ms
>gArray[0]</code> and <code>msgArray[99]</code>, changing the leng>gArray[0]</code> and <code>msgArray[99]</code>, changing the leng
>th of the JavaScript array to 100.>th of the array to 100.

Back to History