XML 存入 localStorage 必须用 encodeURIComponent 编码,读取时 decodeURIComponent 解码;需校验长度防超限、检查格式合法性,并用 DOMParser 解析后验证 parsererror;不推荐字符串拼接构造 XML,大 XML 应改用 IndexedDB。

XML 字符串必须手动转义才能存入 localStorage
localStorage 只接受字符串,而 XML 常含 、>、& 等非法字符,直接调用 setItem('xml', xmlString) 会静默失败或截断数据。
-
浏览器不会报错,但
getItem()可能返回null或不完整字符串 - 推荐统一用
encodeURIComponent()编码后存储,读取时用decodeURIComponent()解码 - 不要用
JSON.stringify()包一层——它不解决 XML 特殊字符问题,反而多套一层引号和转义
IE11 及更早版本对 localStorage 容量限制更严,XML 易超限
多数现代浏览器允许 localStorage 达 5–10MB,但 IE11 实际可用常低于 2.5MB,且对单个 key 的写入有隐式长度限制(约 1.5MB 左右)。
- 大段 XML(如含 base64 图片或长文本节点)极易触发
QuotaExceededError - 存之前建议先检查:
if (xmlString.length > 1000000) { /* 考虑分片或改用 IndexedDB */ } - IE 下可捕获异常:
try { localStorage.setItem('xml', encoded); } catch (e) { if (e.name === 'QuotaExceededError') { /* 处理容量不足 */ } }
解析前必须确保 XML 字符串完整且格式合法
从 localStorage 读出的 XML 字符串可能因编码/截断/意外修改而损坏,直接丢给 DOMParser 会抛 SyntaxError。
- 读取后先做基础校验:
const raw = localStorage.getItem('xml'); const decoded = decodeURIComponent(raw || ''); if (!decoded.trim().startsWith(' - 用
DOMParser解析时务必检查parseFromString返回的文档是否有parsererror元素 - 避免在未验证情况下直接访问
doc.documentElement,防止undefined报错
XML 中的命名空间、CDATA、注释在本地存储中无特殊处理能力
localStorage 是纯字符串容器,不理解 XML 结构。所有语义(如 、xmlns 属性、处理指令)都原样保存,但容易因手动拼接或编辑被破坏。
立即学习“前端免费学习笔记(深入)”;
- 不要用字符串拼接方式“构造” XML——极易漏掉闭合标签或属性引号
- 若需动态生成,优先用
XMLSerializer序列化真实 DOM 文档,而非手写字符串 - 含 CDATA 的内容在
encodeURIComponent后仍可安全 round-trip,但人工编辑 JSON-like 字符串时极可能误删]]>
XML 不是为键值存储设计的格式,localStorage 存 XML 的本质是“把结构化数据降级为字符串”,所有解析、校验、容错都要自己补全。稍大一点的 XML,真该直接切到 IndexedDB。










