CKTIS / JavaScript
DOMStringList et vérification de présence avec contains()
DOMStringList est une liste de chaînes exposée par certaines API Web, que l’on ne modifie pas directement. Sa méthode contains() vérifie si une chaîne donnée figure dans la liste et renvoie un booléen. Un usage courant consiste à vérifier les noms de magasins d’objets dans 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
Syntaxe
list.contains(string)DOMStringList est une ancienne interface d’API Web qui représente une liste de chaînes. On l’obtient depuis une autre API au lieu de la créer avec new DOMStringList(). Par exemple, IDBDatabase.objectStoreNames est la liste des noms de magasins d’objets d’une base IndexedDB. Le caractère ancien de l’interface ne signifie pas que les API qui la renvoient sont obsolètes.
DOMStringList.contains, appelé sous la forme list.contains(string), renvoie true si la chaîne fournie figure dans la liste, ou false si elle en est absente. L’argument est obligatoire : appeler list.contains() sans argument déclenche une TypeError.
Ce n’est pas un tableau JavaScript ordinaire. Sa propriété length est en lecture seule et l’interface ne fournit aucune méthode de modification comme push() ou splice(). Les modifications se font par l’intermédiaire de l’API qui détient les données, et non via la liste elle-même.
Lorsqu’il utilise IndexedDB, l’exemple crée une base distincte avec un magasin d’objets nommé notes, vérifie la présence de deux noms et affiche les deux résultats dans la console : true pour notes et false pour missing. DOMStringList est une API de l’environnement navigateur, et non une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que l’interface et contains() sont largement disponibles depuis juillet 2015 ; la présence de Node 24 dans un dépôt ne confirme pas la prise en charge de ces API.
Exemples
<!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>Résultat
true false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.