如何基于${PIPESTATUS[0]}使CI任务在Jest测试失败时终止？

问题背景 #

Jest单元测试失败时会返回非零退出码，但通过tee命令输出测试结果到文件时，该退出码会被屏蔽。已验证Linux环境变量${PIPESTATUS[0]}能正确获取Jest的原始退出码（非零），但尝试直接exit ${PIPESTATUS[0]}或错误的if语句都无法让CI任务正常失败。

原始CI步骤代码：

- name: Install & test
    id: unit_coverage_status
    run: |
      npm ci
      npm run test-coverage | tee ./unit-coverage.txt
      echo "Test coverage exit code: ${PIPESTATUS[0]}"
      if ${PIPESTATUS[0]} == 0;
      then
        echo "Unit tests passed"            
      else
        echo "Unit tests failed"
        exit 1
      fi

后续用于向PR添加测试结果的步骤：

- name: Jest integration coverage comment
    uses: MishaKav/jest-coverage-comment@main
    with:
      coverage-path: ./int-coverage.txt       
      title: Integration Test Coverage   

问题原因 #

原始if语句存在语法错误：Bash中条件判断需要用[[ ]]或[ ]包裹条件，且整数相等比较需使用-eq（或双括号中用==）；同时直接使用${PIPESTATUS[0]}可能因后续命令导致变量值被覆盖。

修正后的CI代码 #

- name: Install & test
    id: unit_coverage_status
    run: |
      npm ci
      npm run test-coverage | tee ./unit-coverage.txt
      # 将Jest的退出码存入变量，避免后续操作影响
      TEST_EXIT_CODE=${PIPESTATUS[0]}
      echo "Test coverage exit code: $TEST_EXIT_CODE"
      if [[ $TEST_EXIT_CODE -eq 0 ]]; then
        echo "Unit tests passed"
      else
        echo "Unit tests failed"
        # 直接返回Jest的原始退出码，让CI任务失败
        exit $TEST_EXIT_CODE
      fi

说明 #

• 先将${PIPESTATUS[0]}赋值给变量TEST_EXIT_CODE，确保后续命令不会修改该值
• 使用[[ ]]进行条件判断，搭配-eq做整数相等校验，符合Bash语法规范
• 最终直接exit $TEST_EXIT_CODE，让CI任务基于Jest的原始退出码判断成败，比手动exit 1更准确

这样修改后，既能通过tee生成测试结果文件供后续PR注释步骤使用，又能让CI在Jest测试失败时正确捕获非零退出码并终止任务。

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