JavaScript Academy · Lezione

Versionamento e aggiornamenti

Esegua la migrazione degli schemi con i cambi di versione.

Versionamento e aggiornamenti è una lezione JavaScript Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento JavaScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso JavaScript Academy include 4 lezioni in totale.

Perché gestire le versioni?

Le applicazioni si evolvono: si aggiungono object store e indici oppure cambia la struttura dei dati. IndexedDB usa un numero di versione per gestire in sicurezza queste modifiche allo schema nel browser di ogni utente.

Il numero di versione

Il secondo argomento di open è la versione, espressa come intero positivo. Aumentarlo comunica al browser che lo schema è cambiato e attiva un aggiornamento.

// Bumping from 1 to 2 triggers onupgradeneeded:
const request = indexedDB.open('app-db', 2);

La versione può solo aumentare

È possibile solo aumentare la versione. L'apertura con un numero inferiore a quello memorizzato non riesce e genera un errore. Non la decrementi mai.

// If the stored DB is version 3:
const req = indexedDB.open('app-db', 2);
req.onerror = () => console.log('cannot open older version');

oldVersion e newVersion

All'interno di onupgradeneeded, l'evento espone oldVersion e newVersion. Li utilizzi per applicare solo le migrazioni che non sono ancora state eseguite.

request.onupgradeneeded = (e) => {
  console.log('upgrading from', e.oldVersion, 'to', e.newVersion);
};

Migrazioni incrementali

Un modello affidabile consiste nell'usare un fall-through basato su oldVersion: ogni blocco si basa sul precedente, così un utente che utilizza qualsiasi versione precedente raggiunge lo schema più recente.

request.onupgradeneeded = (e) => {
  const db = e.target.result;
  if (e.oldVersion < 1) {
    db.createObjectStore('notes', { keyPath: 'id' });
  }
  if (e.oldVersion < 2) {
    db.createObjectStore('tags', { keyPath: 'name' });
  }
};

Aggiungere un indice in un secondo momento

Per aggiungere un indice a un object store esistente durante un aggiornamento, ottenga l'object store dalla transazione di aggiornamento e chiami createIndex su di esso.

request.onupgradeneeded = (e) => {
  if (e.oldVersion < 3) {
    const store = e.target.transaction.objectStore('notes');
    store.createIndex('byDate', 'createdAt');
  }
};

La transazione di modifica della versione

Durante onupgradeneeded, la transaction dell'evento è una transazione speciale di tipo versionchange. È l'unico contesto in cui è possibile modificare sia lo schema sia i dati.

request.onupgradeneeded = (e) => {
  const tx = e.target.transaction; // versionchange tx
  const store = tx.objectStore('notes');
  // migrate existing records here if needed
};

Migrare i dati esistenti

Se una modifica allo schema richiede di ristrutturare i record, iteri l'object store con un cursore durante l'aggiornamento e utilizzi put per salvare nuovamente i valori trasformati.

const store = e.target.transaction.objectStore('notes');
store.openCursor().onsuccess = (ev) => {
  const cursor = ev.target.result;
  if (cursor) {
    const note = cursor.value;
    note.archived = false; // new field
    cursor.update(note);
    cursor.continue();
  }
};

L'evento versionchange

Quando una scheda esegue un aggiornamento, le altre schede che contengono la versione precedente ricevono un evento versionchange sul proprio db. Devono chiudersi affinché l'aggiornamento non venga bloccato.

db.onversionchange = () => {
  db.close(); // let the other tab upgrade
  console.log('database is outdated, please reload');
};

Eliminare gli object store

Durante un aggiornamento è possibile rimuovere un object store obsoleto con db.deleteObjectStore(name). L'operazione lo elimina definitivamente insieme ai suoi dati.

request.onupgradeneeded = (e) => {
  const db = e.target.result;
  if (e.oldVersion < 4 && db.objectStoreNames.contains('temp')) {
    db.deleteObjectStore('temp');
  }
};

Procedure consigliate per gli aggiornamenti

Mantenga le migrazioni idempotenti e ordinate in base a oldVersion, chiuda le connessioni precedenti in caso di versionchange e testi gli aggiornamenti partendo da ogni versione precedente. In questo modo i dati degli utenti abituali rimangono intatti.

Verifica rapida

Metta alla prova la Sua comprensione della gestione delle versioni e degli aggiornamenti.

Riepilogo

Ha imparato a gestire le versioni e gli aggiornamenti:

Aumenti il numero di versione per attivare onupgradeneeded.
Utilizzi oldVersion per migrazioni incrementali e idempotenti.
La transazione versionchange dell'aggiornamento modifica lo schema e i dati.
Migri i record con un cursore e cursor.update.
Chiuda le schede precedenti in risposta all'evento versionchange.

Ha completato IndexedDB. Ora vediamo i Service Worker.

Domande Frequenti

La lezione «Versionamento e aggiornamenti» è gratuita?

Sì — il testo completo di «Versionamento e aggiornamenti» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso JavaScript Academy, passa a CoddyKit PRO. Il corso JavaScript Academy include 4 lezioni in totale.

Cosa imparerò in «Versionamento e aggiornamenti»?

Esegua la migrazione degli schemi con i cambi di versione. Eserciti JavaScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare JavaScript Academy?

Non è richiesta alcuna esperienza precedente. JavaScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Versionamento e aggiornamenti»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione JavaScript Academy?

Sì. Ogni lezione JavaScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a JavaScript Academy