发布 f `@xmldom/xmldom`

语境

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 是警告、错误或 fatalerrorxmldom 已经为两个最常见的用例提供了实现:onerrorstopparsing 也会针对所有错误级别问题抛出 parseerroronwarningstopparsing 也会针对所有错误级别问题抛出 parseerror

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

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

comparedocumentposition,扩展 html 实体,null 而不是 undefined,…

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

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

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

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

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

coctype内部子集

最近,@shunkica 投入了大量的时间来解决以前处理 !doctype 内部子集部分时出现的大量问题。

它现在被保留为文档文档类型的internalsubset属性的一部分,并且现在可以正确检测到许多错误的文档类型声明并报告为 fatalerror。

同时感谢@kboshold 在该领域的最新错误修复。

在此过程中,我们创建了一个包含相关语法正则表达式的新模块,正确性检查基于这些模块,并且测试正确地覆盖了它们。

xmldom 的目标不是成为验证解析器,但这是支持那些带有更复杂 dtd 的文档的重要一步。

还有更多

到目前为止,开发是使用 node v10 完成的,因为这也是 xmldom 当前支持的最低版本。作为即将推出的版本工作的一部分,我决定切换到 v18 进行开发,因为越来越多的 devdependency 也使这成为最低要求。从该版本开始,这将是目前新的最低运行时版本。

我发起了一项公众投票/讨论,询问人们他们需要支持哪个版本的 node 或其他运行时。
如果没有反馈表明有什么不同,下一个重大版本很可能会放弃对某些旧 node 版本的支持。

一路走来,很多 api 都收到了具有正确类型的 jsdoc 注释。

谢谢

感谢您花时间阅读所有这些。

这些变化相当大,我很高兴能够交付这些变化。

我希望你和我一样兴奋:)

如果您需要更多详细信息,可以查看非常详细的变更日志,或者前往存储库并加入或开始讨论或提出问题。

以上就是发布 f `@xmldom/xmldom`的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1490970.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月19日 13:35:24
下一篇 2025年12月19日 13:35:31

相关推荐

  • 为什么 `window.num` 返回 `undefined` 而 `num` 抛出 `ReferenceError`?

    js 中的 window 对象的特殊性 在 js 中,window 对象代表当前浏览器的窗口。它提供了全局作用域的访问权,允许开发者轻松访问全局变量和方法。然而,window 对象还有一个鲜为人知且令人困惑的特性:它可以访问不存在的属性。 为什么可以直接通过 window 对象访问不存在的属性? 让…

    2025年12月19日
    000
  • Nuxt 中的请求上下文

    介绍 nuxt 最近引入了一项实验性功能:使用 nodejs asynclocalstorage 的异步上下文支持。 此增强功能有望简化开发人员跨嵌套异步函数管理上下文的方式,但还有更多! 需要注意的是,“实验性”标签是由于跨平台支持有限;但是,在使用 nodejs 时它很稳定,使其成为在该环境中工…

    2025年12月19日
    000
  • npmrc——Node 的小文件

    正如标题所示,它是我们代码库中的小文件。让我们探索一下。 为什么需要它? .npmrc 文件是您为 npm 配置各种设置的位置,例如应从何处安装包、身份验证详细信息或您希望 npm 在运行命令时遵循的自定义行为。把它想象成你的浏览器设置:就像你配置浏览器的行为一样,.npmrc 配置 npm 的行为…

    2025年12月19日
    000
  • 修复 JS 项目中的包安全漏洞的步骤

    当您安装的软件包或其依赖项中检测到安全漏洞时,github 会定期向您发送警报。我曾经尝试让 dependentabot 为我修复它们。然而,有一半的时间我无法合并为我生成的 pr。结果,违规行为就被赤裸裸地处理了,这可不好。就我而言,我使用 pnpm,我想它与 npm 相同。 我今天看到了 Nir…

    2025年12月19日 好文分享
    000
  • 创建运行时

    你好,我的名字是 lucas wasilewski,就像我在 github 上添加项目描述一样,自从我开始使用 nodejs 编程(2021 年初)以来,我一直想写一些看起来像工具的东西,仅此而已在我观看了有关该项目的纪录片后,我对这个项目的兴趣有所增加,我惊讶于开源世界如何能够经历数次曲折,并且在…

    2025年12月19日
    000
  • JavaScript 代码道德:编写干净、道德的代码

    在当今快节奏的开发世界中,快速交付解决方案至关重要。然而,在代码质量上偷工减料通常会导致错误、安全漏洞和不可维护的代码。代码道德在生成功能性代码和可维护、高效且安全的代码方面发挥着关键作用。让我们通过示例探讨 JavaScript 开发中的关键道德原则以及它们如何提高代码质量。 清晰胜过聪明道德原则…

    2025年12月19日
    000
  • 原生JS树形插件有哪些推荐?

    原生JS树形插件推荐 在编写原生JavaScript应用程序时,有时我们需要创建树形结构来组织和显示复杂的数据。为此,有许多出色的树形插件可供选择。 jstree jstree是一个功能强大的树形插件,满足了您提出的所有要求: 支持搜索自定义图标显示成员头像 它还提供了大量的附加功能,例如拖放、节点…

    2025年12月19日
    000
  • JavaScript 函数参数与实参:传递的是值还是引用?

    函数参数与实参之间的关系:解开 javascript 中的奥秘 最近,关于 javascript 中函数参数和实参之间的关系的问题引发了许多讨论。为了深入了解这一概念,让我们考虑一个示例: const a = [1, 2, 3];function test(x) { console.log(x ==…

    2025年12月19日
    000
  • 《瑞克和莫蒂》和《Clossures》:这些东西有什么共同点?

    那么,你好吗?我希望如此! 我试图在 leetcode 中解决一些编程问题,在其中一个挑战中,我遇到了一个很多人都难以理解的编程中非常重要的概念。 所以我决定在这里写下尝试以最好的方式解释闭包如何在javascript中工作。跟我来吧! 问题 我正在研究一个名为“counter”的挑战,其中我需要创…

    2025年12月19日
    000
  • MaweJS:花盆编辑器

    嗨! 即将宣布一个针对作家的编辑器项目。它是我 15 年写作和编码编辑器的一代之一。 https://github.com/mkoskim/mawejs 正在为您的故事寻找编辑吗? Notepad、Word 和 Googledocs 太少,而 Scrivener、Manuskript 和 yWrit…

    2025年12月19日
    000
  • 流畅的视频滑动 Web 应用程序 — 开源

    刚刚开源了一个项目:一个视频滑动源,类似于您在社交媒体应用程序上看到的内容,但它完全基于网络,允许它在任何网络域上提供服务。结果非常顺利,尤其是在手机上。您可以在 www.swipetor.com 查看 github 链接和演示 虽然社交媒体视频刷屏在各大平台上变得越来越流行,但通常很难获得量身定制…

    好文分享 2025年12月19日
    000
  • JavaScript 主题

    以下是每个 JavaScript 主题的简要说明: 变量和数据类型:变量存储数据值,JavaScript 支持多种数据类型,如字符串、数字、布尔值、数组和对象。 var、let 和 const 用于声明变量。 函数(箭头函数、函数表达式):函数是设计用于执行特定任务的代码块。箭头函数 (=>)…

    2025年12月19日
    000
  • 初学者使用 JavaScript 时常犯的错误

    javascript 是一种超级有趣的语言,但让我们面对现实吧,当您刚开始使用时,它可能会有点棘手。作为一个仍在摸索中的人,我也犯过不少错误!因此,我想分享初学者在使用 javascript 时经常犯的五个常见错误 – 希望这可以帮助您避免它们。 1. 忘记声明变量 您在 javascr…

    2025年12月19日
    000
  • 如何比较(差异)两个对象

    javascript 中的对象比较 javascript 中的对象比较看似复杂。虽然比较数字和字符串等原始值很简单,但比较对象可能会导致意想不到的结果。让我们探索不同的对象比较方法,并构建一个强大的解决方案来检测对象之间的变化。 直接比较的陷阱 当开发人员第一次遇到 javascript 中的对象比…

    2025年12月19日
    000
  • js如何看变量

    查看 JavaScript 中变量值的便捷方法包括:1. 使用 console.log() 方法将变量值打印到控制台中;2. 使用 alert() 方法弹出带有变量值的模态窗口;3. 使用 debugger 关键字暂停代码执行并打开调试器;4. 使用浏览器的 DOM 检查器查看网页上运行的 Java…

    2025年12月19日
    000
  • js如何控制csd

    JavaScript 可通过加载、解析、操纵、导出 CSD 文件或使用库来控制 CSD。 如何用 JavaScript 控制 CSD CSD(Cutting Sheet Data)是一种用于描述裁切、冲压和弯曲钣金零件的 XML 格式。JavaScript 可以通过以下方法来控制 CSD: 1. 加…

    2025年12月19日
    000
  • Hacktoberfest 对 ZTM-Quest 的贡献

    介绍 对于我对 hacktoberfest 的第三次贡献,我发现了一个我从未想过会贡献给我的存储库,这个存储库特别以 javascript 中的 2d 游戏开发为中心,因为我已经掌握了 javascript 的工作知识,潜水和探索代码库不会成为问题,因此我选择了此存储库中的问题之一来做出贡献。 zt…

    2025年12月19日
    000
  • JS如何引用JS方法

    在 JavaScript 中引用 JS 方法并直接调用的方法有:使用函数名直接调用;使用对象或类的方法引用符引用;使用回调函数;使用事件侦听器;使用 bind() 方法绑定对象。 如何在 JS 中引用 JS 方法 直接调用: 如果方法在当前作用域中可用,可以使用函数名直接调用它。例如: functi…

    2025年12月19日
    000
  • js字符串如何查重

    JS 字符串查重方法包括:使用 Set 数据结构去除重复项,计算 Set 长度。使用 Map 数据结构存储键值对,检查是否存在重复键。使用正则表达式查找特定模式的字符串,计算匹配长度。使用外部库(如 lodash.uniq())去除重复项。 JS 字符串查重 如何查重? 查重 JavaScript …

    2025年12月19日
    000
  • 页面如何引用js变量

    有五种方法可以在页面中引用 JavaScript 变量:1. 使用全局变量;2. 使用函数作用域变量;3. 使用块级作用域变量;4. 通过 HTML 元素引用;5. 通过 window 对象引用。 页面如何引用 JS 变量 在 Web 开发中,引用 JavaScript 变量是一个常见的任务。有几种…

    2025年12月19日
    000

发表回复

登录后才能评论
关注微信