HTTP インターセプト

Guida は WebView2 ブラウザーの通信を調べるためのネットワーク機能を持っています。スクリプトでは g.network.* で記録済みリクエストを検索し、g.intercept.* でインターセプトを有効化できます。

通信を検索する

g.network.search() は、記録済みリクエストを URL、メソッド、ステータス、時刻などで絞り込むために使います。

const traffic = g.network.search(null, {
  urlContains: "/api/",
  limit: 20,
});

for (const entry of traffic) {
  g.log(entry.method + " " + entry.url);
}

特定の通信を待つ場合は g.network.waitForRequest() を使います。

const entry = await g.network.waitForRequest("*/api/*");
g.log("検出: " + entry.url);

インターセプトルール

g.intercept.enable() でインターセプトを有効にし、g.intercept.addRule() で条件を追加します。ルールに一致したリクエストは、続行、応答、または中断できます。

g.intercept.enable();
g.intercept.addRule({
  urlPattern: "*://example.com/api/*",
  action: "capture",
});

用途

API 呼び出しの確認
ページが本当にどのデータを取得しているかの調査
AI エージェントが行ったブラウザー操作の証跡収集
キュー処理中の失敗原因の切り分け