DOMStringList
Note: This feature is available in Web Workers.
The DOMStringList
interface is a legacy type returned by some APIs and represents a non-modifiable list of strings (DOMString
).
This interface was an attempt to create an unmodifiable list and only continues to be supported to not break code that's already using it. Modern APIs represent list structures using types based on JavaScript arrays, thus making many array methods available, and at the same time imposing additional semantics on their usage (such as making their items read-only).
These historical reasons do not mean that you as a developer should avoid DOMStringList
. You don't create DOMStringList
objects yourself, but you get them from APIs such as Location.ancestorOrigins
, and these APIs are not deprecated. However, be careful of the semantic differences from a real array.
This interface is used in IndexedDB and in the Location
API:
Instance properties
DOMStringList.length
Read only-
Returns the size of the list.
Instance methods
DOMStringList.item()
-
Returns a string from the list with the given index.
DOMStringList.contains()
-
Returns a boolean indicating whether the given string is in the list.
Specifications
Specification |
---|
HTML Standard # the-domstringlist-interface |
Browser compatibility
BCD tables only load in the browser