发布 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

自由画布 自由画布

百度文库和百度网盘联合开发的AI创作工具类智能体

自由画布 73 查看详情 自由画布

在此过程中,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/457051.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月8日 01:53:23
下一篇 2025年11月8日 01:55:33

相关推荐

  • xcode 怎么创建 c++ 项目

    在 xc++ode 中创建 c++ 项目可以通过以下步骤实现:1. 打开 xcode,点击 “create a new xcode project”。2. 选择 “macos” 平台和 “command line tool” 模…

    2025年12月18日
    000
  • c++ 作用域解析运算符怎么用

    在 c++++ 中,作用域解析运算符 (::) 用于明确指定标识符的作用域。1) 解决命名冲突,如访问全局变量 (::count)。2) 访问命名空间成员 (math::calculatearea)。3) 访问类的静态成员 (myclass::staticvar)。合理使用该运算符可以提高代码的清晰…

    2025年12月18日
    000
  • clion 怎么创建 c++ 项目

    在 c++lion 中创建 c++ 项目可以通过以下步骤实现:1. 启动 clion 并点击 “create new project”。2. 选择 “c++ executable” 作为项目类型。3. 设置项目位置,建议使用专门文件夹。4. 选择 c+…

    2025年12月18日
    000
  • Gulc:从头开始建造的C库

    本文开启了一个系列,介绍我正在开发的C99库:Gulc(Generic Utility Library的缩写)。该库主要用于学习和娱乐目的,旨在提供C标准库中安全内存管理和实用功能(如向量和无序映射),以简化C语言编程。未来将持续添加更多功能。 目前,该库包含一个简单的验证系统(类似于断言,但在发行…

    2025年12月18日
    000
  • vs 怎么管理多个 c++ 项目

    在 visual studio 中管理多个 c++++ 项目可以通过创建解决方案和使用 cmake 来实现。1. 创建新解决方案并添加 c++ 项目。2. 使用 cmake 管理项目依赖和配置。通过这些方法,可以高效地组织和维护多个 c++ 项目,提升开发效率。 引言 搞 C++ 开发的朋友们,管理…

    2025年12月18日
    000
  • c++ 内联函数怎么使用

    c++++ 内联函数通过将函数体嵌入调用处来提升性能。1) 使用 inline 关键字定义内联函数,如 inline int add(int a, int b) { return a + b; }。2) 编译器决定是否内联,基于函数大小和复杂度。3) 适用于小型、频繁调用的函数,避免过度使用以防代码…

    2025年12月18日
    000
  • c语言函数的基本要求有和定义

    C语言函数本质上是代码模块化,封装了代码段并提供了一个名称以便重复使用。函数定义包括参数列表(值或地址传递)、返回值类型和作用域,局部变量只在函数内部有效。函数指针和回调函数允许将函数作为参数传递。性能优化建议权衡函数粒度和选择合适的参数传递方式。最佳实践强调代码可读性和可维护性,包括清晰的注释、规…

    2025年12月18日
    000
  • Meson:使用无中造成的GIT项目作为依赖

    meson项目依赖处理:巧妙解决无meson.build文件的git项目依赖问题 许多优秀的Git项目缺乏Meson.build文件,这给使用Meson构建系统的开发者带来了挑战。本文将介绍一种方法,通过创建补丁文件来解决这个问题,并成功将一个没有Meson.build文件的Git项目作为子项目添加…

    2025年12月18日
    000
  • 网络服务安装

    推介会: 本 SAE(业务学习情况)项目旨在开发一个基于客户端-服务器架构的实时“CAT”网络讨论应用程序。该应用允许多个客户端连接到中央服务器并进行实时通信。下图概述了套接字功能: 资源配置: 编程语言:C 语言版本控制:使用分布式 Github 进行代码共享开发环境:Visual Studio …

    2025年12月18日
    000
  • c语言函数名定义

    C语言函数名定义包括:返回值类型、函数名、参数列表和函数体。函数名应清晰、简洁、统一风格,避免与关键字冲突。函数名具有作用域,可在声明后使用。函数指针允许将函数作为参数传递或赋值。常见错误包括命名冲突、参数类型不匹配和未声明的函数。性能优化重点在函数设计和实现上,而清晰、易读的代码至关重要。 C语言…

    2025年12月18日
    000
  • c语言函数的嵌套调用和递归调用分别是啥意思

    C语言函数调用可分为嵌套调用和递归调用。嵌套调用是指函数内调用其他函数,层层嵌套。递归调用是指函数自身调用自身,可用于处理自相似结构问题。关键区别在于嵌套调用中的函数依次调用,相互作用域独立,而递归调用中函数不断自调用,需注意递归基和栈溢出问题。选择哪种调用方式取决于问题的具体需求和性能要求。 C语…

    2025年12月18日
    000
  • 使用gdb快速调试

    本文介绍使用GDB命令行调试程序的常用技巧。以下步骤演示如何在命令行快速调试代码: 编译代码: 使用 gcc myprogram.c -g -o myprogram 命令编译您的C程序,-g 选项生成调试信息。 启动GDB: 使用 gdb -tui myprogram 命令启动GDB,-tui 选项…

    2025年12月18日
    000
  • c语言函数定义格式有哪些

    C语言函数定义的关键元素包括:返回类型(定义函数返回的值)、函数名(遵循命名规范,决定作用域)、参数列表(定义函数接受的参数类型、数量和顺序)和函数体(实现函数的逻辑)。明确这些元素的意义和微妙关系至关重要,能帮助开发者避免“坑”,编写更高效、更优雅的代码。 C语言函数定义:那些你可能不知道的细节 …

    2025年12月18日
    000
  • CSS Grid 布局在 IE 中不兼容的原因及解决方案

    IE 不兼容 CSS Grid 布局的原因是它不支持 CSS Grid 规范。解决方案包括:1. 使用 polyfills 模拟现代浏览器功能;2. 切换到支持 CSS Grid 布局的浏览器;3. 使用替代布局技术(如 Flexbox)。 CSS Grid 布局在 IE 中不兼容的原因 CSS G…

    2025年12月18日
    000
  • 探索文件拆分和合并:管理大文件的革命性工具

    您是否曾在传输或存储大量文件时遇到困难?了解 File Splitter & Merger,这是一个开源项目,旨在以优雅和高效的方式简化这一挑战。 这个项目是做什么的? 文件分割和合并由两个工具组成: 文件分割器 — 将大文件分成更小的块。 文件合并 — 将这些块重新组合成原始文件 为什么有…

    2025年12月18日
    000
  • NFetch

    大家好。 我想与你分享我的新项目。最近我了解了 neofetch 项目归档,并决定尝试用 c 语言编写我的模拟。 现在基本功能已经实现,使用flags进行数据输出等 您可以在链接中找到该项目的源代码:https://github.com/nighty3098/nfetch 安装: git clone…

    2025年12月18日
    000
  • 获取下一行学习如何处理文件描述符和系统 I/O 的项目

    在 c 编程领域,有效管理输入、输出和内存是基础。为了帮助您掌握这些关键概念,您将在 get_next_line 项目中编写一个使用文件描述符逐行读取文件的函数。每次调用该函数都会从文件中读取下一行,从而允许您一次一行处理整个文件内容。 了解系统中的文件描述符和 i/o 什么是文件描述符? 文件描述…

    2025年12月18日
    000
  • 使用免费 NET DIO + Randstad 的后端训练营

    免费的 bootcamp coding the future randstad – backend with .net 对于任何想要专注于 c# 编程语言和 microsoft 开发生态系统的人来说都是一个绝佳的机会。 凭借超过 8,000 个奖学金,参与者将有机会学习 .net 基础知识,成为能够…

    2025年12月18日 好文分享
    000
  • C++ 中如何正确声明和使用友元类

    友元类是一种可访问其他类私有成员的特殊类。声明友元类时使用 friend 关键字,如:friend class friendclass; 在友元类中,可通过作用域解析运算符 (::) 访问友元类的私有成员:friendclass::accessprivatemember(outer); 实战案例:在…

    2025年12月18日
    000
  • C++ 函数的类方法是如何声明和实现的?

    c++++中类方法声明是在类定义中使用访问控制修饰符声明的,实现则在类定义之外,使用类名作为作用域解析运算符。例如,public类方法可在对象上调用,protected和private方法受保护或私有访问限制。 C++ 函数的类方法 声明 类方法是类的一部分,可以在对象上调用。它们在类定义中使用 p…

    2025年12月18日
    000

发表回复

登录后才能评论
关注微信