CKTIS / JavaScript
DOMStringList и проверка за наличие с contains()
DOMStringList е списък от низове, предоставян от някои Web API, който не се променя директно. Методът contains() проверява дали подаден низ присъства в списъка и връща булева стойност. Типична употреба е проверка на имената на обектните хранилища в IndexedDB.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
list.contains(string)DOMStringList е по-стар интерфейс на Web API, който представя списък от низове. Получава се от друг API, вместо да се създава с new DOMStringList(). Пример е IDBDatabase.objectStoreNames — списъкът с имена на обектните хранилища в база данни IndexedDB. Това, че интерфейсът е по-стар, не означава, че API-тата, които го връщат, са остарели.
DOMStringList.contains, извикан като list.contains(string), връща true, когато подаденият низ е в списъка, или false, когато липсва. Аргументът е задължителен: извикването на list.contains() без аргумент хвърля TypeError.
Това не е обикновен JavaScript масив. Свойството length е само за четене, а интерфейсът не предоставя методи за промяна като push() или splice(). Промените се правят чрез API-то, което притежава данните, а не чрез самия списък.
Когато използва IndexedDB, примерът създава отделна база данни с обектно хранилище notes, проверява дали две имена присъстват в списъка и извежда двата резултата в конзолата: true за notes и false за missing. DOMStringList е API на средата на браузъра, а не функция на конкретно издание на ECMAScript. MDN отбелязва интерфейса и contains() като широко достъпни от юли 2015 г.; наличието на Node 24 в хранилище не доказва поддръжка на тези API.
Примери
<!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>Резултат
true false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.