CKTIS / JavaScript
DOMStringList a kontrola prítomnosti pomocou contains()
DOMStringList je zoznam reťazcov sprístupnený niektorými webovými API, ktorý sa priamo neupravuje. Metóda contains() kontroluje, či sa v zozname nachádza zadaný reťazec, a vracia logickú hodnotu. Bežným použitím je kontrola názvov úložísk objektov v IndexedDB.
Verzia: 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 je staršie rozhranie Web API, ktoré predstavuje zoznam reťazcov. Získava sa z iného API, namiesto toho, aby sa vytváralo pomocou new DOMStringList(). Príkladom je IDBDatabase.objectStoreNames, zoznam názvov úložísk objektov v databáze IndexedDB. To, že je rozhranie staršie, neznamená, že API, ktoré ho vracajú, sú zastarané.
DOMStringList.contains, volané ako list.contains(string), vráti true, keď sa zadaný reťazec nachádza v zozname, alebo false, keď v ňom chýba. Argument je povinný: volanie list.contains() bez argumentu vyvolá TypeError.
Nie je to obyčajné pole JavaScriptu. Vlastnosť length je iba na čítanie a rozhranie neposkytuje metódy na úpravu, ako sú push() či splice(). Zmeny sa vykonávajú cez API, ktoré vlastní údaje, nie cez samotný zoznam.
Pri použití IndexedDB príklad vytvorí samostatnú databázu s úložiskom objektov notes, overí, či sa dva názvy nachádzajú v zozname, a vypíše oba výsledky do konzoly: true pre notes a false pre missing. DOMStringList je API prostredia prehliadača, nie funkcia konkrétnej edície ECMAScriptu. MDN označuje rozhranie a contains() za široko dostupné od júla 2015; prítomnosť Node 24 v repozitári nepotvrdzuje podporu týchto API.
Príklady
<!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>Výsledok
true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.