CKTIS / JavaScript
DOMStringList i sprawdzanie obecności przez contains()
DOMStringList to udostępniana przez niektóre Web API lista ciągów znaków, której nie modyfikuje się bezpośrednio. Metoda contains() sprawdza obecność podanego ciągu i zwraca wartość logiczną. Typowym zastosowaniem jest sprawdzanie nazw magazynów obiektów w IndexedDB.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
list.contains(string)DOMStringList to starszy interfejs Web API reprezentujący listę ciągów znaków. Otrzymujesz go z innego API, zamiast tworzyć przez new DOMStringList(). Przykładem jest IDBDatabase.objectStoreNames, czyli lista nazw magazynów obiektów bazy IndexedDB. Starszy charakter interfejsu nie oznacza, że API, które go zwracają, są przestarzałe.
DOMStringList.contains, wywoływane jako list.contains(string), zwraca true, gdy podany ciąg znajduje się na liście, albo false, gdy go nie ma. Argument jest wymagany: wywołanie list.contains() bez argumentu zgłasza TypeError.
To nie jest zwykła tablica JavaScript. Właściwość length jest tylko do odczytu, a interfejs nie udostępnia metod modyfikujących takich jak push() czy splice(). Zmiany wykonuje się przez API będące źródłem danych, nie przez samą listę.
W wariancie wykorzystującym IndexedDB przykład tworzy osobną bazę danych z magazynem notes, sprawdza obecność dwóch nazw i wypisuje w konsoli wyniki obu sprawdzeń: true dla notes i false dla missing. DOMStringList jest API środowiska przeglądarkowego, a nie funkcją określonej edycji ECMAScript. MDN oznacza interfejs i contains() jako szeroko dostępne od lipca 2015 r.; sama obecność Node 24 w repozytorium nie potwierdza dostępności tych API.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOMStringList membership</title>
</head>
<body>
<script>
(() => {
function checkMembership(list, present) {
console.log(list.contains(present));
console.log(list.contains('missing'));
}
function useAncestorOrigins() {
// Chromium also exposes a DOMStringList through Location.ancestorOrigins.
// A local child document has at least one ancestor without using storage.
const frame = document.createElement('iframe');
frame.hidden = true;
frame.title = 'DOMStringList test fixture';
frame.srcdoc = '<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Local fixture</title></head><body></body></html>';
frame.addEventListener('load', () => {
const list = frame.contentWindow.location.ancestorOrigins;
if (list?.length) {
checkMembership(list, list.item(0));
} else {
console.warn('Skipping membership checks: IndexedDB could not be opened and Location.ancestorOrigins is unavailable or empty.');
}
frame.remove();
}, { once: true });
document.body.append(frame);
}
const name = `cktis-list-${Date.now()}-${Math.random()}`;
let open;
try {
open = indexedDB.open(name, 1);
} catch {
useAncestorOrigins();
return;
}
open.onerror = useAncestorOrigins;
open.onupgradeneeded = () => open.result.createObjectStore('notes');
open.onsuccess = () => {
const db = open.result;
checkMembership(db.objectStoreNames, 'notes');
db.close();
indexedDB.deleteDatabase(name);
};
})();
</script>
</body>
</html>Wynik
true false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.