简介
@magic-libraries/db 是一个针对前端开发的数据库操作工具,能够方便地进行数据的增删改查等操作。它基于 Promise 和 IndexedDB 实现,支持多表操作,拥有良好的性能和可扩展性。
安装
可以直接使用 npm 进行安装:
npm install @magic-libraries/db
引入
可以通过 ES6 的 import 语法引入库:
import { MagicDB } from '@magic-libraries/db';
或者通过 require 引入:
const { MagicDB } = require('@magic-libraries/db');
使用
初始化
使用 MagicDB 构造函数可以初始化数据库实例,接受一个参数,该参数为数据库的名称:
const magicDB = new MagicDB('mydb');
表操作
在我们进行数据存储操作之前,需要在数据库中创建表。可以通过 magicDB.table() 方法创建表,如下所示:
const userTable = magicDB.table('users');
table 方法接受一个参数,表示表的名称。
插入数据
可以使用 table.put() 方法插入一条数据。该方法接受一个对象作为参数,该对象的键为表中的字段名,值为字段对应的值。
-- -------------------- ---- ------- --------------- ----- ------ ---- --- ---- ------ ---------- -- - --------------------- ----------- -- - --------------------- ---
查询数据
可以使用 table.get() 方法查询一条记录。该方法接受单个参数,表示查询条件。查询条件为一个对象,该对象的键为表中的字段名,值为字段的值。如果要查询多条数据,则可以使用 table.where() 方法,该方法返回一个链式调用的对象。链式调用的每个方法都代表一个查询条件,多个条件之间是 And 的关系。
userTable.where('sex').equals('male').toArray().then(users => { console.log(users); }).catch(() => { console.log('查询失败!'); });
以上示例查询了表中 sex 字段等于 'male' 的数据。
更新数据
使用 table.put() 方法可以对已有的记录进行更新。这个方法的用法与插入数据相似,唯一的不同是需要指定目标记录的主键。
-- -------------------- ---- ------- --------------- ------- -- ----- ------- ---- --- ---- ------ ---------- -- - --------------------- ----------- -- - --------------------- ---
该示例将主键为 1 的记录的 name 字段更新为 'tony'。
删除数据
使用 table.delete() 方法可以删除一条记录。该方法接受一个参数,表示要删除的记录的主键。
userTable.delete(1).then(() => { console.log('删除成功!'); }).catch(() => { console.log('删除失败!'); });
以上示例将主键为 1 的记录删除。
示例代码
唯一的不同是需要指定目标记录的主键。
-- -------------------- ---- ------- ------ - ------- - ---- ---------------------- ----- ------- - --- ---------------- ----- --------- - ----------------------- --------------- ----- ------ ---- --- ---- ------ ---------- -- - --------------------- ----------- -- - --------------------- --- ---------------------------------------------------------- -- - ------------------- ----------- -- - --------------------- --- --------------- ------- -- ----- ------- ---- --- ---- ------ ---------- -- - --------------------- ----------- -- - --------------------- --- --------------------------- -- - --------------------- ----------- -- - --------------------- ---
总结
@magic-libraries/db 是一个非常实用的前端数据库操作工具,可以帮助我们在 Web 应用中快速地实现数据存储和操作。使用该工具,我们不仅可以提高开发效率,而且可以减少代码量,从而更好地维护代码。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5f0c0d7b403f2923b035c13a