页面看起来没变:预览、下载与重置对应的代码路径

举报
黑森鱼 发表于 2026/11/15 09:31:45 2026/11/15
【摘要】 页面看起来没变:预览、下载与重置对应的代码路径离线排查清单的页面交互都在 app.js。用户碰到「页面看起来没变」「预览对了但下载空了」「重置后刷新又回来」时,未必是存储损坏,而往往是预览、下载、重置和清除走了不同路径。本次在 Node.js v24.22.1 中加载真实 app.js,用内存 localStorage 和最小 DOM 模拟完成 21 项实验,结论均来自实测。这不是图形界面浏...

页面看起来没变:预览、下载与重置对应的代码路径

离线排查清单的页面交互都在 app.js。用户碰到「页面看起来没变」「预览对了但下载空了」「重置后刷新又回来」时,未必是存储损坏,而往往是预览、下载、重置和清除走了不同路径。本次在 Node.js v24.22.1 中加载真实 app.js,用内存 localStorage 和最小 DOM 模拟完成 21 项实验,结论均来自实测。这不是图形界面浏览器验收。

一、预览只是当时的快照,下载会按当前状态重算

点「预览 Markdown」时,程序用当时的内存状态调用 exportMarkdown,把结果写进预览区,并提示「已生成预览。确认无敏感信息后再下载。」这一步不写 localStorage,也不触发下载。点「下载 Markdown」时,会再调用一次同一函数,用算出的文本更新预览,并创建类型为 text/markdown;charset=utf-8 的 Blob 保存到本机,文件名固定为 startup-checklist-record.md,内容无 BOM。同一次点击里,预览和文件内容一致。

但预览区不会在之后的勾选、改步骤或改备注时自动刷新。实验先勾选「整页空白」,将第一步标为已检查并填写备注后预览,正文长度为 758 个字符。随后取消该症状、清空备注,预览区仍是那 758 个字符,看起来还是「对的」。再点下载,程序并不读取预览 DOM,而是按当前状态重新导出:正文变成 339 个字符,出现「(未选择)」和「(请先选择症状)」,原来的备注也不在文件里。这就是「预览对了但下载空了」对应的路径。这里的「空」也不是 0 字节:从未勾选就下载,仍有 303 个字符、按 UTF-8 计 711 字节的模板。隐藏预览只清空预览区,不改存储,也不改提示。

function onExportDownload() {
  var md = Core.exportMarkdown(state, new Date().toISOString());
  showPreview(md);
  downloadText("startup-checklist-record.md", md);
}

二、重置会写入空进度,清除才会删掉键

两个按钮都会先弹出确认。取消确认时,页面、存储和预览都不变,这是「看起来没变」的一条正常路径。确认之后,当前勾选和预览都会被清空,但写入动作不同。

「重置当前进度」把内存换成 emptyState(),再调用 persist(),把带 updatedAt 的空进度写回键名 dev-startup-checklist-v1。emptyState() 对空输入会提前返回,因此实际写入的是 symptoms: {}、steps: {},而不是事先填好的未选和「待验证」。刷新后勾选仍为空,启动提示却变成「已恢复本机上次进度。」恢复的是这份刚写入的空进度,不是重置前的勾选。

「清除本机保存」调用 removeItem,不会再写回空对象。刷新后该键不存在,提示回到「勾选后会自动保存在本机浏览器。」

若重置时 setItem 抛错,persist 会先提示无法写入,随即被「已重置。」覆盖。页面已经空了,存储里仍是旧勾选和旧备注,刷新后旧进度回来。清除时若 removeItem 抛错,异常会被直接忽略,提示仍是「已清除本机进度。」,刷新同样带回旧数据。这两种写入失败,才是「重置后刷新又回来」的代码路径。

只取消症状并不是重置。实验把「整页空白」的第一步标为已检查并写下备注,再取消该症状:步骤区回到「请先勾选…」,进度为 0 项,但存储里 blank-1 仍是 checked,备注还在。重新勾选后,原来的状态和备注会再次出现。

三、提示文案看的是另一条状态

启动提示只看 state.updatedAt 是否存在。有时间戳就显示「已恢复本机上次进度。」,否则显示「勾选后会自动保存在本机浏览器。」若存储里仍有勾选、却没有 updatedAt,复选框会恢复,提示却像首次打开。写入成功后的提示是「进度已保存在本机浏览器(可清除)。」;写入失败会说明无法写入,当前会话仍可继续勾选,但刷新会丢掉未写入的改动。

中部「如何区分」提示也容易让人觉得页面没变。未选任何症状时它显示;只选一项,或只组合「整页空白 + 资源加载慢」「工作区目录为空 + 资源加载慢」时隐藏;一旦同时勾选「整页空白」和「工作区目录为空」(含三项全选),这块提示会再次出现。这不是进度丢失,只是按选择组合切换可见性。

输入处理会把备注截到 2000 个码元再写入存储,但不会把截断结果写回输入框。模拟中输入 2005 个「测」字后,存储长度为 2000,输入框仍为 2005。真实页面另有 maxlength="2000" 作为输入侧限制。

把现象对应回路径,可以少误判一次:预览只是当时的快照;下载始终按当前状态重算;重置留下带时间戳的空进度;清除才删除键;取消确认或写入失败时,看起来已变或已清空的页面,刷新后仍可能回到旧数据。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。