Read/Write Value API
Persist small strings on the device from JavaScript and read them back — for theme, language, session tokens, or onboarding state.
读/写值 API 通过应用的私有存储将任意字符串持久存储在设备上,并将其读取回您的 JavaScript。值在应用重启和缓存清除后仍然存在 — 除非操作系统清除了应用数据。
写入值:
writevalue:// 之后的所有内容都会被原样存储为一个字符串。您可以设计自己的格式(查询字符串、JSON、CSV — 只要适合您的 Web 应用):
<a href="writevalue://darkmode=on;user=42">Save</a>
读取值:
触发 readvalue:// 时,应用会将存储的字符串注入回 WebView,以便您的 JavaScript 能够读取:
<a href="readvalue://" onclick="setTimeout(showSettings, 200)">Load</a>
<script>
function showSettings() {
console.log(window.appSettings || "no settings yet");
}
</script>
典型用例:
- 在离线状态下记住用户的主题、语言或引导状态。
- 当无法依赖 cookie 时缓存会话令牌。
- 无需后端往返即可持久保存小型本地首选项。
说明: 值按应用安装和设备存储 — 它们不会在设备间同步。请保持值较小;此 API 面向设置存储,而非二进制大对象存储。