1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
---
title: Function.arguments
slug: Web/JavaScript/Reference/Global_Objects/Function/arguments
tags:
- Déprécié
- Function
- JavaScript
- Propriété
- Reference
- arguments
translation_of: Web/JavaScript/Reference/Global_Objects/Function/arguments
original_slug: Web/JavaScript/Reference/Objets_globaux/Function/arguments
---
<div>{{JSRef}} {{Deprecated_header}}</div>
<p>La propriété <code><strong><em>function</em>.arguments</strong></code> fait référence à un objet dont la structure est semblable à celle d'un tableau dont les éléments correspondent aux arguments passés à une fonction. En lieu et place, il faut désormais utiliser {{jsxref("Fonctions/arguments", "arguments")}}. Cette propriété est interdite en mode stricte à cause de <a href="https://www.ecma-international.org/ecma-262/6.0/#sec-addrestrictedfunctionproperties">l'optimisation de la queue des appels (<em>tail call optimization</em>)</a>.</p>
<h2 id="Description">Description</h2>
<p>La syntaxe <code><em>function</em>.arguments</code> est obsolète. La méthode recommandée pour accéder à l'objet {{jsxref("Fonctions/arguments", "arguments")}} disponible au sein des fonctions est simplement de faire référence à la variable {{jsxref("Fonctions/arguments", "arguments")}}.</p>
<p>Si on utilise la récursivité (autrement dit si une fonction <code>f</code> apparaît plusieurs fois dans la pile d'appels ou encore qu'une fonction <code>f</code> s'appelle elle-même), la valeur de <code>f.arguments</code> représentera les arguments correspondant à l'appel le plus « récent » de la fonction.</p>
<p>La valeur de la propriété <code>arguments</code> est normalement <code>null</code> si la fonction n'est pas « en cours » (au sens où elle aurait été appelée et qu'elle n'ait pas fini son exécution).</p>
<h2 id="Exemples">Exemples</h2>
<pre class="brush:js">function f(n) { g(n-1); }
function g(n) {
console.log("avant : " + g.arguments[0]);
if(n>0) f(n);
console.log("après : " + g.arguments[0]);
}
f(2);
console.log("fonction terminée : " + g.arguments);
// On aura l'affichage de :
// avant : 1
// avant : 0
// après : 0
// après : 1
// fonction terminée : null
</pre>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
<th scope="col">Statut</th>
<th scope="col">Commentaires</th>
</tr>
<tr>
<td>{{SpecName('ES1')}}</td>
<td>{{Spec2('ES1')}}</td>
<td>Définition initiale. Implémentée avec JavaScript 1.0. Dépréciée pour être remplacée par {{jsxref("Fonctions/arguments", "arguments")}} décrit par ES3.</td>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-10.6', 'arguments object')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td>Objet {{jsxref("Fonctions/arguments", "arguments")}}</td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-arguments-object', 'arguments object')}}</td>
<td>{{Spec2('ES6')}}</td>
<td>Objet {{jsxref("Fonctions/arguments", "arguments")}}</td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-arguments-object', 'arguments object')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td>Objet {{jsxref("Fonctions/arguments", "arguments")}}</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("javascript.builtins.Function.arguments")}}</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
<li>L'objet {{jsxref("Fonctions/arguments", "arguments")}}</li>
<li>{{jsxref("Fonctions", "Les fonctions et les portées de fonctions", "", 1)}}</li>
</ul>
|
