@wdio/nightwatch-devtools 1.4.0 → 1.5.1

package/dist/index.js

@@ -17,7 +17,72 @@ import {
 // src/index.ts
 import { fileURLToPath } from "url";
 
-// ../core/src/action-mapping.ts
+// ../shared/src/files.ts
+var SPEC_FILE_RE = /\.(?:test|spec)\.[cm]?[jt]sx?$/i;
+
+// ../shared/src/routes.ts
+var WS_PATHS = {
+  /** Adapter session upgrade endpoint. One socket per running adapter. */
+  worker: "/worker",
+  /** App/UI client upgrade endpoint. Multiple browser tabs may connect. */
+  client: "/client"
+};
+var WS_SCOPE = {
+  /** Backend → worker: a dashboard client has subscribed. Wakes up the
+   *  adapter's `await UI ready` gate before tests start. */
+  clientConnected: "clientConnected",
+  /** Backend → worker: the last dashboard tab closed. Triggers the
+   *  interactive shutdown flow (close WS, exit, pkill the dashboard). */
+  clientDisconnected: "clientDisconnected",
+  /** Worker → backend → clients (or app-local): wipe the visualization data
+   *  for a specific test/suite uid (or the whole tree). */
+  clearExecutionData: "clearExecutionData",
+  /** Worker → backend: clear-by-test-uid request (drives clearExecutionData). */
+  clearCommands: "clearCommands",
+  /** Backend → clients: signal that the active run was stopped by the UI. */
+  testStopped: "testStopped",
+  /** Worker → backend → clients: swap an earlier captured command for an
+   *  updated entry (used when a retry coalesces commands). */
+  replaceCommand: "replaceCommand",
+  /** Worker → backend: register the config file path so reruns can spawn
+   *  with the same config. */
+  config: "config"
+};
+
+// ../shared/src/runner.ts
+var REUSE_ENV = {
+  REUSE: "DEVTOOLS_APP_REUSE",
+  HOST: "DEVTOOLS_APP_HOST",
+  PORT: "DEVTOOLS_APP_PORT",
+  RERUN_LABEL: "DEVTOOLS_RERUN_LABEL",
+  RERUN_ENTRY_TYPE: "DEVTOOLS_RERUN_ENTRY_TYPE"
+};
+
+// ../shared/src/timing.ts
+var TIMING_BASE = {
+  /** ms to let the dashboard render between rapid state updates. */
+  UI_RENDER_DELAY: 150,
+  /** ms to wait after a test starts before flushing initial state. */
+  TEST_START_DELAY: 100,
+  /** ms gap between consecutive suite-finalize broadcasts. */
+  SUITE_COMPLETE_DELAY: 200,
+  /** ms allowed for the browser-close handshake before forcing teardown. */
+  BROWSER_CLOSE_WAIT: 2e3,
+  /** ms before first worker WS connection attempt — lets backend bind. */
+  INITIAL_CONNECTION_WAIT: 500,
+  /** ms between browser-window-alive polls. */
+  BROWSER_POLL_INTERVAL: 1e3
+};
+var DEFAULTS_BASE = {
+  /** Synthetic capability ID — present on every CommandLog / TestStats. */
+  CID: "0-0",
+  /** TestStats.retries default — adapters that surface retry counts override. */
+  RETRIES: 0,
+  /** _duration placeholder for not-yet-finalized stats. */
+  DURATION: 0
+};
+
+// ../shared/src/trace-actions.ts
 var ACTION_MAP = {
   // WDIO browser-level
   url: { class: "Page", method: "navigate" },
@@ -48,6 +113,25 @@ var ACTION_MAP = {
   switchToFrame: { class: "Frame", method: "goto" },
   touchAction: { class: "Element", method: "tap" }
 };
+
+// ../shared/src/types.ts
+var TEST_STATE = {
+  PENDING: "pending",
+  RUNNING: "running",
+  PASSED: "passed",
+  FAILED: "failed",
+  SKIPPED: "skipped"
+};
+var SCREENCAST_DEFAULTS = {
+  enabled: false,
+  captureFormat: "jpeg",
+  quality: 70,
+  maxWidth: 1280,
+  maxHeight: 720,
+  pollIntervalMs: 200
+};
+
+// ../core/src/action-mapping.ts
 function mapCommandToAction(command) {
   return ACTION_MAP[command] ?? null;
 }
@@ -470,10 +554,45 @@ function isSameElement(node1, node2) {
   }
   return false;
 }
+function sanitizePageSource(sourceXML) {
+  let sanitized = sourceXML.replace(
+    /&(?!(?:amp|lt|gt|quot|apos|#\d+|#x[0-9a-fA-F]+);)/g,
+    "&"
+  );
+  const VOID_ELEMENTS = [
+    "link",
+    "meta",
+    "br",
+    "hr",
+    "img",
+    "input",
+    "source",
+    "area",
+    "base",
+    "col",
+    "embed",
+    "track",
+    "wbr"
+  ];
+  for (const tag of VOID_ELEMENTS) {
+    sanitized = sanitized.replace(
+      // eslint-disable-next-line security/detect-non-literal-regexp -- tag from hardcoded list
+      new RegExp(`<${tag}(\\s[^>]*?[^/])>`, "gi"),
+      `<${tag}$1/>`
+    );
+    sanitized = sanitized.replace(
+      // eslint-disable-next-line security/detect-non-literal-regexp -- tag from hardcoded list
+      new RegExp(`<${tag}>`, "gi"),
+      `<${tag}/>`
+    );
+  }
+  return sanitized;
+}
 function xmlToJSON(sourceXML) {
   try {
+    const sanitized = sanitizePageSource(sourceXML);
     const parser = new DOMParser();
-    const sourceDoc = parser.parseFromString(sourceXML, "text/xml");
+    const sourceDoc = parser.parseFromString(sanitized, "text/xml");
     const parseErrors = sourceDoc.getElementsByTagName("parsererror");
     if (parseErrors.length > 0) {
       console.error(
@@ -492,8 +611,9 @@ function xmlToJSON(sourceXML) {
 }
 function xmlToDOM(sourceXML) {
   try {
+    const sanitized = sanitizePageSource(sourceXML);
     const parser = new DOMParser();
-    const doc = parser.parseFromString(sourceXML, "text/xml");
+    const doc = parser.parseFromString(sanitized, "text/xml");
     const parseErrors = doc.getElementsByTagName("parsererror");
     if (parseErrors.length > 0) {
       console.error("[xmlToDOM] XML parsing error:", parseErrors[0].textContent);
@@ -750,7 +870,7 @@ function isValidValue(value) {
   return value !== void 0 && value !== null && value !== "null" && value.trim() !== "";
 }
 function escapeText(text) {
-  return text.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n");
+  return text.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
 }
 function escapeXPathValue(value) {
   if (!value.includes("'")) {
@@ -1206,21 +1326,8 @@ function serializeWebSnapshot(nodes, context, options = {}) {
     }
     const indent = "  ".repeat(node.depth + 1);
     const isInteractive = INTERACTIVE_ROLES.has(node.role);
-    if (node.role === "statictext" && node.name) {
-      let echoedByParent = false;
-      for (let j = i - 1; j >= 0; j--) {
-        if (nodes[j].depth < node.depth) {
-          const parentRole = nodes[j].role;
-          const parentName = nodes[j].name;
-          if (INTERACTIVE_ROLES.has(parentRole) && parentName && parentName.includes(node.name)) {
-            echoedByParent = true;
-          }
-          break;
-        }
-      }
-      if (echoedByParent) {
-        continue;
-      }
+    if (isStatictextEchoedByParent(nodes, i)) {
+      continue;
     }
     const roleLabel = node.role === "heading" && node.level ? `heading[${node.level}]` : node.role;
     if (isInteractive) {
@@ -1245,6 +1352,22 @@ function serializeWebSnapshot(nodes, context, options = {}) {
   }
   return lines.join("\n");
 }
+function isStatictextEchoedByParent(nodes, index) {
+  const node = nodes[index];
+  if (node.role !== "statictext" || !node.name) {
+    return false;
+  }
+  for (let j = index - 1; j >= 0; j--) {
+    if (nodes[j].depth < node.depth) {
+      const parent = nodes[j];
+      if (INTERACTIVE_ROLES.has(parent.role) && parent.name && parent.name.includes(node.name)) {
+        return true;
+      }
+      break;
+    }
+  }
+  return false;
+}
 function simplifyTag(tagName) {
   const dot = tagName.lastIndexOf(".");
   if (dot !== -1) {
@@ -1308,6 +1431,20 @@ function classifyMobileRole(tagName, platform) {
   }
   return IOS_ROLE_MAP[tagName] || simplifyTag(tagName);
 }
+function getFirstChildText(element) {
+  const queue = [...element.children || []];
+  while (queue.length > 0) {
+    const el = queue.shift();
+    const text = el.attributes?.text?.trim();
+    if (text) {
+      return text;
+    }
+    if (el.children) {
+      queue.push(...el.children);
+    }
+  }
+  return void 0;
+}
 function getBestAndroidLocator(attrs) {
   if (attrs._selector) {
     return attrs._selector;
@@ -1393,7 +1530,7 @@ function isMobileInViewport(element, platform, viewport) {
 function collectMobileNodes(element, platform, depth, nodes, walkOpts) {
   const attrs = element.attributes;
   const role = classifyMobileRole(element.tagName, platform);
-  const name = getMobileNodeIdentity(attrs, platform);
+  let name = getMobileNodeIdentity(attrs, platform);
   const explicit = isExplicitlyInteractive(attrs, platform);
   const interactive = isMobileInteractive(element, platform);
   const inViewport = isMobileInViewport(element, platform, walkOpts.viewport);
@@ -1412,7 +1549,8 @@ function collectMobileNodes(element, platform, depth, nodes, walkOpts) {
         depth,
         isInteractive: false,
         isExplicitInteractive: false,
-        isInViewport: false
+        isInViewport: false,
+        tagName: element.tagName
       });
       return;
     }
@@ -1437,6 +1575,12 @@ function collectMobileNodes(element, platform, depth, nodes, walkOpts) {
     if (!locator) {
       locator = (platform === "android" ? getBestAndroidLocator(attrs) : getBestIOSLocator(attrs)) ?? "";
     }
+    if (!name && platform === "android" && (locator.startsWith("class:") || locator.startsWith('android=new UiSelector().className("'))) {
+      const childText = getFirstChildText(element);
+      if (childText && childText.length < 100) {
+        name = childText;
+      }
+    }
   }
   nodes.push({
     role,
@@ -1445,7 +1589,8 @@ function collectMobileNodes(element, platform, depth, nodes, walkOpts) {
     depth,
     isInteractive: interactive,
     isExplicitInteractive: explicit,
-    isInViewport: inViewport
+    isInViewport: inViewport,
+    tagName: element.tagName
   });
   for (const child of element.children || []) {
     collectMobileNodes(child, platform, depth + 1, nodes, walkOpts);
@@ -2695,88 +2840,6 @@ var RetryTracker = class {
   }
 };
 
-// ../shared/src/files.ts
-var SPEC_FILE_RE = /\.(?:test|spec)\.[cm]?[jt]sx?$/i;
-
-// ../shared/src/routes.ts
-var WS_PATHS = {
-  /** Adapter session upgrade endpoint. One socket per running adapter. */
-  worker: "/worker",
-  /** App/UI client upgrade endpoint. Multiple browser tabs may connect. */
-  client: "/client"
-};
-var WS_SCOPE = {
-  /** Backend → worker: a dashboard client has subscribed. Wakes up the
-   *  adapter's `await UI ready` gate before tests start. */
-  clientConnected: "clientConnected",
-  /** Backend → worker: the last dashboard tab closed. Triggers the
-   *  interactive shutdown flow (close WS, exit, pkill the dashboard). */
-  clientDisconnected: "clientDisconnected",
-  /** Worker → backend → clients (or app-local): wipe the visualization data
-   *  for a specific test/suite uid (or the whole tree). */
-  clearExecutionData: "clearExecutionData",
-  /** Worker → backend: clear-by-test-uid request (drives clearExecutionData). */
-  clearCommands: "clearCommands",
-  /** Backend → clients: signal that the active run was stopped by the UI. */
-  testStopped: "testStopped",
-  /** Worker → backend → clients: swap an earlier captured command for an
-   *  updated entry (used when a retry coalesces commands). */
-  replaceCommand: "replaceCommand",
-  /** Worker → backend: register the config file path so reruns can spawn
-   *  with the same config. */
-  config: "config"
-};
-
-// ../shared/src/runner.ts
-var REUSE_ENV = {
-  REUSE: "DEVTOOLS_APP_REUSE",
-  HOST: "DEVTOOLS_APP_HOST",
-  PORT: "DEVTOOLS_APP_PORT",
-  RERUN_LABEL: "DEVTOOLS_RERUN_LABEL",
-  RERUN_ENTRY_TYPE: "DEVTOOLS_RERUN_ENTRY_TYPE"
-};
-
-// ../shared/src/timing.ts
-var TIMING_BASE = {
-  /** ms to let the dashboard render between rapid state updates. */
-  UI_RENDER_DELAY: 150,
-  /** ms to wait after a test starts before flushing initial state. */
-  TEST_START_DELAY: 100,
-  /** ms gap between consecutive suite-finalize broadcasts. */
-  SUITE_COMPLETE_DELAY: 200,
-  /** ms allowed for the browser-close handshake before forcing teardown. */
-  BROWSER_CLOSE_WAIT: 2e3,
-  /** ms before first worker WS connection attempt — lets backend bind. */
-  INITIAL_CONNECTION_WAIT: 500,
-  /** ms between browser-window-alive polls. */
-  BROWSER_POLL_INTERVAL: 1e3
-};
-var DEFAULTS_BASE = {
-  /** Synthetic capability ID — present on every CommandLog / TestStats. */
-  CID: "0-0",
-  /** TestStats.retries default — adapters that surface retry counts override. */
-  RETRIES: 0,
-  /** _duration placeholder for not-yet-finalized stats. */
-  DURATION: 0
-};
-
-// ../shared/src/types.ts
-var TEST_STATE = {
-  PENDING: "pending",
-  RUNNING: "running",
-  PASSED: "passed",
-  FAILED: "failed",
-  SKIPPED: "skipped"
-};
-var SCREENCAST_DEFAULTS = {
-  enabled: false,
-  captureFormat: "jpeg",
-  quality: 70,
-  maxWidth: 1280,
-  maxHeight: 720,
-  pollIntervalMs: 200
-};
-
 // ../core/src/screencast.ts
 var ScreencastRecorderBase = class {
   buffer = [];