DOMStringList

DOMStringList 接口是某些 API 返回的遗留类型,表示一个不可修改的字符串 (DOMString) 列表。

此接口是 创建不可修改列表的尝试,并且仅继续支持它,以免破坏已经使用它的代码。现代 API 使用基于 JavaScript 数组 的类型来表示列表结构,从而使许多数组方法可用,同时对它们的用法施加了额外的语义(例如,使它们中的项只读)。

这些历史原因并不意味着您作为开发人员应该避免使用 DOMStringList。您不会自己创建 DOMStringList 对象,但您会从 API(如 Location.ancestorOrigins)中获得它们,并且这些 API 并未被弃用。但是,请注意与真实数组的语义差异。

此接口在 IndexedDBLocation API 中使用

实例属性

DOMStringList.length 只读

返回列表的大小。

实例方法

DOMStringList.item()

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

DOMStringList.contains()

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

规范

规范
HTML 标准
# the-domstringlist-interface

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。