API 參考
最後更新
package browser(import path github.com/pardnchiu/go-browser/core)的擷取與生命週期函式,以及所有匯出符號的索引。Fetch
- 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
- func Close()
關閉全部快取的瀏覽器實例並清空快取。可重複呼叫;之後的
Fetch 會啟動新實例。SetMaxConcurrency
- func SetMaxConcurrency(n int)
設定所有瀏覽器同時開啟的頁面上限,預設 8。
n <= 0 時不做任何事。見 瀏覽器快取。符號索引
| 符號 | 種類 | 頁面 |
|---|---|---|
Fetch、Close、SetMaxConcurrency | func | 本頁 |
HTMLToMarkdown、HTMLToNode、Merge、DedupTree、DedupMarkdownParagraphs、InlineTimeElements | func | 內容轉換 |
Option、Viewport、Result、Error、Node、Browser | type | 型別 |
TypeMarkdown、TypeHTML、TypeJSON、DefaultUserAgent、ErrProfileNotFound | const / var | 型別 |
舊版曾存在的符號列於 已移除 API。