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

瀏覽器相容性