DOMStringList

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since July 2015.

Learn more
See full compatibility

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 # the-domstringlist-interface

Browser compatibility

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Oct 8, 2024 by MDN contributors.

View this page on GitHub Report a problem with this content