发布 f `@xmldom/xmldom`-js教程-PHP中文网

语境

xmldom 是一个 javascript ponyfill，用于向其他运行时提供现代浏览器中存在的以下 api：将 xml 字符串转换为 dom 树 new domparser().parsefromstring(xml, mimetype) => document 创建、访问和修改 dom 树 new domimplementation().createdocument(...) => document 将 dom 树序列化回 xml 字符串 new xmlserializer().serializetostring(node) => string

来源：xmldom 自述文件

历史

自从我在 2020 年 6 月开始为分叉的 xmldom 库做出贡献以来，已经发布了 40 个版本。

这是一个非常有趣且具有挑战性的项目，并且很可能会在相当长的一段时间内保持这种状态。

据 github 称，自分叉以来已有 50 多人为其做出了贡献。

再次感谢所有贡献者。

这并不包括所有设法从原始无作用域 xmldom 包迁移到有作用域 @xmldom/xmldom 包版本 0.7.0 以获得所有安全修复程序的人。
作为 lts 标签发布的最新版本是 0.7.13。

最后一个具有重大更改的版本是 0.8.0，发布于 2021 年 12 月 22 日，大约 3 年前。
最新发布的版本是0.8.10。

0.9.0 (2024-08-29)

但是我今天要讲的是自 2022 年 10 月以来在 next 标签下发布的所有内容。

我对这些变化感到非常兴奋，因为它们为未来潜在的变化提供了明确的基础。

tldr：与规范更加一致，差异尽可能明确。

1. 强制mimetype交还控制权

使实现变得复杂的一个方面是解析 xml 与 html 的规则不同。
xmldom（在某种程度上）从一开始就“支持”这两种风格。甚至根本不需要传递 mimetype：应用什么规则是根据当前正在解析的 xml 字符串/节点的当前默认命名空间决定的。

这以 0.9.0 结束：从现在开始，domparser.parsefromstring(xml, mimetype) 中的 mimetype 是强制性的，并且是唯一被检查以决定是否应用 xml 或 html 规则的东西。巴斯塔。

该信息会保留在生成的文档（新类型属性）中，因此在序列化它时，会再次应用正确的规则。

这是一个巨大的（并且可能是破坏性的）变化，但我真的很高兴它已经准备好了，因为它使大量相关的错误修复变得可能/更容易实现，并且还降低了 api 和实现的复杂性。

此外，它现在只接受指定的 mime 类型，并在任何其他情况下抛出 typeerror。

严格性和错误处理

我个人对原生浏览器 api 的错误处理感到困惑的是，它总是返回一个 document，如果出现问题，parsererror 节点将是主体的第一个子节点：

发布 f `@xmldom/xmldom`

由于错误处理在 xmldom 中从来没有以这种方式工作，但现有的错误处理非常复杂、混乱且文档记录很差，0.9.0 对其进行了简化，现在对解析过程中发生的任何潜在错误具有（更加）一致的行为：
它会抛出一个 parseerror ?，例如有下列情况之一的：

在以前的版本中，对于某些格式不正确的 xml 字符串，返回的 document 可能没有 documentelement，这很可能会导致后面的代码出现 typeerrors。
几个格式不正确的 xml 字符串现在将正确报告为 fatalerror，现在总是阻止任何进一步的处理。
一些以前未报告为错误或仅报告为警告的事情现在也报告为 fatalerror

仍然有一些情况会被报告为警告（尤其是在解析 html 时）或错误，但不会阻止数据的处理，但是新的错误处理可以很容易地决定代码的严格程度需要使用 xmldom。

可以传递给 domparser 构造函数的（不符合规范的）选项称为 onerror。
它需要一个具有以下签名的函数：

function onerror(level:errorlevel, message:string, context: domhandler):void;

errorlevel 是警告、错误或 fatalerror
xmldom 已经为两个最常见的用例提供了实现：
- onerrorstopparsing 也会针对所有错误级别问题抛出 parseerror
- onwarningstopparsing 也会针对所有错误级别问题抛出 parseerror

建议应用其中一个来在出现任何意外的第一个信号时停止处理 xml：

// prevent parsing of XML that has `error`s
new DOMParser({onError: onErrorStopParsing}).parseFromString(...)
// prevent parsing of XML that has `warning`s
new DOMParser({onError: onWarningStopParsing}).parseFromString(...)

comparedocumentposition，扩展 html 实体，null 而不是 undefined，...

原始 xmldom 存储库的另一个分支通过将 html 实体扩展到完整集（在 0.8.x 中也可用）并移植comparedocumentposition api 的实现，使其重新回到我们的存储库中。谢谢你，欢迎@zorkow

git提交前检查

在代码提交 git 前，通过 git diff 对比修改内容，逐文件审查变更点，检测潜在 BUG、隐含风险与可优化项，输出结构化审查报告。当用户表达提交前检查、提交检查、commit 前检查、pre-commit review、提前审查代码、检查一下改动、看看能不能提交等意图时使用此技能。注意：此技能与「代码评审」不同——代码评审在开发完成后结合需求文档与概要设计进行完整度审查，提交前检查是轻量级的基于 git diff 的代码质量把关。

下载

在此过程中，xmldom 迄今为止返回未定义而不是 null 的几个地方已得到修复，以符合规范。

而且我发现前作者似乎更喜欢在很多地方从列表的末尾开始迭代，属性在多个地方以相反的顺序处理，现在已修复。

removechild api 的实现发生了很大的变化，以符合规范并在应该抛出 domexception 的时候。

并且修复了 3 个相关错误，明确说明了 xmldom 的未来方向：
仅当适当严格的 xml 解析不受其影响时，才会提供对宽松 html 解析规则的支持。
以前（已损坏的）html 中自动自关闭标签的“支持”已经消失了。