ブラウザーと DOM

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

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

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

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

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

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 インターセプトも参照してください。