DOMStringList

Hinweis: Dieses Feature ist verfügbar in Web Workers.

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 Nur lesbar

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