CKTIS / JavaScript
DOMStringList und Mitgliedschaftsprüfungen mit contains()
DOMStringList ist eine Liste von Zeichenfolgen, die von einigen Web-APIs bereitgestellt wird und die du nicht direkt veränderst. Die Methode contains() prüft, ob eine angegebene Zeichenfolge in der Liste enthalten ist, und gibt einen booleschen Wert zurück. Ein typischer Anwendungsfall ist die Prüfung von Objektspeichernamen in IndexedDB.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
list.contains(string)DOMStringList ist eine ältere Web-API-Schnittstelle, die eine Liste von Zeichenfolgen darstellt. Du erhältst sie von einer anderen API, statt sie mit new DOMStringList() zu erstellen. Ein Beispiel ist IDBDatabase.objectStoreNames, die Liste der Namen von Objektspeichern in einer IndexedDB-Datenbank. Dass die Schnittstelle älter ist, bedeutet nicht, dass APIs, die sie zurückgeben, veraltet sind.
DOMStringList.contains, aufgerufen als list.contains(string), gibt true zurück, wenn die angegebene Zeichenfolge in der Liste enthalten ist, andernfalls false. Das Argument ist erforderlich: Ein Aufruf von list.contains() ohne Argument löst einen TypeError aus.
Dies ist kein gewöhnliches JavaScript-Array. Die Eigenschaft length ist schreibgeschützt, und die Schnittstelle bietet keine Methoden zum Ändern wie push() oder splice(). Änderungen werden über die API vorgenommen, der die Daten gehören, nicht über die Liste selbst.
Bei Verwendung von IndexedDB erstellt das Beispiel eine separate Datenbank mit einem Objektspeicher namens notes, prüft, ob zwei Namen in der Liste stehen, und gibt beide Ergebnisse in der Konsole aus: true für notes und false für missing. DOMStringList ist eine API der Browserumgebung und keine Funktion einer bestimmten ECMAScript-Version. MDN kennzeichnet die Schnittstelle und contains() seit Juli 2015 als weitgehend verfügbar; dass sich Node 24 in einem Repository befindet, belegt nicht die Verfügbarkeit dieser APIs.
Beispiele
<!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>Ergebnis
true false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.