Chrome DevTools の [Issues] タブの作成方法

Jan Scheffler
Jan Scheffler
Sigurd Schneider
Sigurd Schneider

2019 年第 4 四半期、Chrome DevTools チームは、Cookie に関する DevTools のデベロッパー エクスペリエンスの改善に着手しました。Google Chrome などのブラウザが Cookie のデフォルトの動作を変更し始めていたため、これは特に重要でした。

DevTools にすでに用意されているツールを調査する際に、次のような状況に直面することがよくありました。

コンソール パネルの問題

📲? コンソールには警告やエラー メッセージがたくさんあり、技術的な説明だけでなく、chromestatus.com へのリンクも含まれていました。どのメッセージもほぼ同じくらい重要だと考えられ、最初に何に対処すればよいかを判断するのが難しかったのです。さらに重要なのは、テキストが DevTools 内の追加情報にリンクしていないため、何が起こったかを理解するのが難しかったことです。そして最後に、多くの場合、メッセージは完全にウェブ デベロッパーに送られ、問題の解決方法を見つけたり、技術的なコンテキストを把握したりすることさえあります。

独自のアプリケーションからのメッセージにもコンソールを使用している場合、ブラウザからのすべてのメッセージの中から目的のメッセージを探すのが難しいことがあります。

人間だけでなく、自動プロセスでもコンソール メッセージに対応することは困難です。たとえば、デベロッパーは継続的インテグレーション/継続的デプロイのシナリオで Chrome Headless と Puppeteer を使用できます。コンソール メッセージは単なる文字列であるため、デベロッパーは正規表現やその他のパーサーを記述して、対処可能な情報を抽出する必要があります。

解決策: 構造化された実用的な問題レポート

発見した問題に対するより良い解決策を見つけるために、まず要件を検討し、それらを設計ドキュメントにまとめました。

Google の目標は、問題の内容修正方法を明確に説明して問題を提示することです。 設計プロセスから、各問題には次の 4 つの部分が含まれていることがわかりました。

  • タイトル
  • 説明
  • DevTools 内の影響を受けるリソースへのリンク
  • および詳細なガイダンスへのリンク

タイトルは、デベロッパーが根本的な問題を理解できるように、短く簡潔にします。また、多くの場合、修正のヒントも含めます。たとえば、Cookie の問題は次のように簡素化されます。

クロスサイト Cookie を「Secure」としてマークし、クロスサイト コンテキストで設定できるようにする

すべての問題の説明には、事象の詳細の説明、修正方法に関する実用的なアドバイス、状況に応じて問題を理解するための DevTools 内の他のパネルへのリンクが記載されています。また、ウェブ デベロッパーがトピックについて詳しく学べるように、web.dev の詳細な記事へのリンクも提供しています。

各問題の重要な部分は、影響を受けるリソースセクションです。このセクションには DevTools の他の部分へのリンクが含まれているため、詳細な調査が容易です。たとえば、Cookie の問題の場合、問題を引き起こしたネットワーク リクエストのリストが表示されます。リクエストをクリックすると、ネットワーク パネルに直接移動します。これにより、便利になるだけでなく、特定の問題のデバッグに使用できる DevTools 内のパネルとツールを把握しやすくなります。

デベロッパーが [問題] タブを長期的にどのように使用するかについて、Google は次のような進化を想定しています。

  • ウェブ デベロッパーが特定の問題に初めて遭遇したとき、記事を読むことで問題を詳しく理解します。
  • 問題が 2 回目に発生したときに、問題の説明でデベロッパーが問題の内容を思い出し、すぐに調査して解決に向けて行動できるようにすることを目的としています。
  • 問題が何度か発生した場合は、デベロッパーが問題の種類を認識するのに問題のタイトルが十分であることを願っています。

改善を図ったもう 1 つの重要な点は、集計です。たとえば、同じ Cookie が原因で同じ問題が複数回発生した場合、その Cookie は 1 回だけ報告するようにしました。これにより、メッセージの数を大幅に減らすだけでなく、問題の根本原因をより迅速に特定できるようになります。

集計された問題

実装

チームはこれらの要件を念頭に置き、新機能の実装方法を検討し始めました。Chrome DevTools のプロジェクトは通常、次の 3 つの領域にまたがっています。

実装は次の 3 つのタスクで構成されました。

  • Chromium では、表示する情報を含むコンポーネントを特定し、速度やセキュリティを損なうことなく、その情報に DevTools プロトコルがアクセスできるようにする必要がありました。
  • 次に、DevTools フロントエンドなどのクライアントに情報を公開する API を定義するために、Chrome DevTools Protocol(CDP)を設計する必要がありました。
  • 最後に、DevTools フロントエンドにコンポーネントを実装して、CDP を介してブラウザから情報をリクエストし、デベロッパーが情報を簡単に解釈して操作できるように適切な UI に表示する必要がありました。

ブラウザ側では、まずコンソール メッセージの処理方法を調べました。その動作は、問題の想定内容と非常によく似ているためです。通常、このような探索の開始点として CodeSearch が適しています。Chromium プロジェクトのソースコード全体をオンラインで検索して確認できます。これにより、コンソール メッセージの実装について学び、問題について収集した要件に基づいて並列かつより構造化された方法で構築できました。

セキュリティへの影響を常に念頭に置かなければならないため、この作業は特に困難です。Chromium プロジェクトでは、情報漏洩を防ぐために、さまざまな要素を異なるプロセスに分離し、制御された通信チャネルを介してのみ通信するようにしています。問題には機密情報が含まれている可能性があるため、その情報を知るべきでないブラウザの部分に送信しないように注意する必要があります。

DevTools フロントエンド

DevTools 自体は、JavaScript と CSS で記述されたウェブ アプリケーションです。他の多くのウェブ アプリケーションとよく似ていますが、10 年以上前から存在している点が異なります。もちろん、バックエンドは基本的にブラウザへの直接通信チャネル(Chrome DevTools Protocol)です。

[問題] タブでは、まずユーザー ストーリーと、問題を解決するために開発者が行う必要があることを考えました。主なアイデアは、調査の中心となる [問題] タブから、より詳細な情報を表示するパネルにユーザーを誘導することです。デベロッパーがネットワーク パネルやアプリケーション パネルなどの他の DevTools コンポーネントを操作している間も [Issues] タブを開いたままにできるように、[Issues] タブを他のタブとともに DevTools の下部に配置しました。

それを念頭に置いて、UX デザイナーは Google の目標を理解し、以下の初期案のプロトタイプを作成しました。

プロトタイプ

最善のソリューションについて多くの議論を重ねた後、設計の実装を開始し、決定事項を繰り返しながら、現在の [問題] タブの形に徐々に近づけていきました。

もう 1 つの重要な要素は、[問題] タブの見つけやすさです。これまで、DevTools の優れた機能の多くは、デベロッパーが具体的に何を探すべきかを知らないと見つけることができませんでした。[問題] タブでは、開発者が重要な問題を見逃さないように、複数の異なる領域の問題をハイライト表示することにしました。

問題を優先して一部のコンソール メッセージが削除されたため、コンソール パネルに通知を追加することにしました。また、DevTools ウィンドウの右上にある警告とエラーのカウンタにアイコンを追加しました。

問題に関する通知

最後に、[問題] タブは他の DevTools パネルにリンクするだけでなく、問題に関連するリソースも [問題] タブにリンクします。

関連する問題

プロトコル

フロントエンドとバックエンド間の通信は、Chromium DevTools Protocol(CDP)と呼ばれるプロトコル経由で動作します。CDP は、ウェブアプリのバックエンド(Chrome DevTools)と考えることができます。CDP は複数のドメインに分割され、各ドメインには多数のコマンドとイベントが含まれています。

[問題] タブでは、新しい問題が発生するたびにトリガーされる新しいイベントを監査ドメインに追加しました。DevTools がまだ開いていない間に発生した問題も報告できるように、Audits ドメインは最新の問題を保存し、DevTools が接続するとすぐに送信します。DevTools は、これらの問題をすべて収集して集約します。

CDP を使用すると、Puppeteer などの他のプロトコル クライアントも問題を受信して処理できます。CDP 経由で送信される構造化された問題情報により、既存の継続的インテグレーション インフラストラクチャへの統合が容易になります。これにより、ページがデプロイされる前に問題を検出して修正できます。

将来

まず、コンソールから [問題] タブに移動するメッセージがさらに増えます。新しい問題を追加するたびに、明確で実用的なドキュメントを提供したいと考えているため、この作業には時間がかかります。今後は、デベロッパーの皆様がコンソールではなく [問題] タブで問題を探すようになっていただけると幸いです。

さらに、Chromium バックエンド以外のソースの問題を [問題] タブに統合する方法も検討しています。

Google では、[問題] タブを整理し、使い勝手を改善する方法を検討しています。今年は、検索、フィルタ、集計の改善に取り組んでいきます。報告される問題の増加に対応するため、問題カテゴリを導入する予定です。これにより、今後の非推奨に関する問題のみを表示できるようになります。また、開発者が問題を一時的に非表示にできるスヌーズ機能の追加も検討しています。

問題に対処できるように、ページのどの部分で問題が発生したかを簡単に見つけられるようにします。特に Google は、ページ自体(つまり自社)の問題と、埋め込んだリソースによって引き起こされたものの直接管理できない問題(広告ネットワークなど)を区別してフィルタする方法を検討しています。最初のステップとして、Chrome 86 ではサードパーティ Cookie の問題を非表示にできるようになります。

[問題] タブを改善するためのご提案がありましたら、バグでお知らせください。

プレビュー チャネルをダウンロードする

デフォルトの開発ブラウザとして Chrome の CanaryDev、または Beta を使用することを検討してください。これらのプレビュー チャンネルでは、最新の DevTools 機能にアクセスしたり、最先端のウェブ プラットフォーム API をテストしたりできます。また、ユーザーよりも早くサイトの問題を見つけることもできます。

Chrome DevTools チームに問い合わせる

次のオプションを使用して、DevTools の新機能、更新、その他のトピックについて話し合います。