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