WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Das arguments-Objekt

`arguments` stellt die Argumente bereit, die beim Aufruf einer Funktion übergeben wurden. Es hat indizierte Eigenschaften und `length`, ist aber kein Array. Ob es mit Parametern verknüpft ist, hängt vom Strict-Modus und der Parameterliste ab; Pfeilfunktionen erzeugen kein eigenes `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

Syntax

arguments
arguments[index]
arguments.length

arguments ist normalerweise innerhalb einer Funktion für ihren aktuellen Aufruf verfügbar und keine globale Variable. arguments[0] liest das erste Argument, und arguments.length gibt zunächst die Anzahl der tatsächlich übergebenen Argumente an, auch wenn zusätzliche Argumente dabei sind. Der Name arguments kann überschattet werden, zum Beispiel durch einen Funktionsparameter.

Das Objekt ist array-ähnlich, aber kein Array und erbt keine Methoden wie map. Im Nicht-Strict-Modus und mit einer einfachen Parameterliste (nur Namen, ohne Standardwerte, Destrukturierung oder Rest-Parameter) ist ein Index zunächst nur dann mit einem Parameter verknüpft, wenn an der Position, an der dessen Name zuletzt in der Liste vorkommt, ein Argument übergeben wurde. Kommt ein Name mehrfach vor, sind seine früheren Positionen nicht verknüpft, auch wenn an der letzten Position kein Argument übergeben wurde. Besteht eine Verknüpfung, kann eine Zuweisung auf der einen Seite den Wert auf der anderen ändern. Dies ist die in der Spezifikation beschriebene exotische Variante.

Im Strict-Modus oder bei einer nicht einfachen Parameterliste besteht diese Verknüpfung nicht: Eine Zuweisung an einen Parameter aktualisiert seinen Index in arguments nicht und umgekehrt. Das bedeutet nicht, dass als Werte übergebene Objekte kopiert werden – beide Seiten können weiterhin auf dasselbe Objekt verweisen.

Eine Pfeilfunktion erzeugt kein eigenes arguments; der Verweis wird im umgebenden Gültigkeitsbereich aufgelöst. Ziehe in neuem Code den Rest-Parameter ...args in Betracht, wenn du ein tatsächliches Array der Argumente benötigst. Verwende arguments.callee nicht: Beim Zugriff auf diese Eigenschaft in der nicht zugeordneten Variante wird ein TypeError ausgelöst.

Beispiele

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

inspect(10, 20);

Ergebnis

2
10
99

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen