目录

如何获取LocalStorage实例对象

问题现象

在组件中创建LocalStorage实例的情况下,其他组件如何获取该组件的LocalStorage实例?

效果预览

背景知识

解决方案

常见FAQ

Q:LocalStorage实例在文件根目录进行初始化,其生命周期会跟随页面的生命周期吗?

A:LocalStorage对象的生命周期由应用程序决定,当应用释放最后一个指向LocalStorage的引用时才会被JS Engine垃圾回收。

Q:子组件可以通过LocalStorage.getShared()方法获取LocalStorage实例吗?

A:未被@Entry装饰的组件不可被独立分配LocalStorage实例,只能接受父组件通过@Entry传递来的LocalStorage实例,子组件实例自动获得对该LocalStorage实例的访问权限。LocalStorage.getShared只能在父组件才能获取到数据。

Q:在主页面中调用loadContent传递LocalStorage实例,为什么在其他页面中通过LocalStorage.getShared()获取的值是undefined?

A:LocalStorage是页面级存储,getShared()接口仅能获取当前Stage通过windowStage.loadContent传入的LocalStorage实例,否则返回undefined,可以参考LocalStorage使用的限制条件和示例将LocalStorage实例从UIAbility共享到一个或多个页面。

总结

关于子组件如何获取LocalStorage实例,本文一共提供了三种方案。

方案

适用场景

通过export将Storage实例导出

该方案不能做到组件之间双向同步。适用于模块化清晰、单向访问的场景。

使用LocalStorage装饰器@LocalStorageLink

官网文档提供的方法,适用于大多数场景。

通过状态变量传递Storage

通过状态变量传递Storage实例,子组件无法访问全局LocalStorage实例,灵活性被限制,但是子组件只接收父组件的实例,可以避免引起频繁刷新影响性能,也可以防止数据混淆,适用于频繁交互数据的场景。