“伊斯坦布尔忽略下一个”命令似乎被忽略了

Question

我正在尝试使用 Jest 来测试我的代码。 在我尝试从测试中排除 class 方法之前，它工作得很好。

querySelector() 调用是我想跳过此方法进行测试的原因（“文档”显然是 null，除非我在浏览器中运行脚本）

我尝试了这个解决方案，这似乎是最推荐的一个：

  /* istanbul ignore next */
  appendNewInputFields() {

    const howMany = Number(document.querySelector('#items-to-add').value);
    
    [...Array(howMany)].forEach( i => {
      const newInputField = this.createNewItemInputField();
      this.inputItemsContainerNode.append(newInputField);
    });
  }

但是测试一直失败，并且/* istanbul ignore next */行似乎被忽略了。

我还尝试在 function 签名及其正文之间添加评论（正如这里某处所建议的那样），但没有运气：

 FAIL  js/DOMManager.test.js
  ● Test suite failed to run

    TypeError: Cannot read property 'value' of null

      135 |   appendNewInputFields() /* istanbul ignore next */ {
      136 |
    > 137 |     const howMany = Number(document.querySelector('#items-to-add').value);
          |                            ^
      138 |     

我读过这可能与babel-plugin-istanbul有关。 我试过了

npm --save-dev uninstall babel-plugin-istanbul

在终端返回：

npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@2.3.2 (node_modules/fsevents):
npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@2.3.2: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"})

removed 18 packages and audited 521 packages in 2.178s

但是文件夹babel-plugin-istanbul仍然存在于我的工作文件夹内的/node_modules/中，并且测试一直失败，好像没有任何改变一样。

如果我注释掉 function 的主体，其他测试套件可以完美运行。 如果我尝试将忽略下一个命令应用于代码的任何其他部分，则测试通过就好了，并且该行被完全忽略。

如果我尝试手动删除/babel-plugin-istanbul/文件夹（从我的工作文件夹中的 /node_modules/ 删除），Jest 将停止工作。

（这是我第一次安装 Node.js，我这样做只是因为我想用 Jest 开始单元测试。我指出这一点是因为这是我走出香草世界的第一步。我不知道如何为了处理 Node.js 和 npm，我刚刚启动了几个命令来安装它，我为 Jest 编写了一些测试，它们都立即运行良好。我没有使用任何其他框架，我试图坚持使用 vanilla JS尽可能。）

- - - - - - - - - - - - 编辑：

我尝试将代码更改为：

  appendNewInputFields() {
    // TODO solve the istanbul ignore issue
    
    let howMany;

    /* istanbul ignore if */
    if(document != null) {
      howMany = Number(document.querySelector('#items-to-add').value);
    
      [...Array(howMany)].forEach( i => {
        const newInputField = this.createNewItemInputField();
        this.inputItemsContainerNode.append(newInputField);
      });

      console.log("added " + howMany + " input fields");
    }
  }

我不断得到

 FAIL  js/DOMManager.test.js
  ● Test suite failed to run

    TypeError: Cannot read property 'value' of null

      139 |     /* istanbul ignore if */
      140 |     if(document != null) {
    > 141 |       howMany = Number(document.querySelector('#items-to-add').value);
          |                        ^
      142 |     
      143 |       [...Array(howMany)].forEach( i => {
      144 |         const newInputField = this.createNewItemInputField();

在这一点上我完全无能为力。 鉴于条件，“文档”应该是 null 并且该块完全跳过，但它一直未能通过测试。

在浏览器中运行时，相同的代码完全按照预期工作。

Answer 1

所以我在一个空白的新文件夹中做了一些测试，它终于让我印象深刻。

显然我误解了/* istanbul ignore next */的目的。

它的 function 不是在测试期间跳过代码执行，而是在确定已测试的总代码量时防止将那部分代码考虑在内。 代码运行（如果有任何东西调用该函数），但是当 Jest 总结它测试的行数时，这些行不计算在内（我猜这是 --coverage 的目的）。 如果发生错误，它会像往常一样被抛出。

我的问题与 Jest 或伊斯坦布尔 package 无关。 我现在意识到这一点感觉很愚蠢，但我需要的只是适当的异常处理。

我实现了一些老式的 try/catch 块：现在一切都顺利进行了测试，并且 istanbul ignore 指令按预期正确运行（现在我知道会发生什么）：未测试并标记为被忽略的函数，它们只是不要出现在最终的报道中。

我希望这可以帮助任何可能陷入我同样误解的人。

当然，如果有比我更有能力的人能证实这种解释，或者有任何建议或进一步的解释，显然将不胜感激。