Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMStringList i provjera pripadnosti pomoću contains()

DOMStringList je popis nizova koji izlažu neki Web API-ji i koji se ne mijenja izravno. Metoda contains() provjerava nalazi li se zadani niz na popisu i vraća logičku vrijednost. Uobičajena je primjena provjera naziva spremišta objekata u IndexedDB-u.

Verzija: 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 starije sučelje Web API-ja koje predstavlja popis nizova. Dobiva se od drugog API-ja, umjesto da se izrađuje pomoću new DOMStringList(). Primjer je IDBDatabase.objectStoreNames, popis naziva spremišta objekata u bazi podataka IndexedDB. To što je sučelje starije ne znači da su API-ji koji ga vraćaju zastarjeli.

DOMStringList.contains, pozvan kao list.contains(string), vraća true ako se zadani niz nalazi na popisu, odnosno false ako ga nema. Argument je obavezan: poziv list.contains() bez argumenta izaziva TypeError.

To nije običan JavaScriptov niz. Svojstvo length namijenjeno je samo za čitanje, a sučelje ne nudi metode za izmjenu kao što su push() ili splice(). Promjene se obavljaju putem API-ja koji posjeduje podatke, a ne putem samog popisa.

Kad koristi IndexedDB, primjer stvara zasebnu bazu podataka sa spremištem objekata notes, provjerava jesu li dva naziva na popisu i ispisuje oba rezultata u konzolu: true za notes i false za missing. DOMStringList je API okruženja preglednika, a ne značajka određene inačice ECMAScripta. MDN navodi da su sučelje i contains() široko dostupni od srpnja 2015.; prisutnost Node 24 u repozitoriju ne potvrđuje podršku za te API-je.

Primjeri

<!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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori