chore: Make remote debugger-related messages more useful (#2443)

lib/commands/context.js

@@ -67,20 +67,28 @@ const extensions = {
    * @returns {Promise<import('../types').Page[]>}
    */
   async listWebFrames(useUrl = true) {
-    useUrl = useUrl && !this.isRealDevice() && !!this.getCurrentUrl();
+    const shouldFilterByUrl = useUrl && !this.isRealDevice() && !!this.getCurrentUrl();
     this.log.debug(
-      `Selecting by url: ${useUrl}${useUrl ? ` (expected url: '${this.getCurrentUrl()}')` : ''}`,
+      `Selecting by url: ${shouldFilterByUrl}` +
+      (shouldFilterByUrl ? ` (expected url: '${this.getCurrentUrl()}')` : '')
     );
 
     if (!this.remote) {
       await this.connectToRemoteDebugger();
     }
     /** @type {number|undefined} */
-    const maxRetriesCount = this.opts.webviewConnectRetries;
+    const maxRetriesCount = _.isInteger(this.opts.webviewConnectRetries)
+      ? Math.max(/** @type {number} */ (this.opts.webviewConnectRetries), 1)
+      : undefined;
+    this.log.debug(
+      `About to select a web application with ${util.pluralize('retry', maxRetriesCount ?? 20, true)} ` +
+      `and 500ms interval between each retry. Consider customizing the value of 'webviewConnectRetries' ` +
+      `capability to change the amount of retries.`
+    );
     try {
       const pageArray = await (/** @type {RemoteDebugger} */ (this.remote)).selectApp(
-        useUrl ? this.getCurrentUrl() : undefined,
-        _.isInteger(maxRetriesCount) ? Math.max(/** @type {number} */ (maxRetriesCount), 1) : undefined,
+        shouldFilterByUrl ? this.getCurrentUrl() : undefined,
+        maxRetriesCount,
         this.opts.ignoreAboutBlankUrl,
       );
       if (_.isEmpty(pageArray)) {
@@ -115,9 +123,15 @@ const extensions = {
       this.curWebFrames = [];
     });
 
-    await this.remote.connect(
-      this.opts.webviewConnectTimeout ?? DEFAULT_REMOTE_DEBUGGER_CONNECT_TIMEOUT_MS
-    );
+    const timeoutMs = this.opts.webviewConnectTimeout ?? DEFAULT_REMOTE_DEBUGGER_CONNECT_TIMEOUT_MS;
+    const apps = await this.remote.connect(timeoutMs);
+    if (_.isEmpty(apps)) {
+      this.log.info(
+        `The remote debugger did not report any active web applications within ${timeoutMs}ms timeout. ` +
+        `Consider increasing the value of 'webviewConnectTimeout' capability to wait longer ` +
+        `on slower devices.`
+      );
+    }
   },
 
   /**