Option 欄位

最後更新 2026-10-21

browser.Option 的每個欄位、維持零值時採用的值，以及欄位之間的交互作用。

欄位

欄位	型別	未設定時	說明
`IdleWait`	`time.Duration`	`2s`	每次 settle、`SettleJS` 與 consent 執行的上限；DOM 穩定視窗為 `min(400ms, IdleWait)`
`MaxLength`	`int`	`1048576`（`1 << 20`）	Markdown 輸出截斷到此 byte 數，可能切開多位元組字元；負值停用截斷；`TypeHTML` 與 `TypeJSON` 不套用
`UserAgent`	`string`	`DefaultUserAgent`	同時是瀏覽器快取鍵的一部分
`KeepLinks`	`bool`	`false`	轉換輸出保留連結、圖片與 `nav` / `header` / `footer` / `aside`
`StealthJS`	`string`	內嵌 `stealth.js`	以 `EvalOnNewDocument` 注入；會取代預設值，空字串恢復預設，見反偵測
`SettleJS`	`string`	內嵌 `listener.js`	DOM 穩定後執行一次；空字串恢復預設
`Viewport`	`*Viewport`	`1280 × 960`	`DeviceScaleFactor` 為 0 時視為 1
`SameSession`	`bool`	`false`	以帶本機 Chrome Cookie 的暫存設定檔啟動，見 Cookie 工作階段
`Headless`	`bool`	`false`	強制 headless，不做有頭重試
`Visible`	`bool`	`false`	有 GUI 時直接有頭、不重試；沒有 GUI 時退回 headless 優先。`Headless` 為 true 時忽略，見 Fetch 路由
`Profile`	`string`	`"Default"`	Chrome 設定檔目錄名，僅 `SameSession` 使用
`Type`	`int`	`TypeMarkdown`	`TypeMarkdown`、`TypeHTML` 或 `TypeJSON`，見輸出格式
`ScrollCount`	`int`	`3`	傳負值表示不捲動

Fetch 會先複製 Option 再補預設值，傳入的值不會被修改，可在多次呼叫間重用。

Viewport

type Viewport struct {
	Width             int
	Height            int
	DeviceScaleFactor float64
}

欄位交互作用

組合	效果
`Headless: true` + session 網域	以 headless 為準，忽略 session 網域清單
`Headless: true` + `Visible: true`	以 headless 為準，忽略 `Visible`
`Visible: true` 但沒有 GUI	等同未設定：headless 優先，無法有頭重試
`Headless: true` + `SameSession: true`	在暫存 Cookie 設定檔上跑 headless 瀏覽器
`SameSession: false` + `Profile`	`Profile` 不生效
`ScrollCount: 0`	視為未設定，捲動 3 次；要停用請傳 `-1`
`IdleWait` 小於 400ms	DOM 穩定視窗縮短為 `IdleWait`

範例

result, err := browser.Fetch(ctx, href, 45*time.Second, &browser.Option{
	Type:        browser.TypeMarkdown,
	KeepLinks:   true,
	ScrollCount: 5,
	IdleWait:    3 * time.Second,
	Viewport:    &browser.Viewport{Width: 1440, Height: 2000},
})