for...in
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die for...in-Anweisung durchläuft alle aufzählbaren String-Eigenschaften eines Objekts (Eigenschaften mit Symbolen als Schlüssel werden ignoriert), einschließlich geerbter aufzählbarer Eigenschaften.
Probieren Sie es aus
const object = { a: 1, b: 2, c: 3 };
for (const property in object) {
console.log(`${property}: ${object[property]}`);
}
// Expected output:
// "a: 1"
// "b: 2"
// "c: 3"
Syntax
for (variable in object)
statement
Parameter
variable-
Erhält bei jedem Durchlauf einen String-Eigenschaftsnamen. Dies kann entweder eine Deklaration mit
const,letodervarsein oder ein Ziel für eine Zuweisung (z. B. eine zuvor deklarierte Variable, eine Objekteigenschaft oder ein Destrukturierungsmuster). Mitvardeklarierte Variablen sind nicht auf die Schleife beschränkt, d.h. sie befinden sich im selben Gültigkeitsbereich wie diefor...in-Schleife. object-
Das Objekt, dessen aufzählbare Eigenschaften ohne Symbol-Schlüssel durchlaufen werden.
statement-
Eine Anweisung, die bei jedem Durchlauf ausgeführt wird. Sie kann auf
variableverweisen. Mit einer Blockanweisung können Sie mehrere Anweisungen ausführen.
Beschreibung
Die Schleife durchläuft alle aufzählbaren Eigenschaften des Objekts selbst sowie diejenigen, die es über seine Prototypenkette erbt. Dabei haben Eigenschaften näher gelegener Prototypen Vorrang vor Eigenschaften von Prototypen, die in der Prototypenkette weiter vom Objekt entfernt sind.
Wie bei anderen Schleifen können Sie innerhalb von statement Anweisungen zur Steuerung des Programmflusses verwenden:
breakbeendet die Ausführung vonstatementund setzt die Ausführung bei der ersten Anweisung nach der Schleife fort.continuebeendet die Ausführung vonstatementund setzt die Schleife mit dem nächsten Durchlauf fort.
Eine for...in-Schleife durchläuft nur aufzählbare Eigenschaften ohne Symbol-Schlüssel. Objekte, die mit integrierten Konstruktoren wie Array und Object erstellt wurden, erben nicht aufzählbare Eigenschaften von Array.prototype und Object.prototype. Dazu gehören beispielsweise die Methode indexOf() von Array und die Methode toString() von Object. Diese Eigenschaften werden von der for...in-Schleife nicht durchlaufen.
Die Reihenfolge des Durchlaufens ist nach der modernen ECMAScript-Spezifikation klar definiert und über Implementierungen hinweg einheitlich. Innerhalb jeder Ebene der Prototypenkette werden zuerst alle nicht negativen ganzzahligen Schlüssel (die als Array-Indizes verwendet werden können) in aufsteigender numerischer Reihenfolge durchlaufen. Danach folgen die übrigen String-Schlüssel in der Reihenfolge, in der die Eigenschaften erstellt wurden.
Der variable-Teil von for...in akzeptiert alles, was vor dem Operator = stehen kann. Sie können die Variable mit const deklarieren, solange ihr innerhalb des Schleifenrumpfs kein neuer Wert zugewiesen wird. Zwischen den Durchläufen kann sich ihr Wert ändern, da es sich dabei jeweils um eine andere Variable handelt. Andernfalls können Sie let verwenden. Sie können mit Destrukturierung mehreren lokalen Variablen Werte zuweisen oder mit einem Eigenschaftszugriff wie for (x.y in iterable) den Wert einer Objekteigenschaft zuweisen. using und await using sind jedoch nicht zulässig, da die Variable immer ein String ist, während diese Deklarationen ein Objekt erfordern, das Ressourcen freigeben kann.
Eine veraltete Syntax erlaubt es, var-Deklarationen der Schleifenvariablen mit einem Initialisierungswert zu versehen. Im Strict Mode löst dies einen Syntaxfehler aus. Außerhalb des Strict Mode wird der Initialisierungswert einmal ausgewertet und der Schleifenvariablen zugewiesen, bevor der Durchlauf beginnt.
Gelöschte, hinzugefügte oder geänderte Eigenschaften
for...in besucht Eigenschaftsschlüssel auf folgende Weise:
- Zunächst werden alle eigenen String-Schlüssel des aktuellen Objekts ermittelt, ähnlich wie bei
Object.getOwnPropertyNames(). - Für jeden Schlüssel, dessen String-Wert noch nicht besucht wurde, wird der Eigenschaftsdeskriptor abgerufen. Die Eigenschaft wird nur besucht, wenn sie aufzählbar ist. Der Eigenschaftsname gilt jedoch auch dann als besucht, wenn die Eigenschaft nicht aufzählbar ist.
- Anschließend wird das aktuelle Objekt durch seinen Prototyp ersetzt und der Vorgang wiederholt.
Das bedeutet:
- Eigenschaften, die während des Durchlaufens zum aktuell besuchten Objekt hinzugefügt werden, werden nicht besucht, da zuvor bereits alle eigenen Eigenschaften dieses Objekts erfasst wurden.
- Wenn mehrere Objekte in der Prototypenkette eine Eigenschaft mit demselben Namen haben, wird nur die erste berücksichtigt. Sie wird nur besucht, wenn sie aufzählbar ist. Ist sie nicht aufzählbar, werden gleichnamige Eigenschaften weiter oben in der Prototypenkette nicht besucht, selbst wenn sie aufzählbar sind.
Im Allgemeinen sollten Sie während des Durchlaufens keine Eigenschaften des Objekts hinzufügen, ändern oder entfernen – mit Ausnahme der gerade besuchten Eigenschaft. Die Spezifikation erlaubt Implementierungen ausdrücklich, in den folgenden Fällen vom oben beschriebenen Algorithmus abzuweichen:
- Die Prototypenkette des Objekts wird während des Durchlaufens geändert.
- Eine Eigenschaft wird während des Durchlaufens vom Objekt oder aus seiner Prototypenkette gelöscht.
- Während des Durchlaufens wird der Prototypenkette des Objekts eine Eigenschaft hinzugefügt.
- Die Aufzählbarkeit einer Eigenschaft wird während des Durchlaufens geändert.
In diesen Fällen können sich Implementierungen anders verhalten als erwartet oder sich sogar voneinander unterscheiden.
Array-Iteration und for...in
Array-Indizes sind lediglich aufzählbare Eigenschaften mit ganzzahligen Namen und unterscheiden sich ansonsten nicht von anderen Objekteigenschaften. Die for...in-Schleife durchläuft alle ganzzahligen Schlüssel vor den übrigen Schlüsseln, und zwar in streng aufsteigender Reihenfolge. Dadurch ähnelt das Verhalten von for...in einer normalen Array-Iteration. Allerdings liefert die for...in-Schleife alle aufzählbaren Eigenschaften zurück, auch solche mit nicht ganzzahligen Namen und geerbte Eigenschaften. Anders als for...of verwendet for...in die Aufzählung von Eigenschaften statt des Iterators des Arrays. In Arrays mit Lücken besucht for...of die leeren Positionen, for...in hingegen nicht.
Verwenden Sie besser eine for-Schleife mit einem numerischen Index, Array.prototype.forEach() oder eine for...of-Schleife. Diese liefern den Index als Zahl statt als String und vermeiden außerdem Eigenschaften, die keine Indizes sind.
Nur eigene Eigenschaften durchlaufen
Wenn Sie nur Eigenschaften berücksichtigen möchten, die direkt zum Objekt gehören, und nicht die seiner Prototypen, können Sie eine der folgenden Möglichkeiten verwenden:
Object.keys liefert eine Liste der eigenen aufzählbaren String-Eigenschaften zurück, während Object.getOwnPropertyNames auch nicht aufzählbare Eigenschaften enthält.
Viele JavaScript-Styleguides und Linter raten von der Verwendung von for...in ab, da die Schleife die gesamte Prototypenkette durchläuft, was selten beabsichtigt ist. Außerdem kann sie mit der häufiger verwendeten for...of-Schleife verwechselt werden. for...in eignet sich vor allem zum Debuggen, da sich damit die Eigenschaften eines Objekts leicht überprüfen lassen, etwa durch eine Ausgabe in der Konsole. Wenn Objekte als einfache Schlüssel-Wert-Paare verwendet werden, können Sie mit for...in prüfen, ob einer der Schlüssel einen bestimmten Wert enthält.
Beispiele
>for...in verwenden
Die folgende for...in-Schleife durchläuft alle aufzählbaren Eigenschaften des Objekts ohne Symbol-Schlüssel und gibt einen String mit den Eigenschaftsnamen und ihren Werten aus.
const obj = { a: 1, b: 2, c: 3 };
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
}
// Logs:
// "obj.a = 1"
// "obj.b = 2"
// "obj.c = 3"
Eigene Eigenschaften durchlaufen
Die folgende Funktion veranschaulicht die Verwendung von Object.hasOwn(): Geerbte Eigenschaften werden nicht angezeigt.
const triangle = { a: 1, b: 2, c: 3 };
function ColoredTriangle() {
this.color = "red";
}
ColoredTriangle.prototype = triangle;
const obj = new ColoredTriangle();
for (const prop in obj) {
if (Object.hasOwn(obj, prop)) {
console.log(`obj.${prop} = ${obj[prop]}`);
}
}
// Logs:
// "obj.color = red"
Änderungen während des Durchlaufens
Warnung:
Sie sollten selbst keinen solchen Code schreiben. Er dient hier lediglich dazu, das Verhalten von for...in in einigen Sonderfällen zu veranschaulichen.
Eigenschaften, die während des Durchlaufens zum aktuellen Objekt hinzugefügt werden, werden nie besucht:
const obj = { a: 1, b: 2 };
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
obj.c = 3;
}
// Logs:
// obj.a = 1
// obj.b = 2
Verdeckte Eigenschaften werden nur einmal besucht:
const proto = { a: 1 };
const obj = { __proto__: proto, a: 2 };
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
}
// Logs:
// obj.a = 2
Object.defineProperty(obj, "a", { enumerable: false });
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
}
// Logs nothing, because the first "a" property visited is non-enumerable.
Betrachten Sie außerdem die folgenden Fälle, in denen das Verhalten nicht festgelegt ist und Implementierungen dazu neigen, vom beschriebenen Algorithmus abzuweichen:
Ändern des Prototyps während des Durchlaufens:
const obj = { a: 1, b: 2 };
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
Object.setPrototypeOf(obj, { c: 3 });
}
Löschen einer Eigenschaft während des Durchlaufens:
const obj = { a: 1, b: 2, c: 3 };
// Deleting a property before it is visited
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
delete obj.c;
}
const obj2 = { a: 1, b: 2, c: 3 };
// Deleting a property after it is visited
for (const prop in obj2) {
console.log(`obj2.${prop} = ${obj2[prop]}`);
delete obj2.a;
}
Hinzufügen aufzählbarer Eigenschaften zum Prototyp während des Durchlaufens:
const proto = {};
const obj = { __proto__: proto, a: 1, b: 2 };
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
proto.c = 3;
}
Ändern der Aufzählbarkeit einer Eigenschaft während des Durchlaufens:
const obj = { a: 1, b: 2, c: 3 };
for (const prop in obj) {
console.log(`obj.${prop} = ${obj[prop]}`);
Object.defineProperty(obj, "c", { enumerable: false });
}
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-for-in-and-for-of-statements> |