開発者の質問に先回りして答える、QA 向けバグ報告ツール
更新日
Midge は、Chrome 拡張機能として作られた QA 向けのバグ報告ツールです。テスターがバグを録画すると、レポートには動画、操作手順、コンソールエラー、ネットワークリクエスト、環境情報があらかじめ添付されるので、開発者は最初に読んだ時点で必要なものを手にできます。Midge は無料で、録画数は無制限、動画は最長 15 分、透かしも入りません。
バグ報告のコストは、書く時間であることはまれです。本当のコストは、そのあとに続くやり取りです。「どのブラウザですか?」「コンソールを送ってもらえますか?」「その前に何をクリックしましたか?」。Midge は、このやり取りをなくすために設計されています。
各レポートに最初から入っているもの
すべての録画に、コンソールログ、ネットワークリクエスト、ユーザー操作、デバイス情報が含まれます。QA チームにとっては、これが良い不具合報告の各項目にそのまま対応します。
| 不具合報告の項目 | Midge での情報源 |
|---|---|
| 再現手順 | ユーザー操作ログ:クリック、ページ遷移、入力したフィールド |
| 実際の結果 | 動画または注釈付きスクリーンショット |
| エラーの詳細 | コンソールエラーとスタックトレース、失敗したネットワークリクエスト |
| 環境 | ブラウザとバージョン、OS、ウインドウサイズ、言語、タイムゾーン、URL |
タイトル、期待される結果、そして使ったテストデータのように録画からはわからないことは、引き続きあなたが書きます。Midge のリンクと相性の良い書式は、バグ報告テンプレートで紹介しています。
打ち直さなくていい再現手順
録画中、Midge はあなたの操作を記録します。「Clicked Add to cart」「Navigated to /checkout」「Typed in input[name=coupon]」のようにです。入力したテキストそのものは記録されないので、テスト用のパスワードやカード番号がレポートに入ることはありません。この操作ログが、再現手順の骨組みになります。チケット用の番号付きリストに整えるのは 1 分ほどで、記憶ではなく記録に基づいているので正確です。
各レポートには、録画とそのログから書かれた、再現手順と考えられる原因を含む AI 要約も付きます。要約は 1 人あたり月 30 件まで無料です。チケットに貼る前に、操作ログと照らし合わせて確認してください。
環境情報を自動で記録
「自分の環境では動く」は、たいてい環境が違うということです。Midge はレポートごとに、ブラウザとそのバージョン、OS、ウインドウサイズ、言語、タイムゾーンを記録します。幅 1280 ピクセルのときだけ起きるレイアウトのバグや、Europe/Berlin タイムゾーンでだけ起きる日付のバグも、情報パネルを見れば原因がわかります。
自分で捕まえなくてもいいエラー
良いバグ報告をするのに、テスターが DevTools を開いておく必要はありません。Midge はバックグラウンドでコンソールとネットワークを監視し、直近数分間をメモリに保持しています。何かが壊れたときに録画を始めるかスクリーンショットを撮れば、エラーはすでにそこにあります。記録される内容はコンソールログとネットワークログをご覧ください。
20 回に 1 回しか出ない不安定なバグには、ステージング環境でインスタントリプレイをオンにしてください。バグが出たら、ワンクリックでページの直前 30〜120 秒を保存できます。リプレイは初期設定ではオフで、サイトごとにオンにします。
リリースごとのフォルダ
レポートは、フォルダのある共有ワークスペースに保存されます。よくある構成は次のとおりです。
Release 4.12のように、リリースごとに 1 フォルダ- 再発したバグのための常設の
Regressionフォルダ - プロダクト側の回答待ちのレポートを入れる
Needs infoフォルダ
各レポートは、リンクを知っている全員、ワークスペースのメンバーだけに共有することも、書き終えるまで非公開にしておくこともできます。チーム、フォルダ、非公開レポートは無料です。
Midge を使ったリグレッションテスト
- テストを始める前に、対象ビルド用のフォルダを作ります。
- いつもどおりテストケースを進めます。失敗したら、画面録画で録画するか、注釈付きスクリーンショットを撮ります。
- 症状がわかるタイトルを付けます。たとえば「ログアウト後に保存済みフィルターが消える」。
- レポートをトラッカーに送ります。Jira、Linear、GitHub Issues の連携機能を接続していれば、Send to Jira(または Linear、GitHub)で、リンク、AI 要約、再現手順付きの課題が作成されます。ほかのトラッカーを使っている場合は、リンクを貼ってください。必要なものはすべてリンクの先にあります。
- テストが終わると、そのビルドで失敗したものがすべて 1 つのフォルダにまとまっています。
チームの外にも安心して共有
QA はステージング環境で本物そっくりのデータを扱うことが多く、バグ報告は開発者、外部の協力者、ときにはベンダーのサポート窓口にまで渡ります。パスワード、カード番号、トークン、Cookie は、デバイスから送信される前にブラウザ内で伏せられます。メールアドレスは一部だけマスクされ、[email protected] は q***@acme.com になります。ベンダーから HAR ファイルを求められた場合は、先に無料の HAR サニタイザーできれいにしてください。
知っておきたい制限
Midge の拡張機能が記録するのは Chrome のタブで、Midge for Mac は Safari のタブと Electron アプリを、コンソールログとネットワークログ付きで録画します。Firefox でのテストでは、引き続き別の方法で証拠を集める必要があります。各ブラウザで HAR ファイルを取得する方法はガイドで解説しています。また Midge は、テストケースの実行やカバレッジの管理は行いません。それらを担うツールの概要は、QA テストツールのガイドをお読みください。
よくある質問
- Midge は再現手順の作成にどう役立ちますか?
- Midge はクリック、ページ遷移、入力したフィールド(入力したテキストは除く)を、動画と同じタイムライン上に記録します。このログがそのまま手順の骨組みになり、1 分ほどでチケット用に整えられます。
- どんな環境情報が記録されますか?
- ブラウザとそのバージョン、OS、ウインドウサイズ、言語、タイムゾーン、ページの URL が、レポートごとに自動で記録されます。
- リリースやスプリントごとにレポートを整理できますか?
- はい。ワークスペースにはフォルダがあるので、リリースごと、スプリントごと、テストサイクルごとにフォルダを分けられます。チームとフォルダは無料です。
- Midge はテスト管理ツールの代わりになりますか?
- なりません。Midge はバグの証拠を記録して共有するツールです。テストケース、テスト実行、カバレッジは引き続きテスト管理ツールで扱い、そこで登録する不具合に Midge のリンクを貼ってください。