Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DOMStringList e verifica dell’appartenenza con contains()

DOMStringList è un elenco di stringhe esposto da alcune API Web, che non si modifica direttamente. Il metodo contains() verifica se una stringa specificata è presente nell’elenco e restituisce un valore booleano. Un uso tipico è controllare i nomi degli object store in IndexedDB.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

list.contains(string)

DOMStringList è una vecchia interfaccia delle API Web che rappresenta un elenco di stringhe. Si ottiene da un’altra API, invece di crearla con new DOMStringList(). Un esempio è IDBDatabase.objectStoreNames, l’elenco dei nomi degli object store di un database IndexedDB. Il fatto che l’interfaccia sia datata non significa che le API che la restituiscono siano deprecate.

DOMStringList.contains, chiamato come list.contains(string), restituisce true se la stringa specificata è presente nell’elenco, oppure false se è assente. L’argomento è obbligatorio: chiamare list.contains() senza argomenti genera un TypeError.

Non è un normale array JavaScript. La proprietà length è di sola lettura e l’interfaccia non offre metodi di modifica come push() o splice(). Le modifiche si effettuano tramite l’API proprietaria dei dati, non attraverso l’elenco stesso.

Quando usa IndexedDB, l’esempio crea un database separato con un object store chiamato notes, verifica se due nomi sono presenti nell’elenco e stampa entrambi i risultati nella console: true per notes e false per missing. DOMStringList è un’API dell’ambiente browser, non una funzionalità di una specifica edizione di ECMAScript. MDN indica che l’interfaccia e contains() sono ampiamente disponibili da luglio 2015; la presenza di Node 24 in un repository non dimostra il supporto di queste API.

Esempi

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

Risultato

true
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti