Function.prototype.arguments

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

Hinweis: Die arguments Eigenschaft von Function Objekten ist veraltet. Der empfohlene Weg, um auf das arguments Objekt zuzugreifen, besteht darin, auf die Variable arguments zu verweisen, die innerhalb von Funktionen verfügbar ist.

Die arguments Accessor-Eigenschaft von Function Instanzen gibt die an diese Funktion übergebenen Argumente zurück. Für strict, Arrow-, Async- und Generator-Funktionen führt der Zugriff auf die arguments Eigenschaft zu einem TypeError.

Beschreibung

Der Wert von arguments ist ein array-ähnliches Objekt, das den an eine Funktion übergebenen Argumenten entspricht.

Im Fall von Rekursion, d.h. wenn die Funktion f mehrmals im Aufruf-Stack erscheint, repräsentiert der Wert von f.arguments die Argumente der jüngsten Ausführung der Funktion.

Der Wert der arguments Eigenschaft ist normalerweise null, wenn kein ausstehender Aufruf der Funktion im Gange ist (d.h. die Funktion wurde aufgerufen, hat aber noch nicht zurückgegeben).

Beachten Sie, dass das einzige Verhalten, das durch die ECMAScript-Spezifikation festgelegt ist, darin besteht, dass Function.prototype einen initialen arguments Accessor hat, der bedingungslos für jede get oder set Anfrage einen TypeError auslöst (bekannt als ein "poison pill accessor"), und dass Implementierungen nicht erlaubt sind, diese Semantik für irgendeine Funktion außer nicht-strikten einfachen Funktionen zu ändern. Das tatsächliche Verhalten der arguments Eigenschaft, falls es etwas anderes als das Auslösen eines Fehlers ist, ist implementierungsspezifisch. Zum Beispiel definiert Chrome es als eine eigene Dateneigenschaft, während Firefox und Safari den initialen poison-pill Function.prototype.arguments Accessor erweitern, um speziell mit this Werten umzugehen, die nicht-strikte Funktionen sind.

js
(function f() {
  if (Object.hasOwn(f, "arguments")) {
    console.log(
      "arguments is an own property with descriptor",
      Object.getOwnPropertyDescriptor(f, "arguments"),
    );
  } else {
    console.log(
      "f doesn't have an own property named arguments. Trying to get f.[[Prototype]].arguments",
    );
    console.log(
      Object.getOwnPropertyDescriptor(
        Object.getPrototypeOf(f),
        "arguments",
      ).get.call(f),
    );
  }
})();

// In Chrome:
// arguments is an own property with descriptor {value: Arguments(0), writable: false, enumerable: false, configurable: false}

// In Firefox:
// f doesn't have an own property named arguments. Trying to get f.[[Prototype]].arguments
// Arguments { … }

Beispiele

Verwendung der arguments-Eigenschaft

js
function f(n) {
  g(n - 1);
}

function g(n) {
  console.log(`before: ${g.arguments[0]}`);
  if (n > 0) {
    f(n);
  }
  console.log(`after: ${g.arguments[0]}`);
}

f(2);

console.log(`returned: ${g.arguments}`);

// Logs:
// before: 1
// before: 0
// after: 0
// after: 1
// returned: null

Spezifikationen

Kein Teil eines Standards.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch