DOMStringList
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Das DOMStringList
Interface ist ein veralteter Typ, der von einigen APIs zurückgegeben wird und eine nicht-modifizierbare Liste von Strings (DOMString
) darstellt.
Dieses Interface war ein Versuch, eine nicht-modifizierbare Liste zu erstellen und wird weiterhin unterstützt, um bestehende Codes nicht zu zerstören, die es nutzen. Moderne APIs repräsentieren Listenstrukturen mit Typen, die auf JavaScript-Arrays basieren, wodurch viele Array-Methoden verfügbar sind und gleichzeitig zusätzliche Semantiken für deren Nutzung auferlegt werden (zum Beispiel, dass ihre Elemente schreibgeschützt sind).
Diese historischen Gründe bedeuten nicht, dass Sie als Entwickler DOMStringList
vermeiden sollten. Sie erstellen DOMStringList
Objekte nicht selbst, sondern erhalten sie von APIs wie Location.ancestorOrigins
, und diese APIs sind nicht veraltet. Seien Sie jedoch vorsichtig bei den semantischen Unterschieden zu einem echten Array.
Dieses Interface wird in IndexedDB und in der Location
API verwendet:
Instanzeigenschaften
DOMStringList.length
Schreibgeschützt-
Gibt die Größe der Liste zurück.
Instanzmethoden
DOMStringList.item()
-
Gibt einen String aus der Liste mit dem angegebenen Index zurück.
DOMStringList.contains()
-
Gibt einen booleschen Wert zurück, der angibt, ob der gegebene String in der Liste enthalten ist.
Spezifikationen
Specification |
---|
HTML Standard # the-domstringlist-interface |
Browser-Kompatibilität
BCD tables only load in the browser