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