DOMStringList
Базовая поддержка Широко поддерживается
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Примечание: Эта функция доступна в Web Workers.
Интерфейс DOMStringList — это устаревший тип, возвращаемый некоторыми API и представляющий собой список строк, который нельзя изменить (DOMString).
Этот интерфейс был попыткой создать неизменяемый список и продолжает поддерживаться только для того, чтобы не сломать код, который его уже использует. Современные API представляют структуры списков с использованием типов, основанных на JavaScript массивах, что делает доступными многие методы массивов, а также накладывает дополнительные семантические ограничения на их использование (например, делает их элементы только для чтения).
Эти исторические причины не означают, что вам, как разработчику, следует избегать DOMStringList. Вы сами не создаёте объекты DOMStringList, но получаете их из API, таких как Location.ancestorOrigins, и эти API не устарели. Однако будьте внимательны к семантическим различиям с реальным массивом.
Свойства экземпляра
-
DOMStringList.lengthТолько для чтения -
Возвращает размер списка.
Методы экземпляра
DOMStringList.item()-
Возвращает строку из списка по заданному индексу.
DOMStringList.contains()-
Возвращает булево значение, указывающее, содержится ли заданная строка в списке.
Спецификации
| Спецификация |
|---|
| HTML # the-domstringlist-interface |
Совместимость браузеров
| Десктопные | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
DOMStringList |
1 | 12 | 1 | ≤12.1 | 5.1 | 18 | 4 | ≤12.1 | 5 | 1.0 | 3 |
contains |
1 | 12 | 1.5 | ≤12.1 | 5.1 | 18 | 4 | ≤12.1 | 5 | 1.0 | 3 |
item |
1 | 12 | 1 | ≤12.1 | 5.1 | 18 | 4 | ≤12.1 | 5 | 1.0 | 3 |
length |
1 | 12 | 1 | ≤12.1 | 5.1 | 18 | 4 | ≤12.1 | 5 | 1.0 | ≤37 |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMStringList
