升级Vue从3.2.37到3.2.39后Jest报isCE空值读取错误

问题描述 #

将Vue项目从3.2.37版本升级至3.2.39后，运行Jest测试时出现以下错误：

[UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "TypeError: Cannot read properties of null (reading 'isCE')".] {
  code: 'ERR_UNHANDLED_REJECTION'
}

回退Vue版本后测试可正常运行，请问该isCE错误的成因是什么？是否涉及破坏性变更？

错误成因 #

isCE是Vue内部用于标记**是否为自定义元素（Custom Element）**的私有属性。出现这个错误的核心原因是：测试场景中代码尝试访问了一个null或undefined对象的isCE属性。

在Vue 3.2.38至3.2.39的版本迭代中，Vue内部对自定义元素的检测逻辑做了微调——原本某些边缘场景下会返回空值的处理逻辑，现在触发了更严格的属性校验，导致未被妥善处理的空对象暴露出来，进而在Jest测试中抛出未捕获的Promise拒绝错误。

是否涉及破坏性变更？ #

该问题不属于Vue官方标记的破坏性变更，而是版本迭代中内部逻辑调整带来的边缘场景兼容性问题。这类问题通常出现在以下场景：

• 测试代码直接操作了Vue未公开的内部API或私有属性
• 使用的@vue/test-utils等测试工具版本过旧，与升级后的Vue内部逻辑不兼容
• 测试用例存在未正确初始化的组件实例，或异步操作未被try/catch或.catch()妥善捕获

临时解决方向 #

• 优先升级@vue/test-utils等测试依赖到与Vue 3.2.39兼容的版本
• 排查测试用例中的异步逻辑，确保所有Promise都有错误捕获处理
• 检查测试代码是否直接访问了isCE这类Vue私有属性，替换为官方公开的API

内容的提问来源于stack exchange，提问作者Jackie