cypress|cypress 的错误消息 - the element has become detached from the dom

这个错误消息的分析和解决方案,可以参考 Cypress 的官方文档。
这个错误消息提示我们,我们编写的 Cypress 代码正在同一个“死去”的 DOM 元素交互。
cypress|cypress 的错误消息 - the element has become detached from the dom
文章图片

显然,在真实的使用场景下,一个用户也无法同这种类型的 UI 元素交互。
看个实际例子:


这个 button 被点击之后,会将自己从 DOM 树中移除:
$('button').click(function () { // when the

下列这行测试代码会引起错误:
cy.get('button').click().parent()

当 cypress 执行到下一个 parent 命令时,检测到施加该命令的 button 已经从 DOM 树中移除了,因此会报错。
解决方案:
cy.get('button').click() cy.get('#parent')

解决此类问题的指导方针:
Guard Cypress from running commands until a specific condition is met
【cypress|cypress 的错误消息 - the element has become detached from the dom】两种实现 guard 的方式:
  1. Writing an assertion
  2. Waiting on an XHR
看另一个例子:
输入 clem,从结果列表里选择 User clementine , 即所谓的 type head search 效果。
cypress|cypress 的错误消息 - the element has become detached from the dom
文章图片

测试代码如下:
it('selects a value by typing and selecting', () => { // spy on the search XHR cy.server() cy.route('https://jsonplaceholder.cypress.io/users?term=clem&_type=query&q=clem').as('user_search')// first open the container, which makes the initial ajax call cy.get('#select2-user-container').click()// then type into the input element to trigger search, and wait for results cy.get('input[aria-controls="select2-user-results"]').type('clem{enter}')// select a value, again by retrying command // https://on.cypress.io/retry-ability cy.contains('.select2-results__option', 'Clementine Bauch').should('be.visible').click() // confirm Select2 widget renders the name cy.get('#select2-user-container').should('have.text', 'Clementine Bauch') })

要点:
使用 cy.route 监控某个 XHR, 这里可以监控相对路径吗?
本地测试通过,在 CI 上运行时会遇到下列错误:
cypress|cypress 的错误消息 - the element has become detached from the dom
文章图片

如何分析这个问题呢?可以使用 pause 操作,让 test runner 暂停。
// first open the container, which makes the initial ajax call cy.get('#select2-user-container').click().pause()

当我们点击了 select2 widget 时,会立即触发一个 AJAX call. 而测试代码并不会等待 clem 搜索请求的返回。它只是一心查找 "Clementine Bauch" 的 DOM 元素。
// first open the container, which makes the initial ajax call cy.get('#select2-user-container').click()// then type into the input element to trigger search, // and wait for results cy.get('input[aria-controls="select2-user-results"]').type('clem{enter}')cy.contains('.select2-results__option', 'Clementine Bauch').should('be.visible').click()

上面的测试在本地运行时大部分时间可能会通过,但在 CI 上它可能会经常失败,因为网络调用速度较慢,浏览器 DOM 更新可能较慢。 以下是测试和应用程序如何进入导致 “detached element” 错误的竞争条件。
  1. 测试点击小部件
  2. Select2 小部件触发第一个搜索 Ajax 调用。 在 CI 上,此调用可能比预期慢。
  3. 测试代码输入“clem”进行搜索,这会触发第二个 AJAX 调用。
  4. Select2 小部件接收对带有十个用户名的第一个搜索 Ajax 调用的响应,其中一个是“Clementine Bauch”。 这些名称被添加到 DOM
然后测试搜索可见的选择“Clementine Bauch” - 并在初始用户列表中找到它。
然后,测试运行器将要单击找到的元素。注意这里的竟态条件。当第二个搜索 Ajax 调用“term=clem”从服务器返回时。 Select2 小部件删除当前的选项列表,只显示两个找到的用户:“Clementine Bauch”和“Clementina DuBuque”。
然后测试代码执行 Clem 元素的点击。
Cypress 抛出错误,因为它要单击的带有文本“Clementine Bauch”的 DOM 元素不再链接到 HTML 文档; 它已被应用程序从文档中删除,而 Cypress 仍然引用了该元素。
这就是问题的根源。
下面这段代码可以人为地让这个竟态条件总是触发:
cy.contains('.select2-results__option', 'Clementine Bauch').should('be.visible') .pause() .then(($clem) => { // remove the element from the DOM using jQuery method $clem.remove() // pass the element to the click cy.wrap($clem) }) .click()

既然了解了竟态条件触发的根源,修正起来就有方向了。
我们希望测试在继续之前始终等待应用程序完成其操作。
解决方案:
cy.get('#select2-user-container').click()// flake solution: wait for the widget to load the initial set of users cy.get('.select2-results__option').should('have.length.gt', 3)// then type into the input element to trigger search // also avoid typing "enter" as it "locks" the selection cy.get('input[aria-controls="select2-user-results"]').type('clem')

我们通过 cy.get('XXX').should('') 操作,确保在执行 clem 输入之前,初始的 user list 对应的 AJAX 一定回复到服务器上了,否则 select2-options 的长度必定小于 3.
当测试在搜索框中键入“clem”时,应用程序将触发 Ajax 调用,该调用返回用户的子集。 因此,测试需要等待显示新集合 - 否则它将从初始列表中找到“Clementine Bauch”并遇到detached 错误。我们知道只有两个用户匹配“clem”,因此我们可以再次确认显示的用户数以等待应用程序。
/ then type into the input element to trigger search, and wait for results cy.get('input[aria-controls="select2-user-results"]').type('clem')// flake solution: wait for the search for "clem" to finish cy.get('.select2-results__option').should('have.length', 2)cy.contains('.select2-results__option', 'Clementine Bauch') .should('be.visible').click()// confirm Select2 widget renders the name cy.get('#select2-user-container') .should('have.text', 'Clementine Bauch')

如果盲目的在 click 调用里传入 force:true 的参数,可能会引入新的问题。
cypress|cypress 的错误消息 - the element has become detached from the dom
文章图片

cypress|cypress 的错误消息 - the element has become detached from the dom
文章图片

更多Jerry的原创文章,尽在:"汪子熙":
cypress|cypress 的错误消息 - the element has become detached from the dom
文章图片

    推荐阅读