fix golang code

Author: ysmood

browsers-pages.md

@@ -9,6 +9,7 @@ To launch multiple browsers:
 ```go
 browser1 := rod.New().MustConnect()
 browser2 := rod.New().MustConnect()
+fmt.Println(browser1, browser2)
 ```
 
 All APIs are thread-safe, same works for multiple Go routines.
@@ -18,18 +19,20 @@ You can also use incognito mode to launch multiple browsers:
 ```go
 browser1 := rod.New().MustConnect()
 browser2 := browser1.MustIncognito()
+fmt.Println(browser1, browser2)
 ```
 
 Launch browsers with different launch arguments:
 
 ```go
 browser1 := rod.New().ControlURL(
-    launcher.New().Headless(false).MustLaunch()
+    launcher.New().Headless(false).MustLaunch(),
 ).MustConnect()
 
-browser1 := rod.New().ControlURL(
-    launcher.New().UserDataDir("path").MustLaunch()
+browser2 := rod.New().ControlURL(
+    launcher.New().UserDataDir("path").MustLaunch(),
 ).MustConnect()
+fmt.Println(browser1, browser2)
 ```
 
 ## Multiple pages
@@ -40,6 +43,7 @@ To launch multiple pages for a browser:
 browser := rod.New().MustConnect()
 page1 := browser.MustPage("http://a.com")
 page2 := browser.MustPage("http://b.com")
+fmt.Println(page1, page2)
 ```
 
 If a browser already has several pages open and you don't have references to them, you can use [Browser.Pages()](https://pkg.go.dev/github.com/go-rod/rod#Browser.Pages) to get a [Pages](https://pkg.go.dev/github.com/go-rod/rod#Pages) struct which is a list of tabs and/or windows with several helpful methods attached, such as [Pages.Find()](https://pkg.go.dev/github.com/go-rod/rod#Pages.Find), [Pages.FindByURL()](https://pkg.go.dev/github.com/go-rod/rod#Pages.FindByURL), [Pages.First()](https://pkg.go.dev/github.com/go-rod/rod#Pages.First), etc. Once you get a reference to the page you want you can use [Page.Activate()](https://pkg.go.dev/github.com/go-rod/rod#Page.Activate) to focus it. If you are clicking a link opens a new page then you can use [Page.WaitOpen](https://pkg.go.dev/github.com/go-rod/rod#Page.WaitOpen) to grab a reference to the new window as soon as it is launched.

context-and-timeout.md

@@ -82,9 +82,9 @@ err := rod.Try(func() {
     page.Timeout(2 * time.Second).MustNavigate("http://github.com")
 })
 if errors.Is(err, context.DeadlineExceeded) {
-    // code for timeout error
+    fmt.Println("timeout error")
 } else if err != nil {
-    // code for other types of error
+    fmt.Println("other types of error")
 }
 ```
 

custom-launch.md

@@ -133,7 +133,7 @@ You can use the `launcher.NewUserMode` to launch your regular user browser. Rod
 
 ```go
 wsURL := launcher.NewUserMode().MustLaunch()
-browser := rod.New().ControlURL(wsURL).MustConnect().NoDefaultDevice()
+rod.New().ControlURL(wsURL).MustConnect().NoDefaultDevice()
 ```
 
 Here's a more detailed example: [code example](https://github.com/go-rod/rod/blob/master/lib/examples/use-rod-like-chrome-extension/main.go).

emulation.md

@@ -59,16 +59,17 @@ If you want to specify the viewport for a specific page, use [Page.SetViewport](
 You can use the launch env to set for all pages:
 
 ```go
-u := launcher.New().Env("TZ=America/New_York").MustConnect()
-browser := rod.New().ControlURL(u).MustConnect()
+u := launcher.New().Env(append(os.Environ(), "TZ=America/New_York")...).MustLaunch()
+rod.New().ControlURL(u).MustConnect()
 ```
 
 Or you can use [EmulationSetTimezoneOverride](https://pkg.go.dev/github.com/go-rod/rod/lib/proto#EmulationSetTimezoneOverride)
 or [EmulationSetLocaleOverride](https://pkg.go.dev/github.com/go-rod/rod/lib/proto#EmulationSetLocaleOverride)
 to set for a specific page:
 
 ```go
-proto.EmulationSetTimezoneOverride{TimezoneID: "America/New_York"}.Call(page)
+page := browser.MustPage()
+_ = proto.EmulationSetTimezoneOverride{TimezoneID: "America/New_York"}.Call(page)
 ```
 
 ## Permissions
@@ -84,10 +85,11 @@ Use [EmulationSetGeolocationOverride](https://pkg.go.dev/github.com/go-rod/rod/l
 Use [EmulationSetEmulatedMedia](https://pkg.go.dev/github.com/go-rod/rod/lib/proto#EmulationSetEmulatedMedia)
 
 ```go
-proto.EmulationSetEmulatedMedia{
+page := browser.MustPage()
+_ = proto.EmulationSetEmulatedMedia{
     Media: "screen",
     Features: []*proto.EmulationMediaFeature{
-        {"prefers-color-scheme", "dark"},
+        {Name: "prefers-color-scheme", Value: "dark"},
     },
 }.Call(page)
 ```

error-handling.md

@@ -13,11 +13,15 @@ Here's the source code of the `MustElement`, as you can see it just calls the `E
 several extra lines to panic if err is not `nil`:
 
 ```go
-func (p *Page) MustElement(selectors ...string) *Element {
-    el, err := p.Element(selectors...)
-    if err != nil {
-        panic(err)
-    }
+// Page ...
+type Page rod.Page
+
+// MustElement ...
+func (p *Page) MustElement(selector string) *rod.Element {
+	el, err := (*rod.Page)(p).Element(selector)
+	if err != nil {
+		panic(err)
+	}
 	return el
 }
 ```
@@ -33,13 +37,11 @@ page := rod.New().MustConnect().MustPage("https://example.com")
 
 el, err := page.Element("a")
 if err != nil {
-    handleError(err)
-    return
+    panic(err)
 }
 html, err := el.HTML()
 if err != nil {
-    handleError(err)
-    return
+    panic(err)
 }
 fmt.Println(html)
 ```
@@ -53,16 +55,21 @@ page := rod.New().MustConnect().MustPage("https://example.com")
 err := rod.Try(func() {
     fmt.Println(page.MustElement("a").MustHTML())
 })
-handleError(err)
+panic(err)
 ```
 
 ## Check the error type
 
 We use Go's standard way to check error types, no magic.
 
-The `handleError` in the above code may look like:
+Replace the `panic` in the above code with `handleError`:
 
 ```go
+func main() {
+    _, err := page.Element("a")
+    handleError(err)
+}
+
 func handleError(err error) {
     var evalErr *rod.ErrEval
     if errors.Is(err, context.DeadlineExceeded) { // timeout error

input.md

@@ -11,7 +11,7 @@ To simulate the mouse click an element:
 page.MustElement("button").MustClick()
 
 // right click
-page.MustElement("button").Click(proto.InputMouseButtonRight)
+_ = page.MustElement("button").Click(proto.InputMouseButtonRight)
 ```
 
 ## Text input
@@ -94,18 +94,18 @@ page.MustElement("select").MustSelect("B", "C")
 You can also use regex or css selector to select options:
 
 ```go
-page.MustElement("select").Select([]string{`^B$`}, true, rod.SelectorTypeRegex)
+_ = page.MustElement("select").Select([]string{`^B$`}, true, rod.SelectorTypeRegex)
 
 // set false to deselect
-page.MustElement("select").Select([]string{`[value="c"]`}, false, rod.SelectorTypeCSSSector)
+_ = page.MustElement("select").Select([]string{`[value="c"]`}, false, rod.SelectorTypeCSSSector)
 ```
 
 ## Set files
 
 Use `SetFiles` to set files for the [file input](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file):
 
 ```go
-pag.MustElement(`[type=file]`).MustSetFiles("a.jpg", "b.pdf")
+page.MustElement(`[type=file]`).MustSetFiles("a.jpg", "b.pdf")
 ```
 
 ## Mouse, keyboard, and touch

javascript-runtime.md

@@ -54,6 +54,7 @@ Now the page can invoke this method on the window object:
 
 ```go
 hash := page.MustEval(`() => window.md5("test")`).Str()
+fmt.Println(hash)
 ```
 
 Here's another example to get button click event on the page:

network.md

@@ -47,7 +47,7 @@ You can throttle the network to simulate and test the slow network effect on you
 ```go
 page.EnableDomain(proto.NetworkEnable{})
 
-proto.NetworkEmulateNetworkConditions{
+_ = proto.NetworkEmulateNetworkConditions{
     Offline:            false,
     Latency:            300,
     DownloadThroughput: 100,

page-resources/README.md

@@ -7,7 +7,8 @@ You can use the `Page.GetResource` method to get files from here:
 Such as get an image:
 
 ```go
-bin, err := page.GetResource("https://test.com/a.png")
+bin, _ := page.GetResource("https://test.com/a.png")
+fmt.Println(bin)
 ```
 
 ## Element resource
@@ -17,4 +18,5 @@ Such as for element `<img src="a.jpg">`, you can use code like this to get the `
 
 ```go
 bin := page.MustElement("img").MustResource()
+fmt.Println(bin)
 ```

selectors/README.md

@@ -135,10 +135,10 @@ func main() {
 
 	if page.MustHas(".nav-user-icon-base") {
 		// print the username after successful login
-		fmt.Println(*el.MustAttribute("title"))
+		fmt.Println(page.MustElement(".nav-user-icon-base").MustAttribute("title"))
 	} else if page.MustHas("[data-cy=sign-in-error]") {
 		// when wrong username or password
-		fmt.Println(el.MustText())
+		fmt.Println(page.MustElement("[data-cy=sign-in-error]").MustText())
 	}
 }
 ```
@@ -155,7 +155,7 @@ func main() {
 	// It will keep polling until one selector has found a match
 	page.Race().Element(".nav-user-icon-base").MustHandle(func(e *rod.Element) {
 		// print the username after successful login
-		fmt.Println(*e.MustAttribute("title"))
+		fmt.Println(e.MustAttribute("title"))
 	}).Element("[data-cy=sign-in-error]").MustHandle(func(e *rod.Element) {
 		// when wrong username or password
 		panic(e.MustText())