Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

DOMStringList y comprobación de pertenencia con contains()

DOMStringList es una lista de cadenas expuesta por algunas API web que no se modifica directamente. Su método contains() comprueba si una cadena indicada pertenece a la lista y devuelve un valor booleano. Un uso habitual es comprobar los nombres de los almacenes de objetos en IndexedDB.

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

Sintaxis

list.contains(string)

DOMStringList es una interfaz antigua de las API web que representa una lista de cadenas. Se obtiene de otra API, en lugar de crearla con new DOMStringList(). Un ejemplo es IDBDatabase.objectStoreNames, la lista de nombres de los almacenes de objetos de una base de datos IndexedDB. Que la interfaz sea antigua no significa que las API que la devuelven estén obsoletas.

DOMStringList.contains, llamado como list.contains(string), devuelve true cuando la cadena indicada está en la lista, o false cuando no está. El argumento es obligatorio: llamar a list.contains() sin argumentos lanza un TypeError.

No es un array normal de JavaScript. La propiedad length es de solo lectura y la interfaz no ofrece métodos de modificación como push() o splice(). Los cambios se realizan mediante la API propietaria de los datos, no a través de la propia lista.

Cuando usa IndexedDB, el ejemplo crea una base de datos independiente con un almacén de objetos llamado notes, comprueba si dos nombres están en la lista y muestra ambos resultados en la consola: true para notes y false para missing. DOMStringList es una API del entorno del navegador, no una característica de una edición concreta de ECMAScript. MDN indica que la interfaz y contains() están ampliamente disponibles desde julio de 2015; que Node 24 esté en un repositorio no demuestra que estas API sean compatibles.

Ejemplos

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

Resultado

true
false

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes