用途:这是前端检查清单中的一条规则,用于审查脚本、客户端组件、打包产物或运行时行为中与“安全使用 Web Storage API”相关的实现。它要求同时检查源码和浏览器执行路径。
主要能力与要点:localStorage 与 sessionStorage 每个源有 5–10 MB 配额,任何写入都可能抛出 QuotaExceededError;部分浏览器的隐私模式会完全禁用存储并在所有写入时抛错,应用若不处理这些错误会静默崩溃,导致用户无法使用。规则给出的快速参考包括:始终用 try/catch 包裹 localStorage 访问;用 JSON.stringify 序列化对象,并在读取时用 JSON.parse 校验;绝不将敏感数据(令牌、密码)存入 localStorage,应使用 httpOnly cookie;对不应持久化的按标签页数据使用 sessionStorage。
使用方式:该规则提供 Check、Fix、Explain、Code Review 四类操作。Check 用于找出文件中所有 localStorage 和 sessionStorage 访问,检查缺失的 try/catch、未处理的 JSON 解析以及敏感数据存储。Fix 用于为所有 Web Storage 操作补充 try/catch 错误处理,并确保对象值被正确序列化与反序列化。Explain 用于解释 Web Storage API、其限制、何时使用 localStorage 还是 sessionStorage,以及什么数据绝不应存放其中。Code Review 用于审查相关脚本、客户端组件与浏览器执行路径,指出违反规则的具体导入、事件处理器、运行时副作用或阻塞操作,并说明应在浏览器中如何验证改动。完整实现细节、代码示例和框架相关指引见 references/rule.md;规则页为 https://frontendchecklist.io/rules/javascript/web-storage。
限制:资料未提供具体框架示例、完整代码与价格等信息。