feat: add auto popup handler configuration for HRPRunner

2026-05-06 20:32:44 +08:00 · 2025-06-27 12:12:48 +08:00
parent 6c685acbf6
commit 29c5c4df84
27 changed files with 62 additions and 40 deletions
--- a/cmd/run.go
+++ b/cmd/run.go
@@ -36,6 +36,7 @@ var (
 	genHTMLReport     bool
 	caseTimeout       float32
 	runMCPConfigPath  string // MCP config path for run command
+	autoPopupHandler  bool   // enable auto popup handler for all steps
 )

 func init() {
@@ -48,6 +49,7 @@ func init() {
 	CmdRun.Flags().BoolVarP(&genHTMLReport, "gen-html-report", "g", false, "generate html report")
 	CmdRun.Flags().Float32Var(&caseTimeout, "case-timeout", 3600, "set testcase timeout (seconds)")
 	CmdRun.Flags().StringVar(&runMCPConfigPath, "mcp-config", "", "path to the MCP config file")
+	CmdRun.Flags().BoolVar(&autoPopupHandler, "enable-auto-popup-handler", false, "enable auto popup handler for all UI steps")
 }

 func makeHRPRunner() *hrp.HRPRunner {
@@ -76,5 +78,8 @@ func makeHRPRunner() *hrp.HRPRunner {
 	if runMCPConfigPath != "" {
 		runner.SetMCPConfigPath(runMCPConfigPath)
 	}
+	if autoPopupHandler {
+		runner.EnableAutoPopupHandler(autoPopupHandler)
+	}
 	return runner
 }
--- a/docs/cmd/hrp.md
+++ b/docs/cmd/hrp.md
@@ -63,4 +63,4 @@ Copyright © 2017-present debugtalk. Apache-2.0 License.
 * [hrp startproject](hrp_startproject.md)	 - Create a scaffold project
 * [hrp wiki](hrp_wiki.md)	 - visit https://httprunner.com

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_adb.md
+++ b/docs/cmd/hrp_adb.md
@@ -23,4 +23,4 @@ simple utils for android device management
 * [hrp adb install](hrp_adb_install.md)	 - push package to the device and install them automatically
 * [hrp adb screencap](hrp_adb_screencap.md)	 - Start android screen capture

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_adb_devices.md
+++ b/docs/cmd/hrp_adb_devices.md
@@ -24,4 +24,4 @@ hrp adb devices [flags]

 * [hrp adb](hrp_adb.md)	 - simple utils for android device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_adb_install.md
+++ b/docs/cmd/hrp_adb_install.md
@@ -28,4 +28,4 @@ hrp adb install [flags] PACKAGE

 * [hrp adb](hrp_adb.md)	 - simple utils for android device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_adb_screencap.md
+++ b/docs/cmd/hrp_adb_screencap.md
@@ -25,4 +25,4 @@ hrp adb screencap [flags]

 * [hrp adb](hrp_adb.md)	 - simple utils for android device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_build.md
+++ b/docs/cmd/hrp_build.md
@@ -36,4 +36,4 @@ hrp build $path ... [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_convert.md
+++ b/docs/cmd/hrp_convert.md
@@ -34,4 +34,4 @@ hrp convert $path... [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios.md
+++ b/docs/cmd/hrp_ios.md
@@ -29,4 +29,4 @@ simple utils for ios device management
 * [hrp ios uninstall](hrp_ios_uninstall.md)	 - uninstall package automatically
 * [hrp ios xctest](hrp_ios_xctest.md)	 - run xctest

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_apps.md
+++ b/docs/cmd/hrp_ios_apps.md
@@ -26,4 +26,4 @@ hrp ios apps [flags]

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_devices.md
+++ b/docs/cmd/hrp_ios_devices.md
@@ -24,4 +24,4 @@ hrp ios devices [flags]

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_install.md
+++ b/docs/cmd/hrp_ios_install.md
@@ -25,4 +25,4 @@ hrp ios install [flags] PACKAGE

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_mount.md
+++ b/docs/cmd/hrp_ios_mount.md
@@ -28,4 +28,4 @@ hrp ios mount [flags]

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_ps.md
+++ b/docs/cmd/hrp_ios_ps.md
@@ -26,4 +26,4 @@ hrp ios ps [flags]

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_reboot.md
+++ b/docs/cmd/hrp_ios_reboot.md
@@ -25,4 +25,4 @@ hrp ios reboot [flags]

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_tunnel.md
+++ b/docs/cmd/hrp_ios_tunnel.md
@@ -24,4 +24,4 @@ hrp ios tunnel [flags]

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_uninstall.md
+++ b/docs/cmd/hrp_ios_uninstall.md
@@ -26,4 +26,4 @@ hrp ios uninstall [flags] PACKAGE

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_ios_xctest.md
+++ b/docs/cmd/hrp_ios_xctest.md
@@ -28,4 +28,4 @@ hrp ios xctest [flags]

 * [hrp ios](hrp_ios.md)	 - simple utils for ios device management

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_mcp-server.md
+++ b/docs/cmd/hrp_mcp-server.md
@@ -28,4 +28,4 @@ hrp mcp-server [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_mcphost.md
+++ b/docs/cmd/hrp_mcphost.md
@@ -31,4 +31,4 @@ hrp mcphost [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_pytest.md
+++ b/docs/cmd/hrp_pytest.md
@@ -24,4 +24,4 @@ hrp pytest $path ... [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_report.md
+++ b/docs/cmd/hrp_report.md
@@ -33,4 +33,4 @@ hrp report [result_folder] [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_run.md
+++ b/docs/cmd/hrp_run.md
@@ -21,16 +21,17 @@ hrp run $path... [flags]
 ### Options

 ```
-      --case-timeout float32   set testcase timeout (seconds) (default 3600)
-  -c, --continue-on-failure    continue running next step when failure occurs
-  -g, --gen-html-report        generate html report
-  -h, --help                   help for run
-      --http-stat              turn on HTTP latency stat (DNSLookup, TCP Connection, etc.)
-      --log-plugin             turn on plugin logging
-      --log-requests-off       turn off request & response details logging
-      --mcp-config string      path to the MCP config file
-  -p, --proxy-url string       set proxy url
-  -s, --save-tests             save tests summary
+      --case-timeout float32        set testcase timeout (seconds) (default 3600)
+  -c, --continue-on-failure         continue running next step when failure occurs
+      --enable-auto-popup-handler   enable auto popup handler for all UI steps
+  -g, --gen-html-report             generate html report
+  -h, --help                        help for run
+      --http-stat                   turn on HTTP latency stat (DNSLookup, TCP Connection, etc.)
+      --log-plugin                  turn on plugin logging
+      --log-requests-off            turn off request & response details logging
+      --mcp-config string           path to the MCP config file
+  -p, --proxy-url string            set proxy url
+  -s, --save-tests                  save tests summary
 ```

 ### Options inherited from parent commands
@@ -45,4 +46,4 @@ hrp run $path... [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_server.md
+++ b/docs/cmd/hrp_server.md
@@ -30,4 +30,4 @@ hrp server start [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_startproject.md
+++ b/docs/cmd/hrp_startproject.md
@@ -29,4 +29,4 @@ hrp startproject $project_name [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/docs/cmd/hrp_wiki.md
+++ b/docs/cmd/hrp_wiki.md
@@ -24,4 +24,4 @@ hrp wiki [flags]

 * [hrp](hrp.md)	 - All-in-One Testing Framework for API, UI and Performance

-###### Auto generated by spf13/cobra on 8-Jun-2025
+###### Auto generated by spf13/cobra on 27-Jun-2025
--- a/runner.go
+++ b/runner.go
@@ -18,12 +18,12 @@ import (
 	"time"

 	"github.com/gorilla/websocket"
+	"github.com/httprunner/funplugin"
 	"github.com/jinzhu/copier"
 	"github.com/pkg/errors"
 	"github.com/rs/zerolog/log"
 	"golang.org/x/net/http2"

-	"github.com/httprunner/funplugin"
 	"github.com/httprunner/httprunner/v5/code"
 	"github.com/httprunner/httprunner/v5/internal/builtin"
 	"github.com/httprunner/httprunner/v5/internal/config"
@@ -50,10 +50,11 @@ func NewRunner(t *testing.T) *HRPRunner {
 	interruptSignal := make(chan os.Signal, 1)
 	signal.Notify(interruptSignal, syscall.SIGTERM, syscall.SIGINT)
 	return &HRPRunner{
-		t:             t,
-		failfast:      true, // default to failfast
-		genHTMLReport: false,
-		mcpConfigPath: "",
+		t:                t,
+		failfast:         true, // default to failfast
+		genHTMLReport:    false,
+		mcpConfigPath:    "",
+		autoPopupHandler: false,
 		httpClient: &http.Client{
 			Transport: &http.Transport{
 				TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
@@ -87,6 +88,7 @@ type HRPRunner struct {
 	saveTests        bool
 	genHTMLReport    bool
 	mcpConfigPath    string // MCP config file path
+	autoPopupHandler bool   // enable auto popup handler for all UI steps
 	httpClient       *http.Client
 	http2Client      *http.Client
 	wsDialer         *websocket.Dialer
@@ -198,6 +200,13 @@ func (r *HRPRunner) GenHTMLReport() *HRPRunner {
 	return r
 }

+// EnableAutoPopupHandler configures whether to enable auto popup handler for all UI steps.
+func (r *HRPRunner) EnableAutoPopupHandler(enabled bool) *HRPRunner {
+	log.Info().Bool("autoPopupHandler", enabled).Msg("[init] EnableAutoPopupHandler")
+	r.autoPopupHandler = enabled
+	return r
+}
+
 // SetMCPConfigPath configures the MCP config path.
 func (r *HRPRunner) SetMCPConfigPath(mcpConfigPath string) *HRPRunner {
 	log.Info().Str("mcpConfigPath", mcpConfigPath).Msg("[init] SetMCPConfigPath")
@@ -394,6 +403,13 @@ func NewCaseRunner(testcase TestCase, hrpRunner *HRPRunner) (*CaseRunner, error)
 		return nil, errors.Wrap(err, "parse testcase config failed")
 	}

+	// apply global auto popup handler setting if enabled
+	// priority: command line > testcase config > step config
+	if hrpRunner.autoPopupHandler {
+		parsedConfig.AutoPopupHandler = true
+		log.Info().Bool("autoPopupHandler", true).Msg("applied global auto popup handler setting")
+	}
+
 	// set request timeout in seconds
 	if parsedConfig.RequestTimeout != 0 {
 		hrpRunner.SetRequestTimeout(parsedConfig.RequestTimeout)