1 files changed, 96 insertions, 0 deletions
diff --git a/lib/html/example_node_iterator_test.go b/lib/html/example_node_iterator_test.go
new file mode 100644
index 00000000..94ece050
--- /dev/null
+++ b/lib/html/example_node_iterator_test.go
@@ -0,0 +1,96 @@
+// Copyright 2020, Shulhan <ms@kilabit.info>. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package html
+
+import (
+	"fmt"
+	"log"
+	"strings"
+)
+
+func ExampleParse() {
+	rawHTML := `
+<ul>
+	<li>
+		<b>item</b>
+		<span>one</span>
+	</li>
+</ul>
+`
+
+	r := strings.NewReader(rawHTML)
+
+	iter, err := Parse(r)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	for node := iter.Next(); node != nil; node = iter.Next() {
+		if node.IsElement() {
+			fmt.Printf("%s\n", node.Data)
+		} else {
+			fmt.Printf("\t%s\n", node.Data)
+		}
+	}
+
+	// Output:
+	// html
+	// head
+	// body
+	// ul
+	// li
+	// b
+	// 	item
+	// b
+	// span
+	// 	one
+	// span
+	// li
+	// ul
+	// body
+	// html
+}
+
+func ExampleNodeIterator_SetNext() {
+	rawHTML := `
+<ul>
+	<li>
+		<b>item</b>
+		<span>one</span>
+	</li>
+</ul>
+<h2>Jump here</h2>
+`
+
+	r := strings.NewReader(rawHTML)
+
+	iter, err := Parse(r)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	for node := iter.Next(); node != nil; node = iter.Next() {
+		if node.IsElement() {
+			if node.Data == "ul" {
+				// Skip iterating the "ul" element.
+				iter.SetNext(node.GetNextSibling())
+				continue
+			}
+			fmt.Printf("%s\n", node.Data)
+		} else {
+			fmt.Printf("\t%s\n", node.Data)
+		}
+	}
+
+	// Output:
+	// html
+	// head
+	// body
+	// h2
+	// 	Jump here
+	// h2
+	// body
+	// html
+}