在我的 Cypress.io 测试中，为什么我需要将 cy.task 视为异步的而不是异步的

Question

我有Cypress.io 测试使用简单的Cypress task 将一些表信息记录到终端。例如我有一个这样的测试：

it("Writes some console logs and checks a val", () => {
  cy.task("rowLog", { id: 1, name: "foo", type: "bar" });
  let one = 1;
  expect(one).to.equal(2);
});

任务，“rowLog”是这样的：

module.exports = (on, config) => {
  on("task", {
  rowLog(data) {
    // use node.js console.table to pretty print table data:
    console.table(data);
    return null;
  },
}

但是如果我通过Cypress run 无头运行赛普拉斯，rowLog 的结果将不会显示在我的终端中。这是因为测试会失败。如果我们切换测试让它通过，那么它就会显示出来。

但是我刚刚意识到，如果我将rowLog 视为如下所示的异步。它将将结果打印到终端：

it("Writes some console logs and checks a val", () => {
  // add a .then to task:
  cy.task("rowLog", { id: 1, name: "foo", type: "bar" }).then(() => {
    let one = 1;
    expect(one).to.equal(2);
  });
});

这不是我对文档的期望。他们说：

cy.task() 产生由 pluginsFile 中的任务事件返回或解析的值。 (source)

并且一项任务可以产生一个承诺或一个价值。

我是赛普拉斯的新手——我有什么遗漏或做错了吗？我希望能够不必将我的任务与.then 语句链接起来，如果它只是同步的东西，比如编写输出以确保所有内容都发送到我的终端。

Answer 1

如果您查看cy.task 命令的类型定义，您会看到它返回一个可链接的（即类似promise 的实体）。所以它的行为就像任何其他 cy 命令（异步）。 至于yield either a promise or a **value** - 此语句指的是任务的处理程序，而不是任务本身。至于其他命令，如果处理程序没有完成，Cypress 会将返回值包装到 Promise 中。