读写值 API
在设备上持久化存储字符串值,并将其读回到您 Web 应用的 JavaScript 中。
读写值 API 将任意字符串持久化存储在设备上(应用的私有存储中),并可将其读回到您的 JavaScript 中。只要应用未被卸载,这些值就能在应用重启和缓存清理后保留。
写入值:
writevalue:// 之后的所有内容都会作为一个字符串原样存储。您可以自行设计格式(query-string、JSON、CSV——只要适合您的 Web 应用即可):
<a href="writevalue://darkmode=on;user=42">保存</a>
读取值:
当触发 readvalue:// 时,应用会将存储的字符串作为 window.storedValues 注入回 WebView,供您的 JavaScript 读取:
<a href="readvalue://" onclick="setTimeout(showSettings, 200)">加载</a>
<script>
function showSettings() {
console.log(window.storedValues || "尚无设置");
}
</script>
典型使用场景:
- 离线记住用户的主题、语言或引导状态。
- 在无法依赖 Cookie 时缓存会话令牌。
- 在不进行后端往返的情况下持久化少量本地偏好设置。
注意:值按应用安装和设备存储——不会跨设备同步。请保持值的体积较小;此 API 用于存储设置,而非大数据块。