Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

IDBDatabase — una connessione a un database IndexedDB

IDBDatabase rappresenta una connessione aperta a un database IndexedDB. Consente di creare archivi durante gli aggiornamenti dello schema, avviare transazioni e chiudere la connessione.

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

const request = indexedDB.open(name, version);
// In upgradeneeded:
const store = request.result.createObjectStore(storeName, options);
// After open succeeds:
const db = request.result;
db.objectStoreNames;
const tx = db.transaction(storeNames, "readonly");
db.onversionchange = () => db.close();

Ottieni un IDBDatabase in request.result quando indexedDB.open() ha esito positivo. È una Web API, non fa parte di ECMAScript; Node 24 non dimostra il supporto nei browser. Verifica che indexedDB sia disponibile nell’ambiente di destinazione; le specifiche citate non sono tabelle di compatibilità dei browser.

IDBDatabase.createObjectStore() funziona solo all’interno di una transazione di aggiornamento attiva, di solito in upgradeneeded. IDBDatabase.objectStoreNames restituisce una DOMStringList ordinata di nomi, non un array. Se necessario, usa .contains() prima di creare un archivio.

IDBDatabase.transaction() specifica l’ambito degli archivi e la modalità: readonly per impostazione predefinita oppure readwrite. Non consente di creare manualmente una transazione versionchange. Accoda le operazioni mentre la transazione è attiva; non presumere che resti attiva dopo chiamate await arbitrarie. Il successo di una richiesta non significa che la transazione sia stata confermata: attendi complete della transazione.

In risposta a una richiesta di apertura del database con un numero di versione superiore o a una richiesta di eliminazione, IndexedDB invia l’evento IDBDatabase.versionchange alle connessioni esistenti al database, tranne quelle con il flag close pending impostato. Queste connessioni non ricevono l’evento nemmeno se restano aperte fino al termine delle transazioni in corso. Non serve una connessione già aperta per effettuare la richiesta, e una richiesta di eliminazione non apre alcuna connessione. Gestisci l’evento con onversionchange. È distinto da upgradeneeded. IDBDatabase.close() impedisce nuove transazioni e chiude la connessione al termine di quelle esistenti, senza eliminare i dati. Le connessioni lasciate aperte possono bloccare gli aggiornamenti.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Using an IDBDatabase connection</title>
</head>
<body>
<script>
  (() => {
    const name = `cktis-connection-${Date.now()}-${Math.random()}`;
    const unavailable = () => console.log('IndexedDB unavailable in this context.');
    let open;
    try {
      // Opening a connection requires a context that permits IndexedDB.
      open = indexedDB.open(name, 1);
    } catch {
      unavailable();
      return;
    }
    open.onerror = unavailable;
    open.onupgradeneeded = () => {
      open.result.createObjectStore('notes', { keyPath: 'id' });
    };
    open.onsuccess = () => {
      const db = open.result;
      const tx = db.transaction('notes', 'readwrite');
      const store = tx.objectStore('notes');
      store.put({ id: 1, text: 'Hello' });
      const read = store.get(1);
      function cleanup() {
        db.close();
        indexedDB.deleteDatabase(name);
      }
      tx.oncomplete = () => {
        console.log(read.result.text);
        cleanup();
      };
      tx.onabort = () => {
        cleanup();
        console.log('Database transaction aborted.');
      };
    };
  })();
</script>
</body>
</html>

Risultato

Hello

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