DOMStringList

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

注意:此功能在 Web Workers 中可用。

DOMStringList 接口是一个旧类型,由一些 API 返回,代表一个不可修改的字符串(DOMString)列表。

这个接口曾是 创建不可修改列表的尝试,并且至今仍然被支持,以免破坏现有代码。现代 API 使用基于 JavaScript 数组 的类型来表示列表结构,从而提供了许多数组方法,同时对其使用施加了额外的语义(例如,使其项只读)。

这些历史原因并不意味着开发者应该避免使用 DOMStringList。你不会自己创建 DOMStringList 对象,而是从 Location.ancestorOrigins 等 API 获取它们,并且这些 API 没有被弃用。但是,要注意它与真实数组在语义上的差异。

此接口用于 IndexedDBLocation API 中。

实例属性

DOMStringList.length 只读

返回列表的大小。

实例方法

DOMStringList.item()

返回列表中具有给定索引的字符串。

DOMStringList.contains()

返回一个布尔值,指示给定的字符串是否存在于列表中。

规范

规范
HTML
# the-domstringlist-interface

浏览器兼容性