indexDb 增删改查工具

快速上手

使用 npm 包

npm i r-indexdb -S

在函数中使用

import RIndexDb from 'r-indexdb';
const dbInst = new RIndexDb('dbName',[{name:'tbName',keyPath:'id'}])

async function findById(id){
    await dbInst.ready();
    const ret = await dbInst.findByPk('tbName',id);
    return ret;
}

使用方式

在使用该工具进行增删改查之前，需要先调用 await dbInst.ready()方法等待初始化完毕。

API

获取实例

const dbInst = new RIndexDb(databaseName: string,tbConfigs?: TbConfig[], dbVersion?: number,);

databaseName // 新建或者打开的库名
dbVersion // 库版本号默认为 1
tbConfigs // 库中需要使用的表的配置。

interface TbConfig {
    name: string; // 表名
    autoIncrement?: boolean; // 是否自增主键
    keyPath?: string; // 主键字段
    indexs?: IndexConfig[]; // 表索引配置
}

interface IndexConfig {
    name: string; // 索引名，不能重复
    prop: string; // 在存储对象上的那个属性上建立索引，可以是一个单个的key值，也可以是一个包含key值集合的数组
    config?: {
        unique: boolean; // 用来指定索引值是否可以重复，为true代表不能相同，为false时代表可以相同
        multiEntry: boolean; // 当第二个参数keyPath为一个数组时，如果multiEntry是true，则会以数组中的每个元素建立一条索引，如果是false，则以整个数组为keyPath值，添加一条索引
}

操作数据

1、单条新增数据create。
create(tbName: string, data: any): Promise<unknown>;
2、批量新增数据bulkCreate。
bulkCreate(tbName: string, datas: any[]): Promise<unknown>;
3、通过主键查找数据findByPk。
findByPk(tbName: string, keyPath: string): Promise<unknown>;
4、通过索引查找数据findByIndex。
findByIndex(tbName: string, indexName: string, keyPath: string): Promise<unknown>;
5、通过函数过滤查找数据query。
query(tbName: string, filter?: (item: any) => boolean): Promise<unknown>;
6、通过主键来更新数据update。
update(tbName: string, data: any): Promise<unknown>;
7、通过主键删除数据delete。
delete(tbName: string, keyPath: string): Promise<unknown>;
8、如果无法通过主键来更新和删除数据，可以使用 forEach来cursor进行操作。
forEach(tbName: string, callback: (cursor: any) => void): Promise<unknown>;

使用cursor.value拿到数据.
使用cursor.updata()更新数据.
使用cursor.delete()删除数据.
使用cursor.continue()读取下一条数据.

9、新增表createStore
createStore(tbName: string, tconfig?: Omit<TbConfig, "name">): IDBObjectStore | undefined;
10、新增索引createIndex。
createIndex(tb: string | IDBObjectStore | undefined, index: IndexConfig): boolean;
11、删除表中所有数dropStore。
dropStore(tbName: string): Promise<unknown>;

indexdb查询工具r-indexdb