mozilla

Revision 583797 of Array.prototype.unshift()

  • Raccourci de la révision : JavaScript/Reference/Objets_globaux/Array/unshift
  • Titre de la révision : Array.prototype.unshift()
  • ID de la révision : 583797
  • Créé :
  • Créateur : tregagnon
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

{{JSRef("Global_Objects", "Array")}}

Résumé

La méthode unshift() ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.

Syntaxe

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

Paramètres

element1, ..., element N
Les éléments à ajouter en début de tableau.

Renvoie

La nouvelle valeur de la propriété {{jsxref("Array.length", "length")}} du tableau sur lequel a été appelée la méthode.

Description

La méthode unshift() insère les valeurs renseignées au début d'un objet ressemblant à un tableau.

unshift() est volontairement générique ; cette méthode peut être {{jsxref("Function.call", "called")}} ou {{jsxref("Function.apply", "applied")}} sur des objets ressemblant à des tableaux. Les objets qui ne contiennent pas une propriété length reflètant la fin d'une série consécutive numérique des propriétés ne peut pas se comporter de manière cohérente.

Exemples

var arr = [1, 2];

arr.unshift(0); // renvoie 3, la nouvelle longueur du tableau
// arr est [0, 1, 2]

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

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

Spécifications

Spécification Statut Commentaire
{{SpecName('ES6', '#sec-array.prototype.unshift', 'Array.prototype.unshift')}} {{Spec2('ES6')}}  
{{SpecName('ES5.1', '#sec-15.4.4.13', 'Array.prototype.unshift')}} {{Spec2('ES5.1')}}  
ECMAScript 3e Édition Standard Première définition.
Implémenté dans JavaScript 1.2

Compatibilité des navigateurs

{{CompatibilityTable}}
Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support de base 1.0 {{CompatGeckoDesktop("1.7")}} 5.5 {{CompatVersionUnknown}} {{CompatVersionUnknown}}
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support de base {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}

Voir également

  • {{jsxref("Array.prototype.push()")}}
  • {{jsxref("Array.prototype.pop()")}}
  • {{jsxref("Array.prototype.shift()")}}

Source de la révision

<p>{{JSRef("Global_Objects", "Array")}}</p>
<h2 id="R.C3.A9sum.C3.A9" name="R.C3.A9sum.C3.A9">Résumé</h2>
<p><span class="seoSummary">La méthode <code><strong>unshift()</strong></code> ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.</span></p>
<h2 id="Syntaxe" name="Syntaxe">Syntaxe</h2>
<pre class="syntaxbox">
<code><em>arr</em>.unshift(<em>element1</em>, ..., <em>elementN</em>) </code></pre>
<h3 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h3>
<dl>
 <dt>
  <code>element1, ..., element
  <i>
   N</i>
  </code></dt>
 <dd>
  Les éléments à ajouter en début de tableau.</dd>
</dl>
<h3 id="Renvoie">Renvoie</h3>
<p>La nouvelle valeur de la propriété {{jsxref("Array.length", "length")}} du tableau sur lequel a été appelée la méthode.</p>
<h2 id="Description">Description</h2>
<p>La méthode <code>unshift()</code> insère les valeurs renseignées au début d'un objet ressemblant à un tableau.</p>
<p><code>unshift()</code> est volontairement générique ; cette méthode peut être {{jsxref("Function.call", "called")}} ou {{jsxref("Function.apply", "applied")}} sur des objets ressemblant à des tableaux. Les objets qui ne contiennent pas une propriété <code>length</code> reflètant la fin d'une série consécutive numérique des propriétés ne peut pas se comporter de manière cohérente.</p>
<h2 id="Exemples" name="Exemples">Exemples</h2>
<pre class="brush:js">
var arr = [1, 2];

arr.unshift(0); // renvoie 3, la nouvelle longueur du tableau
// arr est [0, 1, 2]

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

arr.unshift( [-3] );
// arr est [[-3], -2, -1, 0, 1, 2]</pre>
<h2 id="Sp.C3.A9cifications">Spécifications</h2>
<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statut</th>
   <th scope="col">Commentaire</th>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-array.prototype.unshift', 'Array.prototype.unshift')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td>&nbsp;</td>
  </tr>
  <tr>
   <td>{{SpecName('ES5.1', '#sec-15.4.4.13', 'Array.prototype.unshift')}}</td>
   <td>{{Spec2('ES5.1')}}</td>
   <td>&nbsp;</td>
  </tr>
  <tr>
   <td>ECMAScript 3<sup>e</sup> Édition</td>
   <td>Standard</td>
   <td>Première définition.<br />
    Implémenté dans JavaScript 1.2</td>
  </tr>
 </tbody>
</table>
<h2 id="Compatibilit.C3.A9_des_navigateurs">Compatibilité des navigateurs</h2>
<div>
 {{CompatibilityTable}}</div>
<div id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Fonctionnalité</th>
    <th>Chrome</th>
    <th>Firefox (Gecko)</th>
    <th>Internet Explorer</th>
    <th>Opera</th>
    <th>Safari</th>
   </tr>
   <tr>
    <td>Support de base</td>
    <td>1.0</td>
    <td>{{CompatGeckoDesktop("1.7")}}</td>
    <td>5.5</td>
    <td>{{CompatVersionUnknown}}</td>
    <td>{{CompatVersionUnknown}}</td>
   </tr>
  </tbody>
 </table>
</div>
<div id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Fonctionnalité</th>
    <th>Android</th>
    <th>Chrome pour Android</th>
    <th>Firefox Mobile (Gecko)</th>
    <th>IE Mobile</th>
    <th>Opera Mobile</th>
    <th>Safari Mobile</th>
   </tr>
   <tr>
    <td>Support de base</td>
    <td>{{CompatVersionUnknown}}</td>
    <td>{{CompatVersionUnknown}}</td>
    <td>{{CompatVersionUnknown}}</td>
    <td>{{CompatVersionUnknown}}</td>
    <td>{{CompatVersionUnknown}}</td>
    <td>{{CompatVersionUnknown}}</td>
   </tr>
  </tbody>
 </table>
</div>
<h2 id="Voir_aussi" name="Voir_aussi">Voir également</h2>
<ul>
 <li>{{jsxref("Array.prototype.push()")}}</li>
 <li>{{jsxref("Array.prototype.pop()")}}</li>
 <li>{{jsxref("Array.prototype.shift()")}}</li>
</ul>
Revenir à cette révision