Der in operator gibt true zurück, falls die gegebene Eigenschaft im gegebenen Objekt existiert.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
prop in object
Parameter
prop- Ein String oder Symbol welches einen Namen einer Eigenschaft oder einen Arrayindex (nicht Symbole werden in einen String konvertiert).
object- Objekt, bei welchem überprüft wird, ob eine Eigenschaft mit spezifiziertem Namen enthalten ist (oder in der Prototypenkette enthalten ist).
Beschreibung
Die folgenden Beispiele zeigen einige Verwendungen des Operators
// Arrays
var trees = ["redwood", "bay", "cedar", "oak", "maple"];
0 in trees // gibt true zurück
3 in trees // gibt true zurück
6 in trees // gibt false zurück
"bay" in trees // gibt false zurück (man muss den Index
// spezifizieren, nicht den Wert an dem Index)
"length" in trees // gibt true (length ist eine Eigenschaft von Array
Symbol.iterator in trees // gibt true zurück (Arrays sind iterable, funktioniert nur in ES2015+))
// Vordefinierte Objekte
"PI" in Math // gibt true zurück
// Eigene Objekte
var mycar = {make: "Honda", model: "Accord", year: 1998};
"make" in mycar // gibt true zurück
"model" in mycar // gibt true zurück
Man muss auf der rechten Seite des in Operators ein Objekt benutzen. Zum Beispiel kann ein String, der durch einen Konstruktor erstellt wurde, benutzt werden, jedoch funktioniert kein Stringliteral.
var color1 = new String("green");
"length" in color1 // gibt true zurück
var color2 = "coral";
// erzeugt einen Fehler (color2 ist kein String Objekt)
"length" in color2
Einsatz von in mit gelöschten oder undefined Eigenschaften.
Wenn eine Eigenschaft mit dem delete Operator gelöscht wird, wird der in für diese Eigenschaft false zurückgeben.
var mycar = {make: "Honda", model: "Accord", year: 1998};
delete mycar.make;
"make" in mycar; // gibt false zurück
var trees = new Array("redwood", "bay", "cedar", "oak", "maple");
delete trees[3];
3 in trees; // gibt false zurück
Wenn eine Eigenschaft auf undefined gesetzt wird, aber nicht gelöscht wird, wird der in Operator true zurückgeben.
var mycar = {make: "Honda", model: "Accord", year: 1998};
mycar.make = undefined;
"make" in mycar; // gibt true zurück
var trees = new Array("redwood", "bay", "cedar", "oak", "maple");
trees[3] = undefined;
3 in trees; // gibt true zurück
Vererbte Eigenschaften
Der in Operator gibt true für Eigenschaften in der Prototype-Kette zurück.
"toString" in {}; // gibt true zurück
Spezifikationen
| Spezifikation | Status | Kommentar |
|---|---|---|
| ECMAScript Latest Draft (ECMA-262) Die Definition von 'Relational Operators' in dieser Spezifikation. |
Entwurf | |
| ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Relational Operators' in dieser Spezifikation. |
Standard | |
| ECMAScript 5.1 (ECMA-262) Die Definition von 'The in Operator' in dieser Spezifikation. |
Standard | |
| ECMAScript 3rd Edition (ECMA-262) Die Definition von 'The in Operator' in dieser Spezifikation. |
Standard | Initiale Definition. Implementiert in JavaScript 1.4. |
Browserkompatibilität
| Desktop | Mobile | Server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
in | Chrome Vollständige Unterstützung 1 | Edge Vollständige Unterstützung 12 | Firefox Vollständige Unterstützung 1 | IE Vollständige Unterstützung 5.5 | Opera Vollständige Unterstützung Ja | Safari Vollständige Unterstützung Ja | WebView Android Vollständige Unterstützung 1 | Chrome Android Vollständige Unterstützung 18 | Firefox Android Vollständige Unterstützung 4 | Opera Android Vollständige Unterstützung Ja | Safari iOS Vollständige Unterstützung Ja | Samsung Internet Android Vollständige Unterstützung 1.0 | nodejs Vollständige Unterstützung Ja |
Legende
- Vollständige Unterstützung
- Vollständige Unterstützung