Cypress 里的 ensureAttached 检测原理

下面是我用 Cypress 开发的端到端测试。click 调用里的 force:true 参数是我后来加上去的。

Cypress 里的 ensureAttached 检测原理_第1张图片

如果不添加,会遇到错误消息:

Cypress 里的 ensureAttached 检测原理_第2张图片

在方法 $Cy.ensureAttached 里面跑出来的,这个方法位于 runner/cypress_runner.js 下面。

我想知道这个 cypress_runner.js 的本地位置:

Cypress 里的 ensureAttached 检测原理_第3张图片

本地请求的 url:http://localhost:4200/__cypre...

远端端口:59701?

Cypress 里的 ensureAttached 检测原理_第4张图片

重定向到 __?

Cypress 里的 ensureAttached 检测原理_第5张图片

这个文件有20万行代码:

Cypress 里的 ensureAttached 检测原理_第6张图片

怀疑这个庞大的文件是 merge 起来的:
Cypress 里的 ensureAttached 检测原理_第7张图片

这里能看到所有的 ensure 检查:
Cypress 里的 ensureAttached 检测原理_第8张图片

断点触发时,从 callstack 是很难发现到底是哪一行 e2e spec 代码触发的这个 ensureAttached 检查:
Cypress 里的 ensureAttached 检测原理_第9张图片

但是可以通过输入参数里指定的 select,到 e2e 代码里搜索:

Cypress 里的 ensureAttached 检测原理_第10张图片

cx-hamburger-menu [aria-label=\"Menu\"]

通过参数说明,点击了 cx-hamburge 的 button 元素:

Cypress 里的 ensureAttached 检测原理_第11张图片

很容易就找到了:
Cypress 里的 ensureAttached 检测原理_第12张图片

具体逻辑就是,检查元素的 ownerDocument 属性:
Cypress 里的 ensureAttached 检测原理_第13张图片

这是 Web API 里 Node 元素的标准属性,见官网

接口的只读 ownerDocument 属性: 返回节点的顶级文档对象。

使用例子:

// Given a node "p", get the top-level HTML
// child of the document object

const d = p.ownerDocument;
const html = d.documentElement;

然后再判断这个 document 对象,是否有 activeWindow:

  return nodes.every(node => {
    const doc = _document__WEBPACK_IMPORTED_MODULE_1__[/* default */ "a"].getDocumentFromElement(node);

    if (!_document__WEBPACK_IMPORTED_MODULE_1__[/* default */ "a"].hasActiveWindow(doc)) {
      return false;
    }

    return node.isConnected;
  });
};

这里 Cypress 还针对 firefox 进行了不同的处理:
Cypress 里的 ensureAttached 检测原理_第14张图片

因为在 firefox 里,即使 detached document, 也还保留了一个指向 window 的 reference.

const hasActiveWindow = doc => {
  // in firefox, detached documents still have a reference to their window
  // but document.location is null
  if (Cypress.isBrowser('firefox') && !doc.location) {
    return false;
  }

  return !!doc.defaultView;
};

defaultView 是 Web API 另一个标准的接口

In browsers, document.defaultView returns the window object associated with a document, or null if none is available.

这个也是只读属性,返回 document 关联的 window 对象。如果元素所在的 document 对象已经 detach from DOM,则 defaultView 指向 null.

node.isConnected:

Cypress 里的 ensureAttached 检测原理_第15张图片

接口 的只读isConnected属性 返回一个布尔值,指示节点是否(直接或间接)连接到上下文对象,例如Document(普通 DOM 情况下的对象),或ShadowRoot 影子 DOM 情况下的对象。

更多Jerry的原创文章,尽在:"汪子熙":
Cypress 里的 ensureAttached 检测原理_第16张图片

你可能感兴趣的