브라우저와 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 결과 컨테이너를 처리하고 브라우저 쪽 코드가 반환한 객체, 배열, primitive 값을 스크립트로 돌려줍니다.

문서 프로필은 노드 수, 깊이, 표시 텍스트와 제목 길이, 시맨틱 요소 수, 적용된 한도, 잘림 정보를 제공합니다. 시각 프로필에는 탐색 결과의 navigationId와 예상 뷰포트 크기가 필요합니다. 두 API 모두 중립적인 측정값을 반환합니다. 화면이 거의 흰색이거나 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 가로채기도 참조하세요.