#Uniapp：数据缓存uni.setStorage、uni.setStorageSync、uni.getStorage、uni.getStorageSync、uni.getStorageInfo.._uni.getstorageinfosync

uni-数据缓存官网

uni.setStorage(OBJECT)

将数据存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个异步接口。

OBJECT 参数说明

示例

uni.setStorage({
	key: 'storage_key',
	data: 'hello',
	success: function () {
		console.log('success');
	}
});
1
2
3
4
5
6
7

复制代码

注意

• uni-、uni_、dcloud-、dcloud_为前缀的key，为系统保留关键前缀。如uni_deviceId、uni_id_token，请开发者为key命名时避开这些前缀。

uni.setStorageSync(KEY,DATA)

将 data 存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个同步接口。

参数说明

try {
	uni.setStorageSync('storage_key', 'hello');
} catch (e) {
	// error
}
1
2
3
4
5

uni.getStorage(OBJECT)

从本地缓存中异步获取指定 key 对应的内容。

OBJECT 参数说明

success 返回参数说明

示例

uni.getStorage({
	key: 'storage_key',
	success: function (res) {
		console.log(res.data);
	}
});
1
2
3
4
5
6

uni.getStorageSync(KEY)

从本地缓存中同步获取指定 key 对应的内容。

参数说明

示例

try {
	const value = uni.getStorageSync('storage_key');
	if (value) {
		console.log(value);
	}
} catch (e) {
	// error
}
1
2
3
4
5
6
7
8

uni.getStorageInfo(OBJECT)

异步获取当前 storage 的相关信息。

平台差异说明

OBJECT 参数说明

success 返回参数说明

示例

uni.getStorageInfo({
	success: function (res) {
		console.log(res.keys);
		console.log(res.currentSize);
		console.log(res.limitSize);
	}
});
1
2
3
4
5
6
7

复制代码

#uni.getStorageInfoSync()

同步获取当前 storage 的相关信息。

平台差异说明

示例

try {
	const res = uni.getStorageInfoSync();
	console.log(res.keys);
	console.log(res.currentSize);
	console.log(res.limitSize);
} catch (e) {
	// error
}
1
2
3
4
5
6
7
8

复制代码

#uni.removeStorage(OBJECT)

从本地缓存中异步移除指定 key。

OBJECT 参数说明

示例

uni.removeStorage({
	key: 'storage_key',
	success: function (res) {
		console.log('success');
	}
});
1
2
3
4
5
6

复制代码

#uni.removeStorageSync(KEY)

从本地缓存中同步移除指定 key。

参数说明

示例

try {
	uni.removeStorageSync('storage_key');
} catch (e) {
	// error
}
1
2
3
4
5

复制代码

#uni.clearStorage()

清理本地数据缓存。

示例

uni.clearStorage();
1

复制代码

#uni.clearStorageSync()

同步清理本地数据缓存。

示例

try {
	uni.clearStorageSync();
} catch (e) {
	// error
}
1
2
3
4
5

复制代码

注意

uni-app的Storage在不同端的实现不同：

• H5端为localStorage，浏览器限制5M大小，是缓存概念，可能会被清理
• App端为原生的plus.storage，无大小限制，不是缓存，是持久化的
• 各个小程序端为其自带的storage api，数据存储生命周期跟小程序本身一致，即除用户主动删除或超过一定时间被自动清理，否则数据都一直可用。
• 微信小程序单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
• 支付宝小程序单条数据转换成字符串后，字符串长度最大200*1024。同一个支付宝用户，同一个小程序缓存总上限为10MB。
• 百度小程序策略详见、抖音小程序策略详见
• 非App平台清空Storage会导致uni.getSystemInfo获取到的deviceId改变

除此之外，其他数据存储方案：

• H5端还支持websql、indexedDB、sessionStorage
• App端还支持SQLite、IO文件等本地存储方案。

从HBuilderX2.6.6+起，App-Android平台对本地storage数据存储进行了性能优化，老用户升级注意事项，详见：https://ask.dcloud.net.cn/article/37071。新用户无需关心。