Go/goコマンド/tool/test2json
表示
go tool test2json コマンドについて
[編集]go test の出力を機械可読な JSON 形式に変換するツールです。CI システムやテスト結果を処理するツールとの連携に使われます。
基本的な使い方
[編集]直接実行
[編集]go tool test2json ./pkg.test -test.v
go test の出力をパイプ
[編集]go test -v ./... | go tool test2json go test -v -json ./... # こちらの方が一般的(内部で test2json を使用)
フラグ
[編集]| フラグ | 効果 |
|---|---|
-p pkg
|
パッケージ名を指定(出力 JSON の Package フィールドに入る)
|
-t
|
各イベントに現在時刻のタイムスタンプを付与 |
出力形式
[編集]1イベント1行の JSON(JSON Lines 形式)で出力されます。
{"Time":"2026-03-21T10:00:00Z","Action":"run","Package":"main","Test":"TestFoo"} {"Time":"2026-03-21T10:00:01Z","Action":"output","Package":"main","Test":"TestFoo","Output":"--- PASS: TestFoo (0.01s)\n"} {"Time":"2026-03-21T10:00:01Z","Action":"pass","Package":"main","Test":"TestFoo","Elapsed":0.01} {"Time":"2026-03-21T10:00:01Z","Action":"pass","Package":"main","Elapsed":0.01}
Action フィールドの値
[編集]| Action | 意味 |
|---|---|
run
|
テスト開始 |
pause
|
テスト一時停止(並列テスト) |
cont
|
テスト再開 |
pass
|
テスト成功 |
fail
|
テスト失敗 |
skip
|
テストスキップ |
output
|
テストの出力行 |
start
|
パッケージのテスト開始 |
build-fail
|
ビルド失敗 |
go test -json との関係
[編集]# 以下は実質的に同等 go test -v ./... | go tool test2json -t -p mypackage go test -v -json ./... # -json が内部で test2json を呼ぶ
通常は -json フラグを使う方が簡単です。test2json を直接使うのは既存のテストバイナリの出力を変換したい場合です。
# ビルド済みテストバイナリを使う場合 go test -c -o pkg.test . go tool test2json -p mypkg -t ./pkg.test -test.v
実用例
[編集]CI での利用
[編集]go test -json ./... > results.jsonl
jq でフィルタリング
[編集]# 失敗したテストのみ表示 go test -json ./... | jq 'select(.Action=="fail")' # テスト名と経過時間を抽出 go test -json ./... | jq 'select(.Action=="pass") | {Test, Elapsed}'
| 項目 | 内容 |
|---|---|
| 主な用途 | テスト結果の機械処理・CI 連携 |
| 出力形式 | JSON Lines(1イベント1行) |
| 通常の使い方 | go test -json 経由(内部で呼ばれる)
|
| 直接使う場面 | ビルド済みテストバイナリの出力変換 |
| 関連ツール | go test・go tool dist test
|
go test -json の裏側で動いているツールで、テスト結果を GitHub Actions・Jenkins などの CI ツールや独自のダッシュボードに取り込む際の標準的なインターフェースとなっています。