本文へスキップ

ログがそのまま添付される、スクリーンショットの Chrome 拡張機能

更新日

Midge は、バグ報告のためのスクリーンショット Chrome 拡張機能です。タブの表示範囲や選択した範囲を撮り、矢印、枠、ペン、テキスト、ぼかしで印を付けて、リンク 1 つで共有できます。普通のスクリーンショットツールと違い、Midge はページの直近のコンソールログ、ネットワークリクエスト、ユーザー操作、デバイス情報を添付します。画像と一緒に、開発者が必要とする証拠も届くわけです。

Midge は無料で、録画数は無制限、動画は最長 15 分、透かしも入りません。スクリーンショットも録画として数えられるので、必要なだけ撮って共有できます。

2 つの撮り方

表示範囲

ワンクリックで、タブに見えている内容をそのまま撮れます。ブラウザのツールバー、ブックマークバー、ほかのウインドウは入りません。レイアウト全体が重要なときに使います。たとえば、間違ったテーマで表示されるページ、崩れたグリッド、出るはずのない場面で出てくる空の状態などです。

選択範囲

おかしな部分をドラッグで四角く囲みます。位置のずれたボタンや途中で切れたラベルは、ぴったり切り取ったほうが、問題を探し回らないといけないページ全体の画像より読みやすくなります。どのページにいたか、何をクリックしたかといった状況は、説明欄に書き添えられます。

問題がひと目でわかる注釈

撮影が終わると、Midge はシンプルなエディターを開きます。

  • 矢印: 問題の要素をピンポイントで指します。「隣のではなく、これです」。
  • 枠: 一致するはずの 2 つの価格など、ある範囲を囲みます。
  • ペン: フリーハンドで丸を付けたり、下線を引いたりします。
  • テキスト: 「3 件と表示されるはず」のような短いラベルを画像に直接書き込みます。
  • ぼかし: 共有する前に、顧客名、メールアドレス、口座番号などを隠します。

注釈は少なく、具体的に。重なり合った枠を 5 つ置くより、矢印 1 本と短いラベル 1 つのほうがたいてい伝わります。

スクリーンショットにログが付いてくる

ここが普通のスクリーンショットツールにはできない部分です。Midge はバックグラウンドでページのコンソールとネットワークの動きを記録し、直近の数分間をメモリに保持しています。スクリーンショットを撮ると、その状況がまとめて添付されます。すべての録画に、コンソールログ、ネットワークリクエスト、ユーザー操作、デバイス情報が含まれます。スクリーンショットのレポートにも同じデータが付きます。

これがなぜ大事なのか、例で見てみましょう。ダッシュボードのカードに、コンバージョン率ではなく「NaN%」と表示されているとします。スクリーンショットに映るのは症状です。添付されたネットワークログには原因が写っています。

GET /api/metrics/conversion  200
{"visits": 0, "orders": 0, "rate": null}

開発者は、訪問数がゼロの日に API が null を返し、フロントエンドがゼロで割っていたことがわかります。何日もやり取りする代わりに、5 分で直せる修正になります。詳しくはネットワークログとコンソールログをご覧ください。

バックグラウンドでの記録はデバイスの中にとどまります。メモリ上にだけ置かれ、タブを閉じると消去され、レポートを作成したときにだけパソコンの外に出ます。銀行のサイトなど、Midge を絶対に動かしたくないサイトを登録しておくこともできます。

スクリーンショットのプライバシー

考えるべきことは 2 つあります。

画像。 画面に見えているものは、そのままスクリーンショットに写ります。共有する前に、個人データにはぼかしツールを使ってください。パスワード欄とカード番号欄の自動ぼかしはタブ録画にだけ適用され、スクリーンショットには適用されません。ここでは、ぼかしはあなたの役目です。

ログ。 パスワード、カード番号、トークン、Cookie は、デバイスから送信される前にブラウザ内で伏せられます。メールアドレスは一部だけマスクされるので、どのテストアカウントでバグが起きたかは開発者にもわかります。ルールの全一覧はマスキングのページにあります。

スクリーンショットか、動画か

誤った文言、崩れたレイアウト、間違った数字、表示されないアイコンなど、1 コマで見えるバグならスクリーンショットを使いましょう。クリックする前に閉じてしまうメニューや、2 回送信されるフォームのように、手順の流れやタイミング、アニメーションが関わるバグなら画面録画が向いています。準備していないときに何かおかしなことが起きた場合は、そのサイトでオンにしてあれば、インスタントリプレイで直前の数十秒を保存できます。

共有

スクリーンショットごとにリンクが発行されます。開ける人は、リンクを知っている全員、ワークスペースのメンバー、自分だけ、の中から選べます。リリースごと、スプリントごとなどのフォルダに整理しておけば、チームがあとから見つけやすくなります。チームとフォルダも無料です。

良いスクリーンショットのバグ報告

スクリーンショットが答えるのは「何がおかしいか」です。説明欄では「本来どうなるはずだったか」と「どうすればそこにたどり着けるか」に答えます。短い例を挙げます。

Title: Order count shows 0 on the Orders tab after filtering by "Last 7 days"
Steps: Orders, set filter to Last 7 days, wait for the list to load
Expected: count matches the 12 rows in the list
Actual: count shows 0 (arrow in screenshot)

バグ報告テンプレートとバグ報告の例に、こうしたパターンをさらに載せています。また、チームメイトからリクエストのトークンが送られてきて中身を確認したいときは、無料の JWT デコーダーを使えば、どこにも送信せずにブラウザ内で読み取れます。

よくある質問

ページの一部だけを撮れますか?
はい。タブの表示範囲を撮るか、ドラッグして範囲を選べます。壊れているコンポーネントだけを切り取れば、スクリーンショットがぐっと読みやすくなります。
どんな注釈ツールがありますか?
矢印、枠、フリーハンドのペン、テキストラベル、ぼかしツールです。名前やメールアドレスなど、画像に残したくないものにはぼかしを使ってください。
スクリーンショットにもコンソールログとネットワークログは付きますか?
はい。Midge はブラウジング中、直近のコンソールとネットワークの記録をメモリ上に保持しています。そのため、エラーが起きてから撮ったスクリーンショットにも、エラー発生前のログが含まれます。
パスワード欄はスクリーンショットで自動的に隠されますか?
パスワード欄とカード番号欄の自動ぼかしは、タブ録画にだけ適用されます。スクリーンショットでは、共有する前に見られたくない部分をぼかしツールで隠してください。トークンや Cookie など、ログ内の機密情報はどちらの場合も伏せられます。