Breaking changes in 7.x

No longer committing build to GitHub.
Renamed files in dist.
Added conditional exports.
iife build is now a umd.

Breaking changes in 6.x

Some TypeScript definitions changed so write-methods are missing from 'readonly' transactions. This might be backwards-incompatible with code that performs a lot of type wrangling.

Breaking changes in 5.x

I moved some files around, so I bumped the major version for safety.

Changes in 4.x

Breaking changes

Opening a database

// Old 3.x way
import { openDb } from 'idb';

openDb('db-name', 1, (upgradeDb) => {
  console.log(upgradeDb.oldVersion);
  console.log(upgradeDb.transaction);
});

// New 4.x way
import { openDB } from 'idb';

openDB('db-name', 1, {
  upgrade(db, oldVersion, newVersion, transaction) {
    console.log(oldVersion);
    console.log(transaction);
  },
});

openDb and deleteDb were renamed openDB and deleteDB to be more consistent with DOM naming.
The signature of openDB changed. The third parameter used to be the upgrade callback, it's now an option object which can include an upgrade method.
There's no UpgradeDB anymore. You get the same database openDB resolves with. Versions numbers and the upgrade transaction are included as additional parameters.

Promises & throwing

The library turns all IDBRequest objects into promises, but it doesn't know in advance which methods may return promises.

As a result, methods such as store.put may throw instead of returning a promise.

If you're using async functions, there isn't a difference.

Other breaking changes

iterateCursor and iterateKeyCursor have been removed. These existed to work around browsers microtask issues which have since been fixed. Async iterators provide similar functionality.
All pseudo-private properties (those beginning with an underscore) are gone. Use unwrap() to get access to bare IDB objects.
transaction.complete was renamed to transaction.done to be shorter and more consistent with the DOM.
getAll is no longer polyfilled on indexes and stores.
The library no longer officially supports IE11.

New stuff

The library now uses proxies, so objects will include everything from their plain-IDB equivalents.
TypeScript support has massively improved, including the ability to provide types for your database.
Optional support for async iterators, which makes handling cursors much easier.
Database objects now have shortcuts for single actions (like get, put, add, getAll etc etc).
For transactions that cover a single store transaction.store is a reference to that store.
openDB lets you add callbacks for when your database is blocking another connection, or when you're blocked by another connection.

Changes in 3.x

The library became a module.

// Old 2.x way:
import idb from 'idb';
idb.open(…);
idb.delete(…);

// 3.x way:
import { openDb, deleteDb } from 'idb';
openDb(…);
deleteDb(…);

3 KiB Raw Blame History