首页
/ JSDOM 26.0.0版本发布:Canvas升级与Web标准新特性支持

JSDOM 26.0.0版本发布:Canvas升级与Web标准新特性支持

2025-06-01 10:46:51作者:宣聪麟

JSDOM是一个在Node.js环境中实现Web浏览器DOM标准的库,它允许开发者在服务器端运行和测试需要DOM环境的JavaScript代码。最新发布的26.0.0版本带来了一些重要的更新和改进,特别是在Canvas支持和Web标准新特性方面。

Canvas依赖升级至v3

本次版本最显著的变更是将Canvas的peer dependency从v2升级到了v3。这是一个破坏性变更,意味着使用JSDOM的项目需要相应更新其Canvas依赖。Canvas库提供了Node.js中的Canvas API实现,这一升级将为开发者带来更好的性能和更完整的API支持。

对于现有项目,升级时需要注意检查与Canvas相关的代码是否兼容v3版本。虽然大多数基础API保持不变,但v3版本引入了一些改进和可能的细微行为变化。

新增AbortSignal.any()方法

26.0.0版本添加了对AbortSignal.any()方法的支持。这个方法是现代JavaScript中AbortController API的一部分,它允许开发者组合多个中止信号,创建一个新的信号,当任何一个输入信号被中止时,这个新信号也会被中止。

这在处理多个可能被取消的异步操作时特别有用。例如,当同时发起多个网络请求并需要统一管理它们的取消逻辑时,AbortSignal.any()可以大大简化代码。

表单关联自定义元素初步支持

JSDOM现在提供了对表单关联自定义元素(form-associated custom elements)的初步支持,特别是使它们可标记(labelable)并支持ElementInternalslabels属性。表单关联自定义元素是Web Components技术的一部分,允许自定义元素像原生表单控件一样参与表单提交和验证。

虽然当前版本尚未支持完整的表单关联回调,但这一更新已经为开发者提供了构建更复杂表单组件的基础。ElementInternalslabels属性特别有用,它可以让自定义元素像原生表单控件一样与<label>元素关联。

底层依赖更新与改进

JSDOM 26.0.0版本还更新了多个关键依赖:

  1. whatwg-url更新增加了URL.parse()支持,提供了更灵活的URL处理能力。
  2. cssstylerrweb-cssom的更新改进了CSS解析能力,使JSDOM能更准确地处理复杂样式。
  3. nwsapi的更新提升了CSS选择器匹配的准确性和性能。
  4. parse5的更新修复了<noframes>元素处理和HTML实体解码的相关问题。

这些底层改进虽然不直接暴露为API变化,但显著提升了JSDOM的稳定性和标准兼容性。

JSDOM.fromURL()改进

修复了JSDOM.fromURL()方法的一个重要问题:现在当服务器重定向到无效URL时,该方法会正确地拒绝返回的Promise,而不是导致未捕获的异常。这使得错误处理更加可靠和符合预期。

升级建议

对于现有项目,升级到26.0.0版本时需要注意以下几点:

  1. 确保Canvas依赖已更新至v3版本
  2. 检查是否使用了任何可能受底层依赖更新影响的特性
  3. 考虑利用新的AbortSignal.any()方法简化异步操作管理
  4. 如果使用自定义元素,可以开始探索表单关联特性的使用

总体而言,JSDOM 26.0.0版本在保持稳定性的同时,带来了多项有价值的改进和新特性,特别是对现代Web标准的支持更加完善。这些更新使得JSDOM在模拟浏览器环境方面更加准确和强大,为服务器端DOM操作和测试提供了更好的基础。

登录后查看全文
热门项目推荐
相关项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
182
2.11 K
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
205
282
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
9
1
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
960
570
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
543
70
pytorchpytorch
Ascend Extension for PyTorch
Python
58
87
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
78
72
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
146
192
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
1.01 K
399