Read/Write Value API
Persist small strings on the device from JavaScript and read them back — for theme, language, session tokens, or onboarding state.
L'API Read/Write Value stocke de manière persistante une chaîne de caractères arbitraire sur l'appareil (via le stockage privé de l'application) et la relit dans votre JavaScript. Les valeurs persistent aux redémarrages de l'application et aux vidages du cache — sauf si le système d'exploitation efface les données de l'application.
Écrire une valeur :
Tout ce qui suit writevalue:// est stocké tel quel sous forme d'une seule chaîne. Concevez votre propre format (chaîne de requête, JSON, CSV — ce qui convient à votre application web) :
<a href="writevalue://darkmode=on;user=42">Save</a>
Lire une valeur :
Lorsque readvalue:// est déclenché, l'application injecte la chaîne stockée dans la WebView afin que votre JavaScript puisse la lire :
<a href="readvalue://" onclick="setTimeout(showSettings, 200)">Load</a>
<script>
function showSettings() {
console.log(window.appSettings || "no settings yet");
}
</script>
Cas d'usage typiques :
- Mémoriser le thème, la langue ou l'état d'onboarding d'un utilisateur hors ligne.
- Mettre en cache un jeton de session lorsque vous ne pouvez pas vous appuyer sur les cookies.
- Persister une petite préférence locale sans aller-retour avec le backend.
Remarques : Les valeurs sont spécifiques à chaque installation d'application et à chaque appareil — elles ne sont pas synchronisées entre appareils. Conservez des valeurs de petite taille ; cette API est destinée aux paramètres, pas au stockage de blobs.