CKTIS / JavaScript
DOMStringList in preverjanje prisotnosti z contains()
DOMStringList je seznam nizov, ki ga ponujajo nekateri spletni API-ji in ga ne spreminjamo neposredno. Metoda contains() preveri, ali je podani niz v seznamu, in vrne logično vrednost. Pogosta uporaba je preverjanje imen shramb objektov v IndexedDB.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
list.contains(string)DOMStringList je starejši vmesnik Web API, ki predstavlja seznam nizov. Dobimo ga iz drugega API-ja, namesto da bi ga ustvarili z new DOMStringList(). Primer je IDBDatabase.objectStoreNames, seznam imen shramb objektov v zbirki podatkov IndexedDB. To, da je vmesnik starejši, ne pomeni, da so API-ji, ki ga vračajo, zastareli.
DOMStringList.contains, klican kot list.contains(string), vrne true, če je podani niz v seznamu, oziroma false, če ga ni. Argument je obvezen: klic list.contains() brez argumenta sproži TypeError.
To ni običajna JavaScriptova tabela. Lastnost length je samo za branje, vmesnik pa ne ponuja metod za spreminjanje, kot sta push() ali splice(). Spremembe se izvedejo prek API-ja, ki je lastnik podatkov, ne prek samega seznama.
Ko primer uporabi IndexedDB, ustvari ločeno zbirko podatkov s shrambo objektov notes, preveri, ali sta dve imeni na seznamu, in v konzolo izpiše oba rezultata: true za notes in false za missing. DOMStringList je API okolja brskalnika, ne funkcija določene izdaje ECMAScripta. MDN označuje vmesnik in contains() kot široko dostopna od julija 2015; prisotnost Node 24 v repozitoriju ne dokazuje podpore za te API-je.
Primeri
<!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>Rezultat
true false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.