length

  • Raccourci de la révision : JavaScript/Référence_JavaScript/Référence_JavaScript/Objets_globaux/Function/length
  • Titre de la révision : length
  • ID de la révision : 273219
  • Créé :
  • Créateur : Julien STUBY
  • Version actuelle ? Oui
  • Commentaire no wording changes

Contenu de la révision

 

Résumé

Spécifie le nombre de paramètres attendus par la fonction.

Propriété de Function
Implémentation : JavaScript 1.1
Version ECMA : ECMA-262

Description

length est externe à une fonction et indique le nombre de paramètres formels que celle-ci attend. Par opposition, arguments.length est local à la fonction et fournit le nombre de paramètres réellement passés à la fonction.

Exemples

var test = function() {}

alert(test.length); // affiche 0
var test = function(a) {}

alert(test.length); // affiche 1
var test = function(a,b) {}

alert(test.length); // affiche 2

L'exemple suivant montre l'utilisateion de Function.length et d'arguments.length.

function addNumbers(x, y) {
   if (arguments.length == addNumbers.length) {
      return (x + y);
   }
   else
      return 0;
}

Si vous ne passez pas deux paramètres à cette fonction, elle renverra 0 :

addNumbers(3);       // renvoie 0
addNumbers(3,4,5);   // renvoie 0
addNumbers(3,4);     // renvoie 7
addNumbers(103,104); // renvoie 207

{{ languages( { "en": "en/Core_JavaScript_1.5_Reference/Global_Objects/Function/length", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/Function/length" } ) }}

Source de la révision

<p> </p>
<h3 id="R.C3.A9sum.C3.A9" name="R.C3.A9sum.C3.A9">Résumé</h3>
<p>Spécifie le nombre de paramètres attendus par la fonction.</p>
<table class="fullwidth-table"> <tbody> <tr> <td class="header" colspan="2">Propriété de <a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function" title="fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function">Function</a></td> </tr> <tr> <td>Implémentation :</td> <td>JavaScript 1.1</td> </tr> <tr> <td>Version ECMA :</td> <td>ECMA-262</td> </tr> </tbody>
</table>
<h3 id="Description" name="Description">Description</h3>
<p><a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length"><code>length</code></a> est externe à une fonction et indique le nombre de paramètres formels que celle-ci attend. Par opposition, <code><a href="/fr/Référence_de_JavaScript_1.5_Core/Fonctions/arguments/length" title="fr/Référence_de_JavaScript_1.5_Core/Fonctions/arguments/length">arguments.length</a></code> est local à la fonction et fournit le nombre de paramètres réellement passés à la fonction.</p><h3 id="Exemples" name="Exemples">Exemples</h3>
<pre class="eval"><a href="/fr/Référence_de_JavaScript_1.5_Core/Instructions/var" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Instructions/var"><span style="color: rgb(128, 0, 128);">var</span></a> test = <a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function">function</a>() {}

<a href="/fr/DOM/window.alert" title="https://developer.mozilla.org/fr/DOM/window.alert">alert</a>(test.<a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length">length</a>); <span style="color: rgb(153, 153, 153);">// affiche 0</span>
</pre>
<pre class="eval"><a href="/fr/Référence_de_JavaScript_1.5_Core/Instructions/var" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Instructions/var"><span style="color: rgb(128, 0, 128);">var</span></a> test = <a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function">function</a>(a) {}

<a href="/fr/DOM/window.alert" title="https://developer.mozilla.org/fr/DOM/window.alert">alert</a>(test.<a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length">length</a>); <span style="color: rgb(153, 153, 153);">// affiche 1</span></pre>
<pre class="eval"><a href="/fr/Référence_de_JavaScript_1.5_Core/Instructions/var" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Instructions/var"><span style="color: rgb(128, 0, 128);">var</span></a> test = <a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function">function</a>(a,b) {}

<a href="/fr/DOM/window.alert" title="https://developer.mozilla.org/fr/DOM/window.alert">alert</a>(test.<a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length">length</a>); <span style="color: rgb(153, 153, 153);">// affiche 2</span>
</pre>
<p>L'exemple suivant montre l'utilisateion de <code><a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function">Function</a>.<a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length">length</a></code> et d'<a href="/fr/Référence_de_JavaScript_1.5_Core/Fonctions/arguments/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Fonctions/arguments/length"><code>arguments.length</code></a>.</p>
<pre class="eval"><a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function">function</a> addNumbers(x, y) {
   <a href="/fr/Référence_de_JavaScript_1.5_Core/Instructions/if...else" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Instructions/if...else">if</a> (<a href="/fr/Référence_de_JavaScript_1.5_Core/Fonctions/arguments/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Fonctions/arguments/length">arguments.length</a> == addNumbers.<a href="/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Objets_globaux/Function/length">length</a>) {
      <a href="/fr/Référence_de_JavaScript_1.5_Core/Instructions/return" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Instructions/return"><span style="color: rgb(128, 0, 128);">return</span></a> (x + y);
   }
   <a href="/fr/Référence_de_JavaScript_1.5_Core/Instructions/if...else" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Instructions/if...else">else</a>
      <a href="/fr/Référence_de_JavaScript_1.5_Core/Instructions/return" title="https://developer.mozilla.org/fr/Référence_de_JavaScript_1.5_Core/Instructions/return"><span style="color: rgb(128, 0, 128);">return</span></a> 0;
}
</pre>
<p>Si vous ne passez pas deux paramètres à cette fonction, elle renverra 0 :</p>
<pre class="eval">addNumbers(3);       <span style="color: rgb(153, 153, 153);">// renvoie 0</span>
addNumbers(3,4,5);   <span style="color: rgb(153, 153, 153);">// renvoie 0</span>
addNumbers(3,4);     <span style="color: rgb(153, 153, 153);">// renvoie 7</span>
addNumbers(103,104); <span style="color: rgb(153, 153, 153);">// renvoie 207</span>
</pre>
<p>{{ languages( { "en": "en/Core_JavaScript_1.5_Reference/Global_Objects/Function/length", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/Function/length" } ) }}</p>
Revenir à cette révision