できない.dev

Vitest で -t で絞り込んだテストが実行されない

Vitest で -t を付けたテストが全部 skipped になるなら、describe とテストの名前を「 > 」でつなげば直る。
5 は -t を「math > adds」の形の名前と照合し、当たらなくても終了コードは 0 だ。

公開:

症状できない
npx vitest run -t "math adds"
…
 Test Files  1 skipped (1)
      Tests  2 skipped (2)
   Start at  21:50:32
   Duration  112ms (transform 61%, import 29%, worker 10%)
解決後できた · exit 0
npx vitest run -t "math > adds"
…
 Test Files  1 passed (1)
      Tests  1 passed | 1 skipped (2)
   Start at  21:50:34
   Duration  105ms (import 41%, transform 28%, worker 21%, tests 10%)

2026-11-07 に node:24(Vitest 5.1.0 / Node.js 24.22.2) で実際に打って取った出力。検証環境の詳細

要約

npx vitest run -t "math adds" のように -t(--testNamePattern)で絞り込むと、Tests 2 skipped (2) と出て 1 本も走らないことがある。
終了コードは 0 で、エラーも警告も出ない。

Vitest 5 は、-t の値を describe の名前とテスト名を「 > 」でつないだ名前(math > adds)と照合する(公式の移行ガイド(新しいタブで開く))。
4 までは空白でつないでいたので、4 で当たっていた -t "math adds" は 5 で当たらなくなった。
照合される名前は npx vitest list で見られる。

実行例

node:24 のコンテナで Vitest 5.1.0 を入れ、-t "math adds" で絞り込むと 2 本とも skipped になり、終了コードは 0 だった。
「 > 」でつなぐかテスト名だけを渡すと 1 本が走り、( と + を含む名前は \ で打ち消すと当たった。

$ npx vitest run -t "math adds"
 RUN  v5.1.0 /tmp/tmp.6BB6ZkqTQQ
 
 ↓ math.test.js (2 tests | 2 skipped)
 
 Test Files  1 skipped (1)
      Tests  2 skipped (2)
   Start at  21:50:32
   Duration  112ms (transform 61%, import 29%, worker 10%)
$ echo $?
0
$ cat math.test.js
import { describe, expect, test } from "vitest";
 
describe("math", () => {
  test("adds", () => {
    expect(1 + 2).toBe(3);
  });
 
  test("subtracts", () => {
    expect(3 - 1).toBe(2);
  });
});
$ npx vitest list
math.test.js > math > adds
math.test.js > math > subtracts
$ npx vitest run -t "math.test.js > math > adds"
 RUN  v5.1.0 /tmp/tmp.6BB6ZkqTQQ
 
 ↓ math.test.js (2 tests | 2 skipped)
 
 Test Files  1 skipped (1)
      Tests  2 skipped (2)
   Start at  21:50:33
   Duration  96ms (import 44%, transform 37%, worker 18%, environment 1%)
$ echo $?
0
$ npx vitest run -t "math > adds"
 RUN  v5.1.0 /tmp/tmp.6BB6ZkqTQQ
 
 ✓ math.test.js (2 tests | 1 skipped) 2ms
 
 Test Files  1 passed (1)
      Tests  1 passed | 1 skipped (2)
   Start at  21:50:34
   Duration  105ms (import 41%, transform 28%, worker 21%, tests 10%)
$ echo $?
0
$ npx vitest run -t adds
 RUN  v5.1.0 /tmp/tmp.6BB6ZkqTQQ
 
 ✓ math.test.js (2 tests | 1 skipped) 2ms
 
 Test Files  1 passed (1)
      Tests  1 passed | 1 skipped (2)
   Start at  21:50:34
   Duration  94ms (import 45%, transform 24%, worker 19%, tests 12%, environment 1%)
$ echo $?
0
$ npx vitest list -t "math > adds"
math.test.js > math > adds
$ cat price.test.js
import { expect, test } from "vitest";
 
test("total (1 + 2)", () => {
  expect(1 + 2).toBe(3);
});
$ npx vitest run price.test.js -t "total (1 + 2)"
 RUN  v5.1.0 /tmp/tmp.6BB6ZkqTQQ
 
 ↓ price.test.js (1 test | 1 skipped)
 
 Test Files  1 skipped (1)
      Tests  1 skipped (1)
   Start at  21:50:35
   Duration  92ms (transform 51%, import 38%, worker 11%)
$ echo $?
0
$ npx vitest run price.test.js -t 'total \(1 \+ 2\)'
 RUN  v5.1.0 /tmp/tmp.6BB6ZkqTQQ
 
 ✓ price.test.js (1 test) 2ms
 
 Test Files  1 passed (1)
      Tests  1 passed (1)
   Start at  21:50:36
   Duration  89ms (import 43%, transform 28%, worker 17%, tests 11%, environment 1%)
$ echo $?
0

— 2026-11-07 時点の出力

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-07 検証(ほか 2 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • Vitest 5.1.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 区切りを「 > 」にする

npx vitest run -t "math > adds"

package.json の scripts や CI の設定に -t を書いているなら、そちらも直す。
1 本も当たらなくても終了コードは 0 なので、CI はテストを走らせないまま成功する。

2. テスト名の一部だけを渡す

npx vitest run -t adds

-t は名前の一部に当たれば絞り込めるので、区切りを書かずにテスト名だけを渡してもよい。
公式の移行ガイドは、区切りに左右されない書き方として -t "math.*adds" も挙げている。
走らせる前に npx vitest list -t "math > adds" を打つと、当たるテストだけが一覧に出る。

3. 正規表現の記号を打ち消す

npx vitest run price.test.js -t 'total \(1 \+ 2\)'

(・)・+ の前に \ を置くと、文字そのものとして照合される。
二重引用符の中ではシェルが \ を残すかどうかが記号ごとに違うので、値は単引用符で囲む。

よくある原因

  1. describe の名前とテスト名を空白でつないで書いている。
    5 の照合では間に「 > 」が入るので当たらない。
  2. npx vitest list が表示した行をそのまま -t に入れている。
    vitest list は math.test.js > math > adds とファイル名から表示するが、-t が照合するのはファイル名を除いた math > adds だ。
  3. テスト名にある ( や + をそのまま書いている。
    -t の値は正規表現として読まれ、( と ) はグループ、+ は直前の文字の繰り返しになる。
    テスト名の文字そのものとは照合されない。