声明:我是 ToolKnit 的开发者,文末提到的工具是我做的。本文由 AI 辅助起草,代码和结论已人工核对。
前端偶尔还是得和 XML 打交道:SVG、RSS/Atom、sitemap、Android 资源文件,还有一些老接口返回的 SOAP。最烦的情况是一个几千行的 XML 只报一句 mismatched tag,得自己一行一行找。
用 DOMParser 做校验
浏览器自带的 DOMParser 就能做语法校验。解析失败时,它不会抛异常,而是返回一个包含 <parsererror> 节点的文档:
function validateXml(text) {
const doc = new DOMParser().parseFromString(text, "application/xml");
const err = doc.querySelector("parsererror");
if (!err) return { ok: true, doc };
const msg = err.textContent || "";
// Chrome / Firefox 的错误文本里通常带有行号、列号
const m = msg.match(/line\s*(?:number\s*)?(\d+).*?column\s*(\d+)/i);
return { ok: false, message: msg.trim(), line: m && +m[1], column: m && +m[2] };
}
需要注意:
- 各浏览器的错误文本格式不一样,正则要写得宽松一些,匹配失败时退回显示原文。
- MIME 要用
application/xml。用text/html会被 HTML 解析器“宽容”掉,很多错误根本报不出来。 - 拿到行列号以后,在编辑器里高亮那一行,比弹一个错误框有用得多。
格式化的几个坑
xml:space="preserve"和混合内容。<p>Hello <b>world</b></p>这类文本和标签混在一起的节点,盲目换行缩进会改变文本内容。- CDATA 和注释要原样保留,不要重新缩进里面的内容。
- 声明与处理指令(
<?xml ...?>、<?xml-stylesheet ...?>)要放在最前面,不能被重排。 - 压缩(minify)时只删除标签之间的纯空白,不要动文本节点里的空格。
缩进一般给用户三种选择:2 空格、4 空格、Tab。不同团队习惯不同,不要替用户定死。
为什么坚持本地处理
需要格式化的 XML 经常是接口返回的真实数据、内部配置或客户的 sitemap。把这些内容粘到一个会上传服务器的在线工具里,风险不小。上面这套 DOMParser 加字符串处理的方案完全可以在浏览器里完成,没有必要上传。
现成工具
我把上面的思路做成了 XML 在线格式化与语法校验:
- 格式化、美化、单行压缩,缩进可选 2 空格 / 4 空格 / Tab
- 精确定位未闭合标签所在的行号和列号
- 支持导入、导出 .xml / .svg / .rss
- 全程在浏览器本地运行,不上传
它属于这次一起上线的 7 个本地小工具,其余几个(PNG 转多尺寸 ICO、二维码本地解码、ZIP 打包等)可以在 ToolKnit 首页 找到。你平时处理 XML 还踩过哪些坑,欢迎在评论区补充。