此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

DOMStringList

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

备注: 此特性在 Web Worker 中可用。

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

该接口曾用于尝试创建不可修改列表而为了不破坏已经使用它的代码而继续被支持。现代 API 使用基于 JavaScript 数组的类型来表示列表结构,因而也支持了许多数组方法,同时也基于使用场景为其赋予了额外的语义(例如使其项目只读)。

这些历史原因并不意味着你作为开发者应该避免使用 DOMStringList。你不会自己创建 DOMStringList 对象,但你会从诸如 Location.ancestorOrigins 之类的未被弃用的 API 中获得这一对象。不过,要注意它与真正的数组之间的语义差异。

该接口目前用于 IndexedDBLocation API 中:

实例属性

DOMStringList.length 只读

返回列表的长度。

实例方法

DOMStringList.item()

返回列表中指定索引处的字符串。

DOMStringList.contains()

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

规范

Specification
HTML
# the-domstringlist-interface

浏览器兼容性