JSDOM 26.0.0版本发布:Canvas升级与Web标准新特性支持
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)并支持ElementInternals的labels属性。表单关联自定义元素是Web Components技术的一部分,允许自定义元素像原生表单控件一样参与表单提交和验证。
虽然当前版本尚未支持完整的表单关联回调,但这一更新已经为开发者提供了构建更复杂表单组件的基础。ElementInternals的labels属性特别有用,它可以让自定义元素像原生表单控件一样与<label>元素关联。
底层依赖更新与改进
JSDOM 26.0.0版本还更新了多个关键依赖:
whatwg-url更新增加了URL.parse()支持,提供了更灵活的URL处理能力。cssstyle和rrweb-cssom的更新改进了CSS解析能力,使JSDOM能更准确地处理复杂样式。nwsapi的更新提升了CSS选择器匹配的准确性和性能。parse5的更新修复了<noframes>元素处理和HTML实体解码的相关问题。
这些底层改进虽然不直接暴露为API变化,但显著提升了JSDOM的稳定性和标准兼容性。
JSDOM.fromURL()改进
修复了JSDOM.fromURL()方法的一个重要问题:现在当服务器重定向到无效URL时,该方法会正确地拒绝返回的Promise,而不是导致未捕获的异常。这使得错误处理更加可靠和符合预期。
升级建议
对于现有项目,升级到26.0.0版本时需要注意以下几点:
- 确保Canvas依赖已更新至v3版本
- 检查是否使用了任何可能受底层依赖更新影响的特性
- 考虑利用新的
AbortSignal.any()方法简化异步操作管理 - 如果使用自定义元素,可以开始探索表单关联特性的使用
总体而言,JSDOM 26.0.0版本在保持稳定性的同时,带来了多项有价值的改进和新特性,特别是对现代Web标准的支持更加完善。这些更新使得JSDOM在模拟浏览器环境方面更加准确和强大,为服务器端DOM操作和测试提供了更好的基础。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0231
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
JoyAI-VL-Interaction-Preview京东开源首个开源、视觉驱动的实时交互模型——它能实时监控视频流,并自主决定何时发言、保持沉默或委托任务。Jinja00
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0149
kornia🐍 空间人工智能的几何计算机视觉库Python02
PaddleParallel Distributed Deep Learning: Machine Learning Framework from Industrial Practice (『飞桨』核心框架,深度学习&机器学习高性能单机、分布式训练和跨平台部署)C++02