为何TestCafe异步函数从node_modules导入失效，本地导入正常？

问题概述 #

我有一段异步函数clickBodyTwice，从本地源码目录导入时可正常运行，但复制到node_modules目录后导入就会失效。此前一直认为从node_modules导入代码和其他目录导入完全一致，但实际并非如此。

声明 #

该函数使用TestCafe库，采用**隐式测试控制器访问（implicit test controller access）**机制。TestCafe明确说明该机制在异步上下文不被支持，且已有修复方案。此问题并非寻求修复方法，而是询问两个目录导入存在差异的原因。

背景 #

我正尝试导出一个使用该模式的库，团队已在整个项目中使用该模式多年——尽管TestCafe明确不支持，但一直能正常运行，直到将库导出并导入到node_modules中。修复方案是传递测试控制器作为参数，但这需要大量重构及团队培训。

相关代码 #

click-body-twice.js #

const { t } = require("testcafe");
async function clickBodyTwice() {
    console.log("begin");

    await t.click("body");
    console.log("clicked once");

    await t.click("body");
    console.log("clicked twice");
}
exports.clickBodyTwice = clickBodyTwice;

test.js #

const { clickBodyTwice: topLevelFn } = require("./@@bug-repro/click-body-twice")
const { clickBodyTwice: nodeModuleFn } = require("./node_modules/@@bug-repro/click-body-twice")

fixture("Testcafe bug repro")

test("succeeds", async (t) => {
    await t.navigateTo("http://www.google.com");
    await topLevelFn();
})

test("fails", async (t) => {
    await t.navigateTo("http://www.google.com");
    await nodeModuleFn();
})

package.json #

{
    "dependencies": {
        "testcafe": "3.5.0"
    }
}

复现步骤 #

• 将上述代码整理为如下目录结构：

@@bug-repro
   - click-body-twice.js
package.json
test.js

• 执行npm i
• 将@@bug-repro复制到node_modules目录
• 执行npx testcafe chrome .\test.js

运行结果 #

本地导入的测试用例成功执行两次点击，而从node_modules导入的用例在第二次执行t.click("body")时报错：

The action does not have implicit test controller access. Reference the 't' object to gain it.

调试结论 #

通过单步调试发现，TestCafe通过callsite包调用V8的**栈追踪API（V8's stacktrace API）**查找测试控制器，它将控制器ID嵌入到函数名中，通过栈追踪获取。但从node_modules导入时的栈追踪结果与本地导入时不同，导致该机制失效。

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