v0.3.3

API 參考

最後更新


package browser(import path github.com/pardnchiu/go-browser/core)的擷取與生命週期函式,以及所有匯出符號的索引。

Fetch


  1. func Fetch(ctx context.Context, href string, timeout time.Duration, opt *Option) (*Result, error)

以 Chrome 載入 href,並依 opt.Type 選擇的格式回傳內容。
參數說明
ctx取消呼叫中的每個等待點,含 semaphore 與捲動延遲
href必須有 scheme 且 hostname 含 .,否則回 invalid url
timeout大於 0 時每次嘗試的頁面載入各包一層 ctx(不含 SameSession 的 Cookie 擷取與瀏覽器啟動);0 或以下表示不另設期限
opt可為 nil;零值欄位採預設,見 Option 欄位

依 opt 與執行環境選擇 headless 或有頭,僅在回應為 403/429/503 且主機有 GUI 時以有頭重試一次(Fetch 路由)。錯誤為帶 HTTP 類狀態碼的 *Error,或包裝後的一般錯誤(疑難排解)。可在多個 goroutine 同時呼叫,併發由 SetMaxConcurrency 限制。

Close


  1. func Close()

關閉全部快取的瀏覽器實例並清空快取。可重複呼叫;之後的 Fetch 會啟動新實例。

SetMaxConcurrency


  1. func SetMaxConcurrency(n int)

設定所有瀏覽器同時開啟的頁面上限,預設 8。n <= 0 時不做任何事。見 瀏覽器快取。

符號索引


符號種類頁面
Fetch、Close、SetMaxConcurrencyfunc本頁
HTMLToMarkdown、HTMLToNode、Merge、DedupTree、DedupMarkdownParagraphs、InlineTimeElementsfunc內容轉換
Option、Viewport、Result、Error、Node、Browsertype型別
TypeMarkdown、TypeHTML、TypeJSON、DefaultUserAgent、ErrProfileNotFoundconst / var型別

舊版曾存在的符號列於 已移除 API。
EN