コンテンツにスキップ

Go/goコマンド/tool/test2json

出典: フリー教科書『ウィキブックス(Wikibooks)』

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 ツールや独自のダッシュボードに取り込む際の標準的なインターフェースとなっています。