dexie-worker

The npm library dexie-worker by Parsa Gholipour acts as a proxy between the GUI thread and a worker. Instead of talking to the Dexie API, the proxy is used and it will communicate with the Dexie instance that operates in the Worker thread.

import Dexie, { Table } from "dexie";
import { getWebWorkerDB } from "dexie-worker";

const mainDb = new Dexie("MyDatabase") as Dexie & {
  products: Table<{ id: string, name: string }, string>
};
mainDb.version(1).stores({
  products: "id, name"
});
mainDb.open(); // initializing the database is required
const workerDb = getWebWorkerDB(mainDb);

// Query using main thread
await mainDb.products.bulkPut([
  { id: "foo", name: "Foo" },
  { id: "bar", name: "Bar" },
  ...
]);

// Query using worker
await workerDb.products.bulkPut([
  { id: "baz", name: "Baz" },
  { id: "qux", name: "Qux" },
  ...
]);

You can use either db or workerDb depending on where you want the queries to run.

NOTE: Dexie.js is fully supported in worker environments by itself, without this library. What dexie-worker does is to offer an easy API to delegate certain heavy queries to execute in a worker using normal dexie queries in the main thread that are delegated to worker under the hood (without having to implement the worker and communications manually).

dexie-worker not only supports promise based API but also observables (live queries) - using a slightly adjusted version of liveQuery and useLiveQuery that can perform the queries in the worker instead of the GUI thread.

dexie-worker's useLiveQuery
dexie-worker's liveQuery

Since dexie-worker mimics the dexie API, it allows app developers to easily switch between executing queries in worker or main thread depending on where it makes most sence.

Github repo: dexie-worker

Documentation