ブラウザーと DOM

このページは、ブラウザータブ、ページ、DOM、スクリーンショット、ネットワークに関する g.* API の入口です。

g.nav.* - ナビゲーション

メソッド	説明
g.nav.navigateToUrl	現在のタブを指定 URL へ移動します
g.nav.blockRedirects	リダイレクトをブロックします
g.nav.allowRedirects	リダイレクトを再度許可します

const nav = await g.nav.navigateToUrl("https://example.com");
await g.dom.waitForDomStable();

g.nav.navigateToUrl() は、Guida が実際に観測した WebView2 の情報だけを返します。主な項目は started、completionObserved、 contentLoadingObserved、navigationSucceeded、statusCode、 statusSource、webErrorStatus、finalUrl、navigationId、 redirectDetected、metaRefresh です。観測できなかった値は null です。waitForLoad: false の場合、完了、HTTP ステータス、成功かどうかは不明のままであり、結果に HTTP レスポンスヘッダーは含まれません。

g.tabs.* - タブ

メソッド	説明
g.tabs.getTabs	開いているブラウザータブを一覧します
g.tabs.newBrowserTab	新しいブラウザータブを作成します
g.tabs.setActiveBrowserTab	アクティブタブを切り替えます
g.tabs.closeTab	タブを閉じます

g.page.* - ページ情報と実行

メソッド	説明
g.page.getUrl	現在の URL を取得します
g.page.getDom	現在の DOM HTML を取得します
g.page.executeJS	ページ文脈で JavaScript を実行します
g.page.ocr	ページ領域に OCR を実行します
g.page.profileDocument	上限付きで文書構造と正確な SHA-256 ダイジェストを測定します
g.page.profileVisual	指定ナビゲーションとビューポートを上限付きの視覚指標で測定します
g.page.compareVisualProfiles	互換性のある視覚プロファイルを比較します

g.page.executeJS() は WebView2 の結果コンテナーを処理し、ブラウザー側コードが返したオブジェクト、配列、プリミティブ値をスクリプトへ戻します。

文書プロファイルには、ノード数、深さ、表示テキストとタイトルの長さ、セマンティック要素数、適用上限、打ち切り情報が含まれます。視覚プロファイルには、ナビゲーション結果の navigationId と想定ビューポートサイズが必要です。いずれも中立的な測定値であり、白に近い画面、小さな DOM、大きな比較距離だけで、ページが正常、ブロック済み、不正であるとは判定しません。まず打ち切りと互換性診断を確認し、その後で用途に応じた限定的な判定規則を適用してください。

g.dom.* - DOM 操作

メソッド	説明
g.dom.waitForDomStable	DOM が落ち着くまで待機します
g.dom.getElements	複数要素からプロパティを取得します
g.dom.click	要素をクリックします
g.dom.enterText	入力欄へテキストを入力します
g.dom.selectOption	select 要素の選択肢を選びます
g.dom.pressKey	キー入力を送ります

const products = await g.dom.getElements(".product", ["innerText", "data-price"]);
for (const product of products) {
  g.store.put("products", product.innerText, product);
}

g.screenshot.* - スクリーンショット

メソッド	説明
g.screenshot.screenshot	現在のビューポートを撮影します
g.screenshot.screenshotElement	指定要素を撮影します
g.screenshot.screenshotFullPage	ページ全体を撮影します

スクリーンショットは、AI 支援調査やワークフロー証跡として役立ちます。

g.network.* - ネットワーク

メソッド	説明
g.network.search	記録済みネットワークリクエストを検索します
g.network.getById	リクエスト ID から詳細を取得します
g.network.waitForRequest	条件に合うリクエストを待機します

HTTP 通信を調べるときは、HTTP インターセプトも参照してください。