JavaScript Academy · Les

Versiebeheer en upgrades

Migreer schema's wanneer versies veranderen.

Les 4 van 413 stappen

Versiebeheer en upgrades is een gratis JavaScript Academy-les op CoddyKit. Dit is les 4 van 4. Je kunt 3 lessen uit dit leerpad gratis volledig lezen — daarna ontgrendelt CoddyKit PRO alle lessen, plus praktische oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject JavaScript Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus JavaScript Academy bevat in totaal 4 lessen.

Waarom versiebeheer?

Apps blijven zich ontwikkelen: je voegt opslagen en indexen toe of verandert de structuur van gegevens. IndexedDB gebruikt een versienummer om deze schemaveranderingen veilig te beheren in de browser van elke gebruiker.

Het versienummer

Het tweede argument van open is de versie, een positief geheel getal. Als je dit getal verhoogt, laat je de browser weten dat het schema is veranderd en wordt een upgrade gestart.

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

Een upgrade kan alleen omhoog

Je kunt de versie alleen verhogen. Als je een lager nummer opent dan het opgeslagen nummer, mislukt dat met een fout. Verlaag het nummer nooit.

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

oldVersion en newVersion

Binnen onupgradeneeded bevat de gebeurtenis oldVersion en newVersion. Gebruik deze om alleen de migraties uit te voeren die nog niet zijn uitgevoerd.

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

Incrementele migraties

Een robuust patroon is een doorvalconstructie met oldVersion: elk blok bouwt voort op het vorige, zodat een gebruiker met elke oude versie het nieuwste schema bereikt.

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' });
  }
};

Later een index toevoegen

Als je tijdens een upgrade een index aan een bestaande opslag wilt toevoegen, haal je de opslag op uit de upgradetransactie en roep je daarop createIndex aan.

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

De versionchange-transactie

Tijdens onupgradeneeded is de transaction van de gebeurtenis een speciale versionchange-transactie. Dit is de enige context waarin je zowel het schema kunt wijzigen als gegevens kunt migreren.

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

Bestaande gegevens migreren

Als een schemaverandering vereist dat je records herstructureert, doorloop je de opslag tijdens de upgrade met een cursor en sla je de getransformeerde waarden opnieuw op met put.

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();
  }
};

De gebeurtenis versionchange

Wanneer één tabblad een upgrade uitvoert, ontvangen andere tabbladen met de oude versie een gebeurtenis versionchange op hun db. Ze moeten worden gesloten, zodat de upgrade niet wordt geblokkeerd.

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

Opslagen verwijderen

Je kunt tijdens een upgrade een verouderde opslag verwijderen met db.deleteObjectStore(name). De opslag en de gegevens erin worden dan definitief verwijderd.

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

Aanbevolen werkwijzen voor upgrades

Houd migraties idempotent en orden ze op oldVersion, sluit oude verbindingen bij versionchange en test upgrades vanaf elke vorige versie. Zo blijven de gegevens van terugkerende gebruikers intact.

Korte controle

Test je begrip van versiebeheer en upgrades.

Beantwoord dit in de interactieve les

Samenvatting

Je hebt versiebeheer en upgrades geleerd:

Verhoog het versienummer om onupgradeneeded te starten.
Gebruik oldVersion voor incrementele, idempotente migraties.
Met de versionchange-transactie van de upgrade wijzig je het schema en de gegevens.
Migreer records met een cursor en cursor.update.
Sluit oude tabbladen bij de gebeurtenis versionchange.

Je hebt IndexedDB afgerond. Hierna volgen Service Workers.

Gratis beginnen

Leer JavaScript met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 59
Lessen: 200

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “Versiebeheer en upgrades” gratis?

Ja — je kunt hier op het web alle 3 lessen van het leerpad JavaScript Academy, waaronder “Versiebeheer en upgrades”, gratis volledig lezen. Daarna ontgrendelt CoddyKit PRO alle lessen, plus interactieve oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. De cursus JavaScript Academy bevat in totaal 4 lessen.

Wat leer ik in “Versiebeheer en upgrades”?

Migreer schema's wanneer versies veranderen. Je oefent met JavaScript Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met JavaScript Academy te beginnen?

Ervaring vooraf is niet nodig. JavaScript Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 4 van 4.

Hoe lang duurt de les “Versiebeheer en upgrades”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over JavaScript Academy?

Ja. Elke les over JavaScript Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

← Terug naar JavaScript Academy