设置 API
优质
小牛编辑
125浏览
2023-12-01
通过这些方法可选择驱动或配置数据库。这些方法通常应该在第一个 数据 API
调用之前调用(即在你调用 getItem()
或 length()
之前)
setDriver
// 强制设置 localStorage 为后端的驱动
localforage.setDriver(localforage.LOCALSTORAGE);
// 列出可选的驱动,以优先级排序
localforage.setDriver([localforage.WEBSQL, localforage.INDEXEDDB]);
setDriver(driverName)
setDriver([driverName, nextDriverName])
若可用,强制设置特定的驱动。
默认情况下,localForage 按照以下顺序选择数据仓库的后端驱动:
- IndexedDB
- WebSQL
- localStorage
如果你想强制使用特定的驱动,可以使用 setDriver()
,参数为以下的某一个或多个:
localforage.INDEXEDDB
localforage.WEBSQL
localforage.LOCALSTORAGE
config
// 将数据库从 “localforage” 重命名为 “Hipster PDA App”
localforage.config({
name: 'Hipster PDA App'
});
// 将强制使用 localStorage 作为存储驱动,即使其他驱动可用。
// 可用配置代替 `setDriver()`。
localforage.config({
driver: localforage.LOCALSTORAGE,
name: 'I-heart-localStorage'
});
// 配置不同的驱动优先级
localforage.config({
driver: [localforage.WEBSQL,
localforage.INDEXEDDB,
localforage.LOCALSTORAGE],
name: 'WebSQL-Rox'
});
config(options)
设置 localForage 选项。在调用 localForage 前必先调用它,但可以在 localForage 被加载后调用。使用此方法设置的任何配置值都将保留,即使在驱动更改后,所以你也可以先调用 config()
再次调用 setDriver()
。以下配置值可以设置:
- driver
- 要使用的首选驱动。与上面的
setDriver
的值格式相同。
默认值:[localforage.INDEXEDDB, localforage.WEBSQL, localforage.LOCALSTORAGE]
- name
- 数据库的名称。可能会在在数据库的提示中会出现。一般使用你的应用程序的名字。在 localStorage 中,它作为存储在 localStorage 中的所有 key 的前缀。
默认值:'localforage'
- size
- 数据库的大小(以字节为单位)。现在只用于WebSQL。 默认值:
4980736
- storeName
- 数据仓库的名称。在 IndexedDB 中为
dataStore
,在 WebSQL 中为数据库 key/value 键值表的名称。仅含字母和数字和下划线。任何非字母和数字字符都将转换为下划线。
默认值:'keyvaluepairs'
- version
- 数据库的版本。将来可用于升级; 目前未使用。
默认值:1.0
- description
- 数据库的描述,一般是提供给开发者的。
默认值:''