From c3272519a17010908cf176e17b37176e92a65665 Mon Sep 17 00:00:00 2001
From: Tony Bai <bigwhite.cn@aliyun.com>
Date: Fri, 24 Mar 2023 22:44:32 +0800
Subject: [PATCH] add examples for automated-testing

---
 automated-testing/.DS_Store                   | Bin 0 -> 6148 bytes
 automated-testing/Makefile                    |   9 +
 automated-testing/go.mod                      |  10 +
 automated-testing/go.sum                      |  14 +
 .../scenarios/connection/connect_test.go      |  28 ++
 .../scenarios/connection/scenario_test.go     |  36 ++
 .../scenarios/publish/publish_test.go         |  22 +
 .../scenarios/publish/scenario_test.go        |  36 ++
 automated-testing/scenarios/scenarios.go      |  23 +
 .../scenarios/subscribe/scenario_test.go      |  36 ++
 .../scenarios/subscribe/subscribe_test.go     |  62 +++
 automated-testing/test_report.html            | 468 ++++++++++++++++++
 12 files changed, 744 insertions(+)
 create mode 100644 automated-testing/.DS_Store
 create mode 100644 automated-testing/Makefile
 create mode 100644 automated-testing/go.mod
 create mode 100644 automated-testing/go.sum
 create mode 100644 automated-testing/scenarios/connection/connect_test.go
 create mode 100644 automated-testing/scenarios/connection/scenario_test.go
 create mode 100644 automated-testing/scenarios/publish/publish_test.go
 create mode 100644 automated-testing/scenarios/publish/scenario_test.go
 create mode 100644 automated-testing/scenarios/scenarios.go
 create mode 100644 automated-testing/scenarios/subscribe/scenario_test.go
 create mode 100644 automated-testing/scenarios/subscribe/subscribe_test.go
 create mode 100644 automated-testing/test_report.html

diff --git a/automated-testing/.DS_Store b/automated-testing/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..9d534fa8ce8a9225483a5596f6e0454ad819c528
GIT binary patch
literal 6148
zcmeHKK~4fO6nzCEs0)c3bvH{ll9;$NCL@7`iEi`&ii&6iLBPc2Y`lY4FdoLkcmRF>
zx4~%<-5EprllIMY-s^84ohb!i>JOLOKovlRMX<EQ>YI?~Ql_HdT2_cg`)Ff?F}5&7
zdx{+!q65)^|K@<ayQ}D+&$o8WxAyD(9k6Z4wi*VwL+7B|zc}yq&&lV<qVPuC{Ls)T
zEodJ#^r*V@x!9e-9pM4Jfcp|~%j~g*8;+nR8GLqeFJM=2MD{J`aYaoRZJ%$}0)CnN
zd(Kg2*};y_F1`lr<s4f^Bz_Gs@KvRaA5>$yBcr>+$XBUH&pAJ<lU#@7KWe6$`tWU5
zh;P5^XXaOD^7;k->MhQ0B$@rOnx`PwB976-J{lZzlTP-+6`+dzYALhd7I_2tjY2QX
zd(eMXotBk(syoZq%DiS<58YsVqR(ern&@T4-Pk){Q)mSm-p+k+&z7hxTa0ydAUY5o
zm^dKchlE8ib(mSyPX{YK0uW1V*5I|AB}9`rOdVzx`GjGtlxU^K9WjiRvpsRV)L~}P
z%3<8$!??`GoluNsXa9-PVN#2+jt)czd<Tm5wkrF7bN2b)7sb2iKy+ZP95AKENu$mw
zxxIC2a<bPZEN3hd!pkhGgq7Ql^+LAdbruaiOXPx>I?ODxg%SS<s131-4*aPDpP}#H
AdH?_b

literal 0
HcmV?d00001

diff --git a/automated-testing/Makefile b/automated-testing/Makefile
new file mode 100644
index 00000000..ac0123f2
--- /dev/null
+++ b/automated-testing/Makefile
@@ -0,0 +1,9 @@
+broker_addr=localhost:30083
+
+all:
+	go test ./... -addr $(broker_addr) -json|go-test-report 
+
+clean:
+	rm -fr test_report.html
+
+
diff --git a/automated-testing/go.mod b/automated-testing/go.mod
new file mode 100644
index 00000000..dcbe7130
--- /dev/null
+++ b/automated-testing/go.mod
@@ -0,0 +1,10 @@
+module bigwhite/autotester
+
+go 1.18
+
+require (
+	github.com/eclipse/paho.mqtt.golang v1.4.2 // indirect
+	github.com/gorilla/websocket v1.4.2 // indirect
+	golang.org/x/net v0.0.0-20200425230154-ff2c4b7c35a0 // indirect
+	golang.org/x/sync v0.0.0-20210220032951-036812b2e83c // indirect
+)
diff --git a/automated-testing/go.sum b/automated-testing/go.sum
new file mode 100644
index 00000000..e7f9a64d
--- /dev/null
+++ b/automated-testing/go.sum
@@ -0,0 +1,14 @@
+github.com/antlr/antlr4/runtime/Go/antlr v0.0.0-20220418222510-f25a4f6275ed h1:ue9pVfIcP+QMEjfgo/Ez4ZjNZfonGgR6NgjMaJMu1Cg=
+github.com/antlr/antlr4/runtime/Go/antlr v0.0.0-20220418222510-f25a4f6275ed/go.mod h1:F7bn7fEU90QkQ3tnmaTx3LTKLEDqnwWODIYppRQ5hnY=
+github.com/eclipse/paho.mqtt.golang v1.4.2 h1:66wOzfUHSSI1zamx7jR6yMEI5EuHnT1G6rNA5PM12m4=
+github.com/eclipse/paho.mqtt.golang v1.4.2/go.mod h1:JGt0RsEwEX+Xa/agj90YJ9d9DH2b7upDZMK9HRbFvCA=
+github.com/gorilla/websocket v1.4.2 h1:+/TMaTYc4QFitKJxsQ7Yye35DkWvkdLcvGKqM+x0Ufc=
+github.com/gorilla/websocket v1.4.2/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/net v0.0.0-20200425230154-ff2c4b7c35a0 h1:Jcxah/M+oLZ/R4/z5RzfPzGbPXnVDPkEDtf2JnuxN+U=
+golang.org/x/net v0.0.0-20200425230154-ff2c4b7c35a0/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A=
+golang.org/x/sync v0.0.0-20210220032951-036812b2e83c h1:5KslGYwFpkhGh+Q16bwMP3cOontH8FOep7tGV86Y7SQ=
+golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
diff --git a/automated-testing/scenarios/connection/connect_test.go b/automated-testing/scenarios/connection/connect_test.go
new file mode 100644
index 00000000..14767352
--- /dev/null
+++ b/automated-testing/scenarios/connection/connect_test.go
@@ -0,0 +1,28 @@
+package connection
+
+import (
+	"testing"
+
+	mqtt "github.com/eclipse/paho.mqtt.golang"
+)
+
+func Test_Connection_S0001_ConnectOKWithoutAuth(t *testing.T) {
+	opts := mqtt.NewClientOptions()
+	opts.AddBroker("tcp://" + addr)
+
+	// Create and start MQTT client
+	client := mqtt.NewClient(opts)
+	token := client.Connect()
+	token.Wait()
+
+	// Check if connection was successful
+	if token.Error() != nil {
+		t.Errorf("want ok, got %v", token.Error())
+		return
+	}
+	client.Disconnect(0)
+}
+
+func Test_Connection_S0002_ConnectOKWithAuth(t *testing.T) {
+	//... ...
+}
diff --git a/automated-testing/scenarios/connection/scenario_test.go b/automated-testing/scenarios/connection/scenario_test.go
new file mode 100644
index 00000000..b6cc5de5
--- /dev/null
+++ b/automated-testing/scenarios/connection/scenario_test.go
@@ -0,0 +1,36 @@
+package connection
+
+import (
+	"flag"
+	"log"
+	"os"
+	"testing"
+
+	mqtt "github.com/eclipse/paho.mqtt.golang"
+)
+
+var addr string
+
+func init() {
+	flag.StringVar(&addr, "addr", "", "the broker address(ip:port)")
+}
+
+func TestMain(m *testing.M) {
+	flag.Parse()
+
+	// setup for this scenario
+	mqtt.ERROR = log.New(os.Stdout, "[ERROR] ", 0)
+	/*
+	   mqtt.CRITICAL = log.New(os.Stdout, "[CRIT] ", 0)
+	   mqtt.WARN = log.New(os.Stdout, "[WARN]  ", 0)
+	   mqtt.DEBUG = log.New(os.Stdout, "[DEBUG] ", 0)
+	*/
+
+	// run this scenario test
+	r := m.Run()
+
+	// teardown for this scenario
+	// tbd if teardown is needed
+
+	os.Exit(r)
+}
diff --git a/automated-testing/scenarios/publish/publish_test.go b/automated-testing/scenarios/publish/publish_test.go
new file mode 100644
index 00000000..4e439d88
--- /dev/null
+++ b/automated-testing/scenarios/publish/publish_test.go
@@ -0,0 +1,22 @@
+package publish
+
+import (
+	scenarios "bigwhite/autotester/scenarios"
+	"testing"
+)
+
+func Test_Publish_S0001_PublishOK(t *testing.T) {
+	client, testCaseTeardown, err := scenarios.TestCaseSetup(addr, nil)
+	if err != nil {
+		t.Errorf("want ok, got %v", err)
+		return
+	}
+	defer testCaseTeardown()
+
+	//TBD:xxx
+	_ = client
+	_ = err
+}
+
+func Test_Publish_S0002_PublishFail(t *testing.T) {
+}
diff --git a/automated-testing/scenarios/publish/scenario_test.go b/automated-testing/scenarios/publish/scenario_test.go
new file mode 100644
index 00000000..8cd6e116
--- /dev/null
+++ b/automated-testing/scenarios/publish/scenario_test.go
@@ -0,0 +1,36 @@
+package publish
+
+import (
+	"flag"
+	"log"
+	"os"
+	"testing"
+
+	mqtt "github.com/eclipse/paho.mqtt.golang"
+)
+
+var addr string
+
+func init() {
+	flag.StringVar(&addr, "addr", "", "the broker address(ip:port)")
+}
+
+func TestMain(m *testing.M) {
+	flag.Parse()
+
+	// setup for this scenario
+	mqtt.ERROR = log.New(os.Stdout, "[ERROR] ", 0)
+	/*
+	   mqtt.CRITICAL = log.New(os.Stdout, "[CRIT] ", 0)
+	   mqtt.WARN = log.New(os.Stdout, "[WARN]  ", 0)
+	   mqtt.DEBUG = log.New(os.Stdout, "[DEBUG] ", 0)
+	*/
+
+	// run this scenario test
+	r := m.Run()
+
+	// teardown for this scenario
+	// tbd if teardown is needed
+
+	os.Exit(r)
+}
diff --git a/automated-testing/scenarios/scenarios.go b/automated-testing/scenarios/scenarios.go
new file mode 100644
index 00000000..bd8ab5f0
--- /dev/null
+++ b/automated-testing/scenarios/scenarios.go
@@ -0,0 +1,23 @@
+package scenarios
+
+import (
+	mqtt "github.com/eclipse/paho.mqtt.golang"
+)
+
+func TestCaseSetup(addr string, opts *mqtt.ClientOptions) (client mqtt.Client, testCaseTeardown func(), err error) {
+	if opts == nil {
+		opts = mqtt.NewClientOptions()
+	}
+	opts.AddBroker("tcp://" + addr)
+
+	// Create and start MQTT client
+	client = mqtt.NewClient(opts)
+	token := client.Connect()
+	token.Wait()
+
+	err = token.Error()
+	testCaseTeardown = func() {
+		client.Disconnect(0)
+	}
+	return
+}
diff --git a/automated-testing/scenarios/subscribe/scenario_test.go b/automated-testing/scenarios/subscribe/scenario_test.go
new file mode 100644
index 00000000..69b659e8
--- /dev/null
+++ b/automated-testing/scenarios/subscribe/scenario_test.go
@@ -0,0 +1,36 @@
+package subscribe
+
+import (
+	"flag"
+	"log"
+	"os"
+	"testing"
+
+	mqtt "github.com/eclipse/paho.mqtt.golang"
+)
+
+var addr string
+
+func init() {
+	flag.StringVar(&addr, "addr", "", "the broker address(ip:port)")
+}
+
+func TestMain(m *testing.M) {
+	flag.Parse()
+
+	// setup for this scenario
+	mqtt.ERROR = log.New(os.Stdout, "[ERROR] ", 0)
+	/*
+	   mqtt.CRITICAL = log.New(os.Stdout, "[CRIT] ", 0)
+	   mqtt.WARN = log.New(os.Stdout, "[WARN]  ", 0)
+	   mqtt.DEBUG = log.New(os.Stdout, "[DEBUG] ", 0)
+	*/
+
+	// run this scenario test
+	r := m.Run()
+
+	// teardown for this scenario
+	// tbd if teardown is needed
+
+	os.Exit(r)
+}
diff --git a/automated-testing/scenarios/subscribe/subscribe_test.go b/automated-testing/scenarios/subscribe/subscribe_test.go
new file mode 100644
index 00000000..627cd534
--- /dev/null
+++ b/automated-testing/scenarios/subscribe/subscribe_test.go
@@ -0,0 +1,62 @@
+package subscribe
+
+import (
+	scenarios "bigwhite/autotester/scenarios"
+	"testing"
+)
+
+func Test_Subscribe_S0001_SubscribeOK(t *testing.T) {
+	t.Parallel() // indicate the case can be ran in parallel mode
+
+	tests := []struct {
+		name  string
+		topic string
+		qos   byte
+	}{
+		{
+			name:  "Case_001: Subscribe with QoS 0",
+			topic: "a/b/c",
+			qos:   0,
+		},
+		{
+			name:  "Case_002: Subscribe with QoS 1",
+			topic: "a/b/c",
+			qos:   1,
+		},
+		{
+			name:  "Case_003: Subscribe with QoS 2",
+			topic: "a/b/c",
+			qos:   2,
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel() // indicate the case can be ran in parallel mode
+			client, testCaseTeardown, err := scenarios.TestCaseSetup(addr, nil)
+			if err != nil {
+				t.Errorf("want ok, got %v", err)
+				return
+			}
+			defer testCaseTeardown()
+
+			token := client.Subscribe(tt.topic, tt.qos, nil)
+			token.Wait()
+
+			// Check if subscription was successful
+			if token.Error() != nil {
+				t.Errorf("want ok, got %v", token.Error())
+			}
+
+			token = client.Unsubscribe(tt.topic)
+			token.Wait()
+			if token.Error() != nil {
+				t.Errorf("want ok, got %v", token.Error())
+			}
+		})
+	}
+}
+
+func Test_Subscribe_S0002_SubscribeFail(t *testing.T) {
+}
diff --git a/automated-testing/test_report.html b/automated-testing/test_report.html
new file mode 100644
index 00000000..fba65bd0
--- /dev/null
+++ b/automated-testing/test_report.html
@@ -0,0 +1,468 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>go-test-report</title>
+    <style type="text/css">
+        body {
+            font-family: sans-serif;
+            background-color: #f3f3f3;
+            border-top: 2px #dee6e8 solid;
+            margin: 0;
+        }
+
+        div.pageHeader span.projectTitle {
+            font-family: serif;
+            font-size: 2em;
+            padding-left: 56px;
+            padding-top: 80px;
+            display: block;
+            color: #a5a5a5;
+            text-shadow: 0 -1px 1px white;
+        }
+
+        div.pageHeader div.testStats {
+            position: absolute;
+            top: 7px;
+            right: 52px;
+            font-size: 0.8em;
+            color: #a2a2a2;
+        }
+
+        div.pageHeader div.testStats span.indicator {
+            font-size: 2em;
+            position: relative;
+            top: 5px;
+            text-shadow: 0 1px 0 white;
+        }
+
+        div.pageHeader div.testStats span strong {
+            margin-right: 16px;
+        }
+
+        div.pageHeader div.testStats span.total {
+            border-right: 1px #afafaf dotted;
+            background: #8298af;
+        }
+
+        div.pageHeader div.testStats span.passed {
+            border-right: 1px #afafaf dotted;
+            background: #6fca83;
+        }
+
+        div.pageHeader div.testStats span.skipped {
+            background: #bababa;
+        }
+
+        div.pageHeader div.testStats span.failed {
+            background: #ff7676;
+        }
+
+        div.pageHeader div.testStats span {
+            margin-right: 1px;
+            height: 55px;
+            padding: 20px 8px 18px;
+            color: white;
+        }
+
+        div.pageHeader .testGroupsTitle {
+            margin: 16px 32px 8px 40px;
+            font-size: 0.9em;
+            color: darkgrey;
+            display: inline-block;
+        }
+
+        div.pageHeader .testExecutionDate {
+            display: inline-block;
+            position: absolute;
+            right: 10px;
+            margin: 14px 32px 8px 40px;
+            color: #9e9e9e;
+            font-size: 0.9em;
+        }
+
+        .testReportContainer {
+            padding: 0 32px 32px 32px;
+        }
+
+        .cardContainer {
+            padding: 16px 16px 16px;
+            box-shadow: 0 4px 4px #d4d4d4;
+            background-color: white;
+        }
+
+        #testResults {
+            display: flex;
+            flex-wrap: wrap;
+        }
+
+        .testResultGroup {
+            width: 24px;
+            height: 24px;
+            background-color: #43c143;
+            margin-left: 1px;
+            margin-bottom: 1px;
+            box-sizing: border-box;
+        }
+
+        .testResultGroup.selected {
+            border: 1px white solid;
+            background-color: black !important;
+        }
+
+        .testResultGroup.skipped {
+            border: 2px gray solid;
+        }
+
+        .testResultGroup.failed {
+            background-color: red;
+        }
+
+        .cardContainer.testGroupList,
+        .cardContainer.testDetail {
+            margin-top: 16px;
+            padding: 16px;
+        }
+
+        .cardContainer.testGroupList {
+            color: #9c9c9c;
+            padding: 0;
+        }
+
+        .cardContainer.testGroupList .testGroupRow {
+            cursor: default;
+            border-bottom: 1px #dadada dotted;
+        }
+
+        .cardContainer.testGroupList .testGroupRow span.testStatus {
+            font-size: 1.2em;
+            font-weight: bold;
+            color: #139e13;
+            pointer-events: none;
+            display: inline-block;
+            overflow: hidden;
+            float: left;
+            padding-top: 10px;
+            padding-left: 20px;
+            padding-right: 12px;
+        }
+
+        .cardContainer.testGroupList .testGroupRow span.testStatus.skipped {
+            color: gray;
+        }
+
+        .cardContainer.testGroupList .testGroupRow span.testStatus.failed {
+            color: red;
+        }
+
+        .cardContainer.testGroupList .testGroupRow span.testTitle {
+            font-size: 0.9em;
+            padding: 12px 0 10px;
+            display: inline-block;
+            pointer-events: none;
+            color: #525252;
+            text-overflow: ellipsis;
+            overflow: hidden;
+            width: calc(100% - 110px);
+        }
+
+        .cardContainer.testGroupList .testGroupRow span.testDuration {
+            pointer-events: none;
+        }
+
+        .cardContainer.testGroupList .testGroupRow {
+            position: relative;
+            border-left: 4px #43c143 solid;
+        }
+
+        .cardContainer.testGroupList .testGroupRow.skipped {
+            color: gray;
+            border-left: 4px gray solid;
+        }
+
+        .cardContainer.testGroupList .testGroupRow.failed {
+            color: red;
+            border-left: 4px red solid;
+        }
+
+        .cardContainer.testGroupList .testGroupRow:hover {
+            background-color: #fffaea;
+            transition: 0.250s;
+        }
+
+        .cardContainer .testOutput {
+            padding: 8px 16px 24px 16px;
+        }
+
+        .cardContainer .console {
+            display: block;
+            font-family: monospace;
+            padding: 10px;
+            background-color: #424242;
+            color: #1aff00;
+            border-bottom: 1px #1aff00 dotted;
+            overflow: auto;
+            font-size: 1.1em;
+        }
+
+        .cardContainer .testOutput .testDetail {
+            border-bottom: 1px #d0d0d0 solid;
+            padding: 16px;
+            background-color: #e6e6e6;
+            border-radius: 0 0 4px 4px;
+            color: dimgrey;
+            font-size: 0.8em;
+        }
+
+        .cardContainer .console.skipped{
+            color: #d9d9d9;
+        }
+
+        .cardContainer .console.failed {
+            color: #ffb2b2;
+        }
+
+        .cardContainer .testDuration {
+            position: absolute;
+            top: 5px;
+            right: 8px;
+            text-align: right;
+            padding-right: 8px;
+            box-sizing: border-box;
+        }
+    </style>
+</head>
+<body>
+<div class="pageHeader">
+    <span class="projectTitle">go-test-report</span>
+    <div class="testStats">
+        <span class="total"><span class="indicator">&boxbox;</span> Total: <strong>9</strong>Duration: <strong>1.315s</strong>
+        </span><span class="passed"><span class="indicator">&check;</span> Passed: <strong>3</strong>
+        </span><span class="skipped"><span class="indicator">&dash;</span> Skipped: <strong>0</strong>
+        </span><span class="failed"><span class="indicator">&cross;</span> Failed: <strong>6</strong>
+        </span>
+    </div>
+    <span class="testGroupsTitle">Test Groups:</span>
+    <span class="testExecutionDate">March 24, 2023 22:23:22</span>
+</div>
+<div class="testReportContainer">
+    <div class="cardContainer">
+        <div id="testResults">
+            
+                <div class="testResultGroup failed " id="0"></div>
+            
+        </div>
+    </div>
+    <div class="cardContainer testGroupList" id="testGroupList"></div>
+</div>
+<script type="application/javascript">
+    /**
+ * @typedef TestStatus
+ * @property {string} TestName
+ * @property {string} Package
+ * @property {number} ElapsedTime
+ * @property {Array.<string>} Output
+ * @property {boolean} Passed
+ * @property {boolean} Skipped
+ */
+class TestStatus {}
+
+/**
+ * @typedef TestGroupData
+ * @type {object}
+ * @property {string} FailureIndicator
+ * @property {string} SkippedIndicator
+ * @property {Array.<TestStatus>}
+ */
+class TestGroupData {}
+
+/**
+ * @typedef TestResults
+ * @type {Array.<TestGroupData>}
+ */
+class TestResults extends Array {}
+
+/**
+ * @typedef SelectedItems
+ * @property {HTMLElement|EventTarget} testResults
+ * @property {String} selectedTestGroupColor
+ */
+class SelectedItems {}
+
+/**
+ * @typedef GoTestReportElements
+ * @property {TestResults} data
+ * @property {HTMLElement} testResultsElem
+ * @property {HTMLElement} testGroupListElem
+ */
+class GoTestReportElements {}
+
+
+/**
+ * Main entry point for GoTestReport.
+ * @param {GoTestReportElements} elements
+ * @returns {{testResultsClickHandler: testResultsClickHandler}}
+ * @constructor
+ */
+window.GoTestReport = function (elements) {
+  const /**@type {SelectedItems}*/ selectedItems = {
+    testResults: null,
+    selectedTestGroupColor: null
+  }
+
+  function addEventData(event) {
+    if (event.data == null) {
+      event.data = {target: event.target}
+    }
+    return event
+  }
+
+
+  const goTestReport = {
+    /**
+     * Invoked when a user clicks on one of the test group div elements.
+     * @param {HTMLElement} target The element associated with the test group.
+     * @param {boolean} shiftKey If pressed, all of test detail associated to the test group is shown.
+     * @param {TestResults} data
+     * @param {SelectedItems} selectedItems
+     * @param {function(target: Element, data: TestResults)} testGroupListHandler
+     */
+    testResultsClickHandler: function (target,
+                                       shiftKey,
+                                       data,
+                                       selectedItems,
+                                       testGroupListHandler) {
+
+      if (target.classList.contains('testResultGroup') === false) {
+        return
+      }
+      if (selectedItems.testResults != null) {
+        let testResultsElement = /**@type {HTMLElement}*/ selectedItems.testResults
+        testResultsElement.classList.remove("selected")
+        testResultsElement.style.backgroundColor = selectedItems.selectedTestGroupColor
+      }
+      const testGroupId = /**@type {number}*/ target.id
+      if ((target.id === undefined)
+        || (data[testGroupId] === undefined)
+        || (data[testGroupId]['TestResults'] === undefined)) {
+        return
+      }
+      const testResults = /**@type {TestResults}*/ data[testGroupId]['TestResults']
+      let testGroupList = /**@type {string}*/ ''
+      selectedItems.selectedTestGroupColor = getComputedStyle(target).getPropertyValue('background-color')
+      selectedItems.testResults = target
+      target.classList.add("selected")
+      for (let i = 0; i < testResults.length; i++) {
+        const testResult = /**@type {TestGroupData}*/ testResults[i]
+        const testPassed = /**@type {boolean}*/ testResult.Passed
+        const testSkipped = /**@type {boolean}*/ testResult.Skipped
+        const testPassedStatus = /**@type {string}*/ (testPassed) ? '' : (testSkipped ? 'skipped' : 'failed')
+        const testId = /**@type {string}*/ target.attributes['id'].value
+        testGroupList += `<div class="testGroupRow ${testPassedStatus}" data-groupid="${testId}" data-index="${i}">
+        <span class="testStatus ${testPassedStatus}">${(testPassed) ? '&check' : (testSkipped ? '&dash' : '&cross')};</span>
+        <span class="testTitle">${testResult.TestName}</span>
+        <span class="testDuration"><span>${testResult.ElapsedTime}s </span>⏱</span>
+      </div>`
+      }
+      const testGroupListElem = elements.testGroupListElem
+      testGroupListElem.innerHTML = ''
+      testGroupListElem.innerHTML = testGroupList
+
+      if (shiftKey) {
+        testGroupListElem.querySelectorAll('.testGroupRow')
+                         .forEach((elem) => testGroupListHandler(elem, data))
+      } else if (testResults.length === 1) {
+        testGroupListHandler(testGroupListElem.querySelector('.testGroupRow'), data)
+      }
+    },
+
+    /**
+     *
+     * @param {Element} target
+     * @param {TestResults} data
+     */
+    testGroupListHandler: function (target, data) {
+      const attribs = target['attributes']
+      if (attribs.hasOwnProperty('data-groupid')) {
+        const groupId = /**@type {number}*/ attribs['data-groupid'].value
+        const testIndex = /**@type {number}*/ attribs['data-index'].value
+        const testStatus = /**@type {TestStatus}*/ data[groupId]['TestResults'][testIndex]
+        const testOutputDiv = /**@type {HTMLDivElement}*/ target.querySelector('div.testOutput')
+
+        if (testOutputDiv == null) {
+          const testOutputDiv = document.createElement('div')
+          testOutputDiv.classList.add('testOutput')
+          const consolePre = document.createElement('pre')
+          consolePre.classList.add('console')
+          const testDetailDiv = document.createElement('div')
+          testDetailDiv.classList.add('testDetail')
+          const packageNameDiv = document.createElement('div')
+          packageNameDiv.classList.add('package')
+          packageNameDiv.innerHTML = `<strong>Package:</strong> ${testStatus.Package}`
+          const testFileNameDiv = document.createElement('div')
+          testFileNameDiv.classList.add('filename')
+          if (testStatus.TestFileName.trim() === "") {
+            testFileNameDiv.innerHTML = `<strong>Filename:</strong> n/a &nbsp;&nbsp;`
+          } else {
+            testFileNameDiv.innerHTML = `<strong>Filename:</strong> ${testStatus.TestFileName} &nbsp;&nbsp;`
+            testFileNameDiv.innerHTML += `<strong>Line:</strong> ${testStatus.TestFunctionDetail.Line} `
+            testFileNameDiv.innerHTML += `<strong>Col:</strong> ${testStatus.TestFunctionDetail.Col}`
+          }
+          testDetailDiv.insertAdjacentElement('beforeend', packageNameDiv)
+          testDetailDiv.insertAdjacentElement('beforeend', testFileNameDiv)
+          testOutputDiv.insertAdjacentElement('afterbegin', consolePre)
+          testOutputDiv.insertAdjacentElement('beforeend', testDetailDiv)
+          target.insertAdjacentElement('beforeend', testOutputDiv)
+
+          if (testStatus.Passed) {
+            consolePre.classList.remove('skipped')
+            consolePre.classList.remove('failed')
+          } else if (testStatus.Skipped) {
+            consolePre.classList.add('skipped')
+            consolePre.classList.remove('failed')
+          } else {
+            consolePre.classList.remove('skipped')
+            consolePre.classList.add('failed')
+          }
+          consolePre.textContent = testStatus.Output.join('')
+        } else {
+          testOutputDiv.remove()
+        }
+      }
+    }
+  }
+
+  //+------------------------+
+  //|    setup DOM events    |
+  //+------------------------+
+  elements.testResultsElem
+          .addEventListener('click', event =>
+            goTestReport.testResultsClickHandler(/**@type {HTMLElement}*/ addEventData(event).data.target,
+                                                 event.shiftKey,
+                                                 elements.data,
+                                                 selectedItems,
+                                                 goTestReport.testGroupListHandler))
+
+  elements.testGroupListElem
+          .addEventListener('click', event =>
+            goTestReport.testGroupListHandler(/**@type {Element}*/ event.target,
+                                              elements.data))
+
+  return goTestReport
+}
+
+
+    
+
+    const data = [{"FailureIndicator":"failed","SkippedIndicator":"","TestResults":[{"TestName":"Test_Connection_S0001_ConnectOKWithoutAuth","Package":"bigwhite/autotester/scenarios/connection","ElapsedTime":0,"Output":["","=== RUN   Test_Connection_S0001_ConnectOKWithoutAuth\n","[ERROR] [client]   dial tcp [::1]:30083: connect: connection refused\n","[ERROR] [client]   Failed to connect to a broker\n","    connect_test.go:20: want ok, got network Error : dial tcp [::1]:30083: connect: connection refused\n","--- FAIL: Test_Connection_S0001_ConnectOKWithoutAuth (0.00s)\n",""],"Passed":false,"Skipped":false,"TestFileName":"connect_test.go","TestFunctionDetail":{"Line":9,"Col":1}},{"TestName":"Test_Connection_S0002_ConnectOKWithAuth","Package":"bigwhite/autotester/scenarios/connection","ElapsedTime":0,"Output":["","=== RUN   Test_Connection_S0002_ConnectOKWithAuth\n","--- PASS: Test_Connection_S0002_ConnectOKWithAuth (0.00s)",""],"Passed":true,"Skipped":false,"TestFileName":"connect_test.go","TestFunctionDetail":{"Line":26,"Col":1}},{"TestName":"Test_Publish_S0001_PublishOK","Package":"bigwhite/autotester/scenarios/publish","ElapsedTime":0,"Output":["","=== RUN   Test_Publish_S0001_PublishOK\n","[ERROR] [client]   dial tcp [::1]:30083: connect: connection refused\n","[ERROR] [client]   Failed to connect to a broker\n","    publish_test.go:11: want ok, got network Error : dial tcp [::1]:30083: connect: connection refused\n","--- FAIL: Test_Publish_S0001_PublishOK (0.00s)\n",""],"Passed":false,"Skipped":false,"TestFileName":"publish_test.go","TestFunctionDetail":{"Line":8,"Col":1}},{"TestName":"Test_Publish_S0002_PublishFail","Package":"bigwhite/autotester/scenarios/publish","ElapsedTime":0,"Output":["","=== RUN   Test_Publish_S0002_PublishFail\n","--- PASS: Test_Publish_S0002_PublishFail (0.00s)",""],"Passed":true,"Skipped":false,"TestFileName":"publish_test.go","TestFunctionDetail":{"Line":21,"Col":1}},{"TestName":"Test_Subscribe_S0001_SubscribeOK","Package":"bigwhite/autotester/scenarios/subscribe","ElapsedTime":0,"Output":["","=== RUN   Test_Subscribe_S0001_SubscribeOK\n","=== PAUSE Test_Subscribe_S0001_SubscribeOK\n","","","=== CONT  Test_Subscribe_S0001_SubscribeOK\n","--- FAIL: Test_Subscribe_S0001_SubscribeOK (0.00s)\n",""],"Passed":false,"Skipped":false,"TestFileName":"subscribe_test.go","TestFunctionDetail":{"Line":8,"Col":1}},{"TestName":"Test_Subscribe_S0001_SubscribeOK/Case_001:_Subscribe_with_QoS_0","Package":"bigwhite/autotester/scenarios/subscribe","ElapsedTime":0,"Output":["","=== RUN   Test_Subscribe_S0001_SubscribeOK/Case_001:_Subscribe_with_QoS_0\n","=== PAUSE Test_Subscribe_S0001_SubscribeOK/Case_001:_Subscribe_with_QoS_0\n","","","=== CONT  Test_Subscribe_S0001_SubscribeOK/Case_001:_Subscribe_with_QoS_0\n","","=== CONT  Test_Subscribe_S0001_SubscribeOK/Case_001:_Subscribe_with_QoS_0\n","    subscribe_test.go:39: want ok, got network Error : dial tcp [::1]:30083: connect: connection refused\n","[ERROR] [client]   dial tcp [::1]:30083: connect: connection refused\n","[ERROR] [client]   Failed to connect to a broker\n","    --- FAIL: Test_Subscribe_S0001_SubscribeOK/Case_001:_Subscribe_with_QoS_0 (0.00s)\n",""],"Passed":false,"Skipped":false,"TestFileName":"","TestFunctionDetail":{"Line":0,"Col":0}},{"TestName":"Test_Subscribe_S0001_SubscribeOK/Case_002:_Subscribe_with_QoS_1","Package":"bigwhite/autotester/scenarios/subscribe","ElapsedTime":0,"Output":["","=== RUN   Test_Subscribe_S0001_SubscribeOK/Case_002:_Subscribe_with_QoS_1\n","=== PAUSE Test_Subscribe_S0001_SubscribeOK/Case_002:_Subscribe_with_QoS_1\n","","","=== CONT  Test_Subscribe_S0001_SubscribeOK/Case_002:_Subscribe_with_QoS_1\n","[ERROR] [client]   dial tcp [::1]:30083: connect: connection refused\n","[ERROR] [client]   dial tcp [::1]:30083: connect: connection refused\n","[ERROR] [client]   Failed to connect to a broker\n","[ERROR] [client]   Failed to connect to a broker\n","    subscribe_test.go:39: want ok, got network Error : dial tcp [::1]:30083: connect: connection refused\n","    --- FAIL: Test_Subscribe_S0001_SubscribeOK/Case_002:_Subscribe_with_QoS_1 (0.00s)\n",""],"Passed":false,"Skipped":false,"TestFileName":"","TestFunctionDetail":{"Line":0,"Col":0}},{"TestName":"Test_Subscribe_S0001_SubscribeOK/Case_003:_Subscribe_with_QoS_2","Package":"bigwhite/autotester/scenarios/subscribe","ElapsedTime":0,"Output":["","=== RUN   Test_Subscribe_S0001_SubscribeOK/Case_003:_Subscribe_with_QoS_2\n","=== PAUSE Test_Subscribe_S0001_SubscribeOK/Case_003:_Subscribe_with_QoS_2\n","","","=== CONT  Test_Subscribe_S0001_SubscribeOK/Case_003:_Subscribe_with_QoS_2\n","","=== CONT  Test_Subscribe_S0001_SubscribeOK/Case_003:_Subscribe_with_QoS_2\n","    subscribe_test.go:39: want ok, got network Error : dial tcp [::1]:30083: connect: connection refused\n","    --- FAIL: Test_Subscribe_S0001_SubscribeOK/Case_003:_Subscribe_with_QoS_2 (0.00s)\n",""],"Passed":false,"Skipped":false,"TestFileName":"","TestFunctionDetail":{"Line":0,"Col":0}},{"TestName":"Test_Subscribe_S0002_SubscribeFail","Package":"bigwhite/autotester/scenarios/subscribe","ElapsedTime":0,"Output":["","=== RUN   Test_Subscribe_S0002_SubscribeFail\n","--- PASS: Test_Subscribe_S0002_SubscribeFail (0.00s)",""],"Passed":true,"Skipped":false,"TestFileName":"subscribe_test.go","TestFunctionDetail":{"Line":61,"Col":1}}]}]
+
+    const report = window.GoTestReport({
+                                         data: data,
+                                         testResultsElem: document.getElementById('testResults'),
+                                         testGroupListElem: document.getElementById('testGroupList')
+                                       });
+
+
+</script>
+</body>
+</html>