Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

L’objet arguments

`arguments` donne accès aux arguments transmis lors d’un appel de fonction. Il possède des propriétés indexées et `length`, mais ce n’est pas un tableau. Le lien avec les paramètres dépend du mode strict et de la liste des paramètres ; les fonctions fléchées ne créent pas leur propre `arguments`.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

arguments
arguments[index]
arguments.length

arguments est normalement disponible à l’intérieur d’une fonction pour son appel en cours ; ce n’est pas une variable globale. arguments[0] lit le premier argument et arguments.length indique initialement le nombre d’arguments effectivement transmis, y compris les arguments supplémentaires. Le nom arguments peut être masqué, par exemple par un paramètre de fonction.

Cet objet ressemble à un tableau, mais n’en est pas un et n’hérite pas de méthodes telles que map. En mode non strict, avec une liste simple de paramètres (uniquement des noms, sans valeurs par défaut, déstructuration ni paramètre rest), un index est initialement lié à un paramètre seulement si un argument a été transmis à la position de la dernière occurrence du nom de ce paramètre dans la liste. Si un nom apparaît plusieurs fois, ses positions précédentes ne sont pas liées, même si aucun argument n’a été transmis à la dernière position. Lorsqu’un lien existe, une affectation d’un côté peut modifier la valeur de l’autre. Il s’agit de la variante exotique décrite par la spécification.

En mode strict ou avec une liste de paramètres non simple, ce lien n’existe pas : affecter une valeur à un paramètre ne met pas à jour son index dans arguments, et inversement. Cela ne signifie pas que les objets transmis comme valeurs sont copiés : les deux côtés peuvent toujours faire référence au même objet.

Une fonction fléchée ne crée pas son propre arguments ; la référence est résolue dans la portée englobante. Dans du nouveau code, envisagez un paramètre rest ...args si vous avez besoin d’un véritable tableau d’arguments. Évitez arguments.callee : accéder à cette propriété sur la variante non mappée déclenche une TypeError.

Exemples

function inspect(first) {
  "use strict";
  first = 99;
  const readFirst = () => arguments[0];
  console.log(arguments.length);
  console.log(readFirst());
  console.log(first);
}

inspect(10, 20);

Résultat

2
10
99

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources