Fixes
Redesign
The big difference in this release from v3.0.0-alpha.3, is how we call IndexedDB. Instead of calling it directly, it will go through a middleware-enabled stack, DBCore.
NOTE: This is an internal redesign. The external API is still the same as in Dexie 2.0 so you won't have to adapt to the new possibilities that comes with this redesign, unless you want to use the new middleware api (Dexie.use()).
This rewrite is part of reaching the goals in vision for dexie, specifically it will enable asynchronic work to be done in a middleware, which is something covered in here.
To use it in this version, do:
import Dexie from 'dexie';
const db = new Dexie('dbname');
db.use({
stack: "dbcore", // The only stack supported so far.
name: "MyMiddleware", // Optional name of your middleware
create (downlevelDatabase) {
// Return your own implementation of DBCore:
return {
// Copy default implementation.
...downlevelDatabase,
// Override table method
table (tableName) {
// Call default table method
const downlevelTable = downlevelDatabase.table(tableName);
// Derive your own table from it:
return {
// Copy default table implementation:
...downlevelTable,
// Override the mutate method:
mutate: req => {
// Copy the request object
const myRequest = {...req};
// Do things before mutate, then
// call downlevel mutate:
return downlevelTable.mutate(myRequest).then(res => {
// Do things after mutate
const myResponse = {...res};
// Then return your response:
return myResponse;
});
}
}
}
};
}
});As the DBCore interface is still being figured out, it can change. And there is still no official documentation about it. In essence, all mutating operations are bulk-oriented. Theres only bulkPut(), bulkAdd(), bulkDelete() and deleteRange(). Currently all of these four are reached through a single method mutate(). (This might change in future).
Interface definitions for DBCore is found here
In this version, the CRUD hooks are called from a built-in middleware: hooksMiddleware: A middleware that makes sure to call CRUD hooks in a backward compatible manner.