add examples

Author: bringmetheaugust

README.md

@@ -9,14 +9,16 @@
 <p align="center">
     <a href="https://pkg.go.dev/github.com/bringmetheaugust/goDOM"><img src="https://pkg.go.dev/badge/github.com/stretchr/testify" alt="Doc reference"></a>
     <a href="https://lh3.googleusercontent.com/proxy/w2a-pc4X9z2kuDWoXKnSF8pY6ngZvjVuZOAXMz3ZR8NwaUj9a-KsJnpcjtUSRO9QtFV6vMb3YoHWWv6k43Cb6bHOJEka19uE54GWtVx7Lru8gi10I_968eA2thkA0dL1O-zA8WT24cI"><img src="https://img.shields.io/badge/go%20version-1.21.5-61CFDD.svg?style=flat-square" alt="Golang version"></a>
-    <a href="https://cs4.pikabu.ru/post_img/big/2014/12/15/4/1418619408_1209550583.jpg"><img src="https://img.shields.io/badge/version-0.1.9-blue" alt="project version"></a>
+    <a href="https://cs4.pikabu.ru/post_img/big/2014/12/15/4/1418619408_1209550583.jpg"><img src="https://img.shields.io/badge/version-0.2.1-blue" alt="project version"></a>
 </p>
 
 Made by front-ender for front-enders.   
 Package provide method to parse HTML and get browser-like [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Introduction#what_is_the_dom) and DOM API.  
 It's only for reading DOM, searching elements and getting their data.
 Doesn't have methods to mutate DOM.
 
+⚠️Before using it You should remember that sites can detect You as a bot and return unexpected HTML response.
+
 ## Installation
 
     go get github.com/bringmetheaugust/goDOM
@@ -55,6 +57,8 @@ func main() {
     }
 ```
 
+#### More real examples [here](./examples/).
+
 ## Docs
 
 ### Document

examples/stackOverflowPosts.go

@@ -0,0 +1,44 @@
+package main
+
+import (
+	"fmt"
+	"io"
+	"net/http"
+
+	goDom "github.com/bringmetheaugust/goDOM"
+)
+
+func main() {
+	r, err := http.Get("https://stackoverflow.com")
+
+	if err != nil || r.StatusCode >= 400 {
+		fmt.Printf("Cann't get site: %d", err)
+		return
+	}
+
+	defer r.Body.Close()
+
+	bytes, _ := io.ReadAll(r.Body)
+	document, _ := goDom.Create(bytes) // create document
+
+	// find DOM elements as posts (.s-post-summary) and get their link elements (.s-post-summary--content-title a)
+	posts, err := document.QuerySelectorAll(".s-post-summary .s-post-summary--content-title a")
+
+	// ! Remember that sites can detect You as a bot and return unexpected HTML response
+	if err != nil {
+		fmt.Println("Ooops, posts not found.")
+		return
+	}
+
+	// loop link elements (HTMLAnchorElement)
+	for _, c := range posts {
+		attr, err := c.GetAttribute("href") // get href attribute
+
+		if err != nil {
+			fmt.Println("Ooops, href not found.")
+			return
+		}
+
+		fmt.Println(attr)
+	}
+}