JavaScript 库-localforage离线存储

localforage 是一个使用 Web 存储 API （例如 IndexedDB、WebSQL 或 localStorage）来提供简单的异步数据存储的 JavaScript 库。localforage 可以用来在客户端存储数据，比如本地缓存。

1.localforage 如何设置过期时间

• 可以使用 setItem() 方法并添加一个时间戳来存储数据，然后在获取数据时检查时间戳，如果过期了则删除数据并返回 null。

// 设置一个过期时间为1小时的数据
var expires = new Date().getTime() + 3600 * 1000; // 当前时间戳 + 1小时的毫秒数
var data = {
  key: 'value',
  expires: expires
};

// 将数据存储到 localForage 中
localforage.setItem('dataKey', data).then(function() {
  console.log('Data stored');
}).catch(function(err) {
  console.log('Error: ' + err);
});

// 获取数据时检查过期时间
localforage.getItem('dataKey').then(function(data) {
  if (data && new Date().getTime() < data.expires) {
    console.log('Data not expired');
    console.log(data.key);
  } else {
    console.log('Data expired or not found');
    localforage.removeItem('dataKey');
  }
}).catch(function(err) {
  console.log('Error: ' + err);
});

• 在这个示例中，我们创建了一个名为 data 的对象，并将其存储到 localForage 中。该对象包含一个 expires 属性，其值为当前时间加上一个小时的时间戳。在获取数据时，我们首先检查数据是否存在并且没有过期，如果数据有效，我们就可以获取其中的值。如果数据过期或不存在，我们就删除它。

• 注意，这个方法并不是 localForage 内置的方法，但是可以用来实现类似于过期时间的功能。如果需要更高级的功能，建议使用专门的过期时间库或插件。

2.关于存储的高级写法，localforage 除了提供基本的 setItem() 和 getItem() 方法外，还提供了许多其他的方法，比如：

• keys(): 获取所有已存储的键名
• iterate(): 遍历所有键值对
• removeItem(): 删除指定键名的键值对
• clear(): 删除所有已存储的键值对

以下是一些示例：

// 使用 iterate() 方法遍历所有已存储的键值对
localforage.iterate(function(value, key, index) {
    console.log(key, value);
}).then(function() {
    console.log('Iteration has completed');
}).catch(function(err) {
    console.log(err);
});

// 使用 keys() 方法获取所有已存储的键名
localforage.keys().then(function(keys) {
    console.log(keys);
}).catch(function(err) {
    console.log(err);
});

// 使用 removeItem() 方法删除指定键名的键值对
localforage.removeItem('myKey').then(function() {
    console.log('Item has been removed');
}).catch(function(err) {
    console.log(err);
});

// 使用 clear() 方法删除所有已存储的键值对
localforage.clear().then(function() {
    console.log('Database has been cleared');
}).catch(function(err) {
    console.log(err);
});

3.localforage 还提供了一些高级配置选项，比如：

• driver: 存储数据所使用的驱动（默认为 IndexedDB）
• name: 数据库的名称（默认为 localforage）
• version: 数据库的版本号（默认为 1.0）
• storeName: 存储数据的对象存储名称（默认为 keyvaluepairs）

可以通过 config() 方法来设置这些选项。例如，以下代码将使用 WebSQL 存储数据，并将数据库的名称设置为 myApp：

localforage.config({
  driver: localforage.WEBSQL, // 使用 WebSQL 驱动
  name: 'myApp' // 数据库名称为 myApp
});