API Reference
Last updated
The fetch and lifecycle functions of
package browser, import path github.com/pardnchiu/go-browser/core, with an index of every exported symbol.Fetch
- func Fetch(ctx context.Context, href string, timeout time.Duration, opt *Option) (*Result, error)
Loads
href in Chrome and returns its content in the format chosen by opt.Type.| Parameter | Notes |
|---|---|
ctx | Cancels every wait in the call, including the semaphore and scroll delays |
href | Must have a scheme and a hostname containing ., otherwise invalid url |
timeout | Above 0, wraps ctx for each attempt's page load (not SameSession cookie extraction or browser launch); 0 or below means no extra deadline |
opt | May be nil; zero fields take defaults, see Option Fields |
Picks headless or headed from
opt and the runtime environment, and retries once headed only when the response is 403, 429 or 503 and the host has a GUI (Fetch Routing). Errors are either *Error with an HTTP-like status or a wrapped plain error (Troubleshooting). Safe to call from multiple goroutines; concurrency is capped by SetMaxConcurrency.Close
- func Close()
Closes every cached browser instance and clears the cache. Safe to call more than once; later
Fetch calls launch new instances.SetMaxConcurrency
- func SetMaxConcurrency(n int)
Sets the cap on concurrent pages across all browsers, default 8. Does nothing when
n <= 0. See Browser Cache.Symbol index
| Symbol | Kind | Page |
|---|---|---|
Fetch, Close, SetMaxConcurrency | func | this page |
HTMLToMarkdown, HTMLToNode, Merge, DedupTree, DedupMarkdownParagraphs, InlineTimeElements | func | Content Conversion |
Option, Viewport, Result, Error, Node, Browser | type | Types |
TypeMarkdown, TypeHTML, TypeJSON, DefaultUserAgent, ErrProfileNotFound | const / var | Types |
Symbols that existed in earlier releases are listed on Removed API.