CKTIS / JavaScript
DOMStringList en lidmaatschapscontroles met contains()
DOMStringList is een lijst met tekenreeksen die door sommige Web-API’s wordt aangeboden en die je niet rechtstreeks wijzigt. De methode contains() controleert of een opgegeven tekenreeks in de lijst staat en retourneert een boolean. Een veelvoorkomend gebruik is het controleren van objectstore-namen in IndexedDB.
Versie: 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 is een oudere Web-API-interface die een lijst met tekenreeksen voorstelt. Je krijgt deze van een andere API, in plaats van haar te maken met new DOMStringList(). Een voorbeeld is IDBDatabase.objectStoreNames, de lijst met namen van objectstores in een IndexedDB-database. Dat de interface ouder is, betekent niet dat API’s die deze retourneren verouderd zijn.
DOMStringList.contains, aangeroepen als list.contains(string), retourneert true als de opgegeven tekenreeks in de lijst staat, of false als die ontbreekt. Het argument is verplicht: een aanroep van list.contains() zonder argument veroorzaakt een TypeError.
Dit is geen gewone JavaScript-array. De eigenschap length is alleen-lezen en de interface biedt geen wijzigingsmethoden zoals push() of splice(). Wijzigingen worden uitgevoerd via de API die eigenaar is van de gegevens, niet via de lijst zelf.
Als het voorbeeld IndexedDB gebruikt, maakt het een aparte database met een objectstore met de naam notes, controleert het of twee namen in de lijst staan en logt het beide resultaten in de console: true voor notes en false voor missing. DOMStringList is een API van de browseromgeving, geen functie van een bepaalde ECMAScript-editie. MDN markeert de interface en contains() sinds juli 2015 als breed beschikbaar; de aanwezigheid van Node 24 in een repository bewijst niet dat deze API’s worden ondersteund.
Voorbeelden
<!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>Resultaat
true false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.