objs-core 2.2.0 → 2.3.0

package/README.md

@@ -25,8 +25,20 @@
 
 ---
 
+### Update v2.3: New features
+- **Recording: extended events** — Default events now include `submit`, `keydown`, `focus`, `blur` in addition to click, input, change, scroll, mouseover.
+- **Recording: extended attributes** — MutationObserver records `style`, `hidden`, `disabled`, `aria-expanded`, `aria-checked` (not just class). Assertions and Playwright export support all types.
+- **Playwright export: real expect()** — All assertion types emit `expect()` calls: `toHaveClass`, `toHaveCSS`, `toBeHidden`, `toBeDisabled`, `toHaveAttribute` for aria-*.
+- **Network: XHR interception** — Captures `XMLHttpRequest` alongside `fetch`; GET/POST/PUT with request and response body stored in mocks.
+- **Playwright export: route verification** — Generated route handlers verify request method and body (POST/PUT) before fulfilling.
+- **WebSocket monitoring** — Records WebSocket connections and messages (in/out); Playwright export includes `framereceived`/`framesent` assertions.
+- **Recording: blur/focus on removed elements** — Blur and focus events on elements removed by the previous action (e.g. click delete) are not recorded.
+- **Test overlay: async steps** — `onComplete` callback now runs when manual check (Promise) resolves; overlay counter and panel display correctly.
+
+---
+
 ### Update v2.2: New features
-- **`<div>${objInstance}</div>`** — ObjsInstance has `toString()` and `Symbol.toPrimitive`; use in template literals without `.html()` call. The HTML is inserted and auto-hydrated when the parent sets `innerHTML` (e.g. `html: \`<div>${child}</div>\`` in render).
+- **<div>${objInstance}</div>** — Objs instance has `toString()` and `Symbol.toPrimitive`; use in template literals without `.html()` call. The HTML is inserted and auto-hydrated when the parent sets `innerHTML` (e.g. html: &#96;&lt;div&gt;${child}&lt;/div&gt;&#96; in render()).
 - **o.playRecording(recording, opts)** — Extended options: `runAssertions`, `root`, `actionDelay`, `manualChecks`, `onComplete`. Assertions verification and manual checks are natively supported. [Recording example](https://foggysq.github.io/objs/examples/recording/index.html) updated.
 - **o.test(title, ..., { confirmOnFailure, confirmOnFailureTimeout })** — If a step fails, show overlay "Continue?" / "Stop" instead of aborting. Use `confirmOnFailure: true` and optionally `confirmOnFailureTimeout` (ms).
 - **o.test(title, ..., { sync: true })** — Run steps synchronously (one after another) instead of async; useful for playRecording.
@@ -102,6 +114,11 @@
 <script src="objs.js" type="text/javascript"></script>
 ```
 
+**Browser (smaller)** — minified `objs.built.min.js` for production. Use `type="module"`:
+```html
+<script src="objs.min.js" type="module"></script>
+```
+
 **npm / bundler** — correct file chosen automatically via `package.json` exports:
 ```js
 import o from 'objs-core';  // resolves to objs.built.js

package/objs.built.js

@@ -1875,17 +1875,26 @@ o.test = (title = "", ...tests) => {
   });
   const finalize = () => {
     if (o.tFinalized[testN2]) return;
+    if (waits > 0) {
+      row = "\u251C ";
+      row += "DONE " + done + "/" + num + ", waiting: " + waits;
+      log(row, true);
+      if (o.tStyled) {
+        o.tLog[testN2] += o.tPre + '<div style="color:orange;"><b>DONE ' + done + "/" + num + ", waiting: " + waits + "</b>" + o.tDc + o.tDc;
+      } else {
+        o.tLog[testN2] += row + "\n";
+      }
+      return;
+    }
     o.tFinalized[testN2] = true;
     const anyFailed = o.tStatus[testN2].some((s) => s === false);
     o.tRes[testN2] = !anyFailed && done === num;
-    row = waits ? "\u251C " : "\u2558 ";
-    row += "DONE " + done + "/" + num + (waits ? ", waiting: " + waits : "");
-    log(row, done + waits !== num);
-    if (!waits) {
-      log();
-    }
+    row = "\u2558 ";
+    row += "DONE " + done + "/" + num;
+    log(row, done !== num);
+    log();
     if (o.tStyled) {
-      o.tLog[testN2] += o.tPre + '<div style="color:' + (done + waits !== num ? "red" : "green") + ';"><b>DONE ' + done + "/" + num + (waits ? ", waiting: " + waits : "") + "</b>" + o.tDc + o.tDc;
+      o.tLog[testN2] += o.tPre + '<div style="color:' + (done !== num ? "red" : "green") + ';"><b>DONE ' + done + "/" + num + "</b>" + o.tDc + o.tDc;
     } else {
       o.tLog[testN2] += row + "\n";
     }
@@ -1894,7 +1903,7 @@ o.test = (title = "", ...tests) => {
       sessionStorage.setItem(`oTest-Res-${testN2}`, o.tRes[testN2]);
       sessionStorage.setItem(`oTest-Status-${testN2}`, JSON.stringify(o.tStatus[testN2]));
     }
-    if (!waits && typeof o.tFns[testN2] === "function") {
+    if (typeof o.tFns[testN2] === "function") {
       o.tFns[testN2](testN2);
     }
   };
@@ -2248,17 +2257,37 @@ o.startRecording = (observe, events, timeouts) => {
   if (o.recorder.active) {
     return;
   }
-  const defaultEvents = ["click", "mouseover", "scroll", "input", "change"];
+  const defaultEvents = [
+    "click",
+    "mouseover",
+    "scroll",
+    "input",
+    "change",
+    "submit",
+    "keydown",
+    "focus",
+    "blur"
+  ];
   const defaultStepDelays = {
     click: 100,
     mouseover: 50,
     scroll: 30,
     input: 50,
-    change: 50
+    change: 50,
+    submit: 100,
+    keydown: 50,
+    focus: 50,
+    blur: 50
   };
   const listenEvents = events || defaultEvents;
   const stepDelays = Object.assign({}, defaultStepDelays, timeouts || {});
-  const captureDebounce = { scroll: 30, mouseover: 50 };
+  const captureDebounce = {
+    scroll: 30,
+    mouseover: 50,
+    keydown: 50,
+    focus: 50,
+    blur: 50
+  };
   const rec = o.recorder;
   rec.active = true;
   rec.actions = [];
@@ -2300,6 +2329,67 @@ o.startRecording = (observe, events, timeouts) => {
     };
     return response;
   };
+  rec._originalXHROpen = XMLHttpRequest.prototype.open;
+  rec._originalXHRSend = XMLHttpRequest.prototype.send;
+  XMLHttpRequest.prototype.open = function(method, url) {
+    this._oMethod = (method || "GET").toUpperCase();
+    this._oUrl = url;
+    return rec._originalXHROpen.apply(this, arguments);
+  };
+  XMLHttpRequest.prototype.send = function(body) {
+    const capture = () => {
+      if (this.readyState !== 4) return;
+      let reqBody;
+      try {
+        reqBody = body ? JSON.parse(body) : void 0;
+      } catch (_e) {
+        reqBody = body;
+      }
+      let respBody;
+      try {
+        const text = this.responseText;
+        respBody = text ? JSON.parse(text) : null;
+      } catch (_e) {
+        respBody = this.responseText ?? null;
+      }
+      const key = (this._oMethod || "GET") + ":" + (this._oUrl || "");
+      rec.mocks[key] = {
+        url: this._oUrl,
+        method: this._oMethod,
+        request: reqBody,
+        response: respBody,
+        status: this.status
+      };
+    };
+    this.addEventListener("readystatechange", capture);
+    return rec._originalXHRSend.apply(this, arguments);
+  };
+  rec.websocketEvents = [];
+  rec._originalWebSocket = window.WebSocket;
+  window.WebSocket = function(url, protocols) {
+    const ws = new rec._originalWebSocket(url, protocols);
+    const id = rec.websocketEvents.length;
+    rec.websocketEvents.push({
+      url: typeof url === "string" ? url : String(url),
+      protocol: Array.isArray(protocols) ? protocols[0] : protocols,
+      open: true,
+      messages: []
+    });
+    ws.addEventListener("message", (e) => {
+      const data = typeof e.data === "string" ? e.data : String(e.data);
+      rec.websocketEvents[id].messages.push({ dir: "in", data });
+    });
+    ws.addEventListener("close", () => {
+      rec.websocketEvents[id].open = false;
+    });
+    const origSend = ws.send.bind(ws);
+    ws.send = function(data) {
+      const d = typeof data === "string" ? data : String(data);
+      rec.websocketEvents[id].messages.push({ dir: "out", data: d });
+      return origSend(data);
+    };
+    return ws;
+  };
   const unstableDataAttrs = { "data-o-init": 1, "data-o-init-i": 1, "data-o-state": 1 };
   const qualify = (sel, fromNode) => {
     if (o.D.querySelectorAll(sel).length <= 1) return sel;
@@ -2449,28 +2539,51 @@ o.startRecording = (observe, events, timeouts) => {
         });
       }
       if (m.type === "attributes") {
+        const attr = m.attributeName;
+        if (!attr) return;
         const sel = buildSelector(m.target);
         if (!sel) return;
+        const attrToType = {
+          class: "class",
+          style: "style",
+          hidden: "hidden",
+          disabled: "disabled",
+          "aria-expanded": "aria-expanded",
+          "aria-checked": "aria-checked"
+        };
+        const type = attrToType[attr];
+        if (!type) return;
         if (rec.assertions.some(
-          (a2) => a2.actionIdx === actionIdx && a2.selector === sel && a2.type === "class"
+          (a2) => a2.actionIdx === actionIdx && a2.selector === sel && a2.type === type
         ))
           return;
         const { listSelector: aListSel, index: aIdx } = addAssertionIndex(sel, m.target);
-        const a = {
-          actionIdx,
-          type: "class",
-          selector: sel,
-          className: m.target.className
-        };
+        const el = m.target;
+        let value;
+        if (type === "class") value = el.className;
+        else if (type === "style") value = el.style?.cssText || el.getAttribute("style") || "";
+        else if (type === "hidden") value = el.hidden;
+        else if (type === "disabled") value = el.disabled === true;
+        else if (type === "aria-expanded")
+          value = el.getAttribute("aria-expanded");
+        else if (type === "aria-checked") value = el.getAttribute("aria-checked");
+        const a = { actionIdx, type, selector: sel };
+        if (type === "class") a.className = value;
+        else if (type === "style") a.style = value;
+        else if (type === "hidden") a.hidden = value;
+        else if (type === "disabled") a.disabled = value;
+        else if (type === "aria-expanded") a.ariaExpanded = value;
+        else if (type === "aria-checked") a.ariaChecked = value;
         if (aListSel != null) a.listSelector = aListSel;
         if (aIdx != null) a.index = aIdx;
         rec.assertions.push(a);
         if (o.recordingAssertionDebug && typeof console !== "undefined" && console.log) {
-          console.log("[recording] +class assertion:", {
+          console.log("[recording] +attr assertion:", {
             actionIdx,
             lastAction: lastAction?.type + " " + lastAction?.target,
             selector: sel,
-            className: m.target.className,
+            type,
+            value,
             index: aIdx,
             listSelector: aListSel
           });
@@ -2537,13 +2650,30 @@ o.startRecording = (observe, events, timeouts) => {
       const scrollY = ev === "scroll" ? window.scrollY : void 0;
       const value = ev === "input" || ev === "change" ? target?.value : void 0;
       const checked = ev === "change" && (target?.type === "checkbox" || target?.type === "radio") ? target?.checked : void 0;
-      const delay = ev === "click" || ev === "change" ? 0 : stepDelays[ev] !== void 0 ? stepDelays[ev] : captureDebounce[ev] ?? 0;
+      const key = ev === "keydown" ? target?.key : void 0;
+      const code = ev === "keydown" ? target?.code : void 0;
+      const delay = ev === "click" || ev === "change" || ev === "submit" ? 0 : stepDelays[ev] !== void 0 ? stepDelays[ev] : captureDebounce[ev] ?? 0;
       const pushAction = () => {
+        if ((ev === "blur" || ev === "focus") && selector) {
+          const lastIdx = rec.actions.length - 1;
+          const lastAction = lastIdx >= 0 ? rec.actions[lastIdx] : null;
+          if (lastAction) {
+            const sameTarget = lastAction.target === selector && lastAction.listSelector == null === (listSelector == null) && lastAction.targetIndex == null === (targetIndex == null) && (lastAction.targetIndex == null || lastAction.targetIndex === targetIndex);
+            if (sameTarget) return;
+            for (const r of rec.removedElements) {
+              if (r.actionIdx !== lastIdx) continue;
+              if (r.selector === selector || selector.startsWith(r.selector + " ") || selector.startsWith(r.selector + ">"))
+                return;
+            }
+          }
+        }
         const action = { type: ev, target: selector, time: Date.now() };
         if (targetType) action.targetType = targetType;
         if (scrollY !== void 0) action.scrollY = scrollY;
         if (value !== void 0) action.value = value;
         if (checked !== void 0) action.checked = checked;
+        if (key !== void 0) action.key = key;
+        if (code !== void 0) action.code = code;
         if (listSelector != null) action.listSelector = listSelector;
         if (targetIndex != null) action.targetIndex = targetIndex;
         rec.actions.push(action);
@@ -2566,6 +2696,16 @@ o.stopRecording = () => {
     window.fetch = rec._originalFetch;
     rec._originalFetch = null;
   }
+  if (rec._originalXHROpen) {
+    XMLHttpRequest.prototype.open = rec._originalXHROpen;
+    XMLHttpRequest.prototype.send = rec._originalXHRSend;
+    rec._originalXHROpen = null;
+    rec._originalXHRSend = null;
+  }
+  if (rec._originalWebSocket) {
+    window.WebSocket = rec._originalWebSocket;
+    rec._originalWebSocket = null;
+  }
   rec._listeners.forEach(({ ev, handler }) => {
     o.D.removeEventListener(ev, handler, true);
   });
@@ -2581,7 +2721,8 @@ o.stopRecording = () => {
     stepDelays: { ...rec.stepDelays },
     assertions: [...rec.assertions || []],
     removedElements: [...rec.removedElements || []],
-    observeRoot: rec.observeRoot || null
+    observeRoot: rec.observeRoot || null,
+    websocketEvents: [...rec.websocketEvents || []]
   };
 };
 o.clearRecording = (id) => {
@@ -2740,6 +2881,50 @@ o.runRecordingAssertions = (recording, root, actionIdx, opts) => {
           });
         }
       }
+    } else if (a.type === "style") {
+      const expected = (a.style || "").trim();
+      const actual = (el?.style?.cssText || el?.getAttribute?.("style") || "").trim();
+      const ok = el && (!expected || actual.indexOf(expected) !== -1 || expected === actual);
+      if (ok) {
+        passed += 1;
+      } else {
+        const msg = !el ? "element not found" : `expected style "${expected.slice(0, 60)}..."`;
+        failures.push({ selector: a.selector, message: msg });
+      }
+    } else if (a.type === "hidden") {
+      const ok = el && el.hidden === a.hidden;
+      if (ok) {
+        passed += 1;
+      } else {
+        const msg = !el ? "element not found" : `expected hidden=${a.hidden}`;
+        failures.push({ selector: a.selector, message: msg });
+      }
+    } else if (a.type === "disabled") {
+      const ok = el && el.disabled === a.disabled;
+      if (ok) {
+        passed += 1;
+      } else {
+        const msg = !el ? "element not found" : `expected disabled=${a.disabled}`;
+        failures.push({ selector: a.selector, message: msg });
+      }
+    } else if (a.type === "aria-expanded") {
+      const actual = el?.getAttribute?.("aria-expanded");
+      const ok = el && (a.ariaExpanded == null || String(actual) === String(a.ariaExpanded));
+      if (ok) {
+        passed += 1;
+      } else {
+        const msg = !el ? "element not found" : `expected aria-expanded="${a.ariaExpanded}"`;
+        failures.push({ selector: a.selector, message: msg });
+      }
+    } else if (a.type === "aria-checked") {
+      const actual = el?.getAttribute?.("aria-checked");
+      const ok = el && (a.ariaChecked == null || String(actual) === String(a.ariaChecked));
+      if (ok) {
+        passed += 1;
+      } else {
+        const msg = !el ? "element not found" : `expected aria-checked="${a.ariaChecked}"`;
+        failures.push({ selector: a.selector, message: msg });
+      }
     }
   }
   return { passed, total: deduped.length, failures };
@@ -2780,14 +2965,23 @@ o.exportTest = (recording, options = {}) => {
       body = (a.value !== void 0 ? `    el.value = ${JSON.stringify(a.value)};
 ` : "") + (a.checked !== void 0 ? `    el.checked = ${a.checked};
 ` : "") + `    el.dispatchEvent(new Event('${a.type}', {bubbles:true}));${endSuffix}`;
+    } else if (a.type === "submit") {
+      body = `    (el.requestSubmit && el.requestSubmit()) || el.submit();${endSuffix}`;
+    } else if (a.type === "keydown") {
+      body = `    el.dispatchEvent(new KeyboardEvent('keydown', {key:${JSON.stringify(a.key || "")}, code:${JSON.stringify(a.code || "")}, bubbles:true, cancelable:true}));${endSuffix}`;
+    } else if (a.type === "focus") {
+      body = `    el.focus();${endSuffix}`;
+    } else if (a.type === "blur") {
+      body = `    el.blur();${endSuffix}`;
     } else {
       const useNativeClick = a.type === "click";
       body = useNativeClick ? `    el.click();${endSuffix}` : `    el.dispatchEvent(new MouseEvent('${a.type}', {bubbles:true,cancelable:true}));${endSuffix}`;
     }
+    const skipIfMissing = a.type === "blur" || a.type === "focus";
     steps.push(
       `  ['${a.type} on ${a.target}', ${stepFn} {
 ` + getEl(a) + `
-    if (!el && '${a.type}' !== 'scroll') return 'element not found: ${a.target.replace(/'/g, "\\'")}';
+    if (!el && '${a.type}' !== 'scroll') { if (${skipIfMissing}) return true; return 'element not found: ${a.target.replace(/'/g, "\\'")}'; }
 ` + body + `  }]`
     );
     const assertsForAction = (recording.assertions || []).filter((x) => x.actionIdx === i);
@@ -2824,15 +3018,40 @@ o.exportPlaywrightTest = (recording, options = {}) => {
   }
   const baseUrl = options.baseUrl || path;
   const routes = Object.values(recording.mocks).map((mock) => {
-    const urlPath = mock.url.startsWith("/") ? mock.url : "/" + mock.url;
-    const body = JSON.stringify(mock.response);
+    let urlPath = mock.url;
+    try {
+      urlPath = new URL(mock.url).pathname || urlPath;
+    } catch (_e) {
+    }
+    if (!urlPath.startsWith("/")) urlPath = "/" + urlPath;
+    const respBody = JSON.stringify(mock.response);
+    const reqBody = JSON.stringify(mock.request);
+    const method = (mock.method || "GET").toUpperCase();
+    let verify = `    if (route.request().method() !== ${JSON.stringify(method)}) { await route.continue(); return; }
+`;
+    if (mock.request != null && (method === "POST" || method === "PUT" || method === "PATCH")) {
+      verify += `    const postData = route.request().postData();
+    const body = (() => { try { return JSON.parse(postData || '{}'); } catch { return {}; } })();
+    expect(body).toEqual(${reqBody});
+`;
+    }
     return `  await page.route('**${urlPath}', async route => {
-    await route.fulfill({ status: ${mock.status || 200}, contentType: 'application/json',
-      body: JSON.stringify(${body}) });
+` + verify + `    await route.fulfill({ status: ${mock.status || 200}, contentType: 'application/json',
+      body: JSON.stringify(${respBody}) });
   });`;
   }).join("\n");
   const sd = Object.assign(
-    { click: 100, mouseover: 50, scroll: 30, input: 50, change: 50 },
+    {
+      click: 100,
+      mouseover: 50,
+      scroll: 30,
+      input: 50,
+      change: 50,
+      submit: 100,
+      keydown: 50,
+      focus: 50,
+      blur: 50
+    },
     recording.stepDelays || {}
   );
   const steps = recording.actions.map((action, i) => {
@@ -2857,6 +3076,15 @@ o.exportPlaywrightTest = (recording, options = {}) => {
       } else {
         step = `  await ${loc}.fill(${JSON.stringify(action.value || "")});`;
       }
+    } else if (action.type === "submit") {
+      step = `  await ${loc}.evaluate((el) => el.requestSubmit?.() || el.submit());`;
+    } else if (action.type === "keydown") {
+      const key = action.key || "";
+      step = key === "Enter" ? `  await ${loc}.press("Enter");` : key ? `  await ${loc}.press(${JSON.stringify(key)});` : `  await ${loc}.press(${JSON.stringify(action.code || "")});`;
+    } else if (action.type === "focus") {
+      step = `  if (await ${loc}.count() > 0) await ${loc}.focus();`;
+    } else if (action.type === "blur") {
+      step = `  if (await ${loc}.count() > 0) await ${loc}.blur();`;
     } else {
       step = `  await ${loc}.click();`;
     }
@@ -2874,13 +3102,50 @@ o.exportPlaywrightTest = (recording, options = {}) => {
         return s;
       }
       if (a.type === "class") {
-        return `  // class on ${a.selector} changed to: "${a.className}"`;
+        const classes = (a.className || "").trim().split(/\s+/).filter(Boolean);
+        if (classes.length > 0)
+          return classes.map((c) => `  await expect(${aLoc}).toHaveClass(${JSON.stringify(c)});`).join("\n");
+        return `  // class on ${a.selector} (no specific classes asserted)`;
+      }
+      if (a.type === "style") {
+        const style = (a.style || "").trim();
+        if (style) {
+          const m = style.match(/(\w+)\s*:\s*([^;]+)/);
+          if (m)
+            return `  await expect(${aLoc}).toHaveCSS(${JSON.stringify(m[1])}, ${JSON.stringify(m[2].trim())});`;
+          return `  await expect(${aLoc}).toHaveAttribute("style", ${JSON.stringify(style)});`;
+        }
+        return "";
+      }
+      if (a.type === "hidden") {
+        return a.hidden ? `  await expect(${aLoc}).toBeHidden();` : `  await expect(${aLoc}).toBeVisible();`;
+      }
+      if (a.type === "disabled") {
+        return a.disabled ? `  await expect(${aLoc}).toBeDisabled();` : `  await expect(${aLoc}).toBeEnabled();`;
+      }
+      if (a.type === "aria-expanded" && a.ariaExpanded != null) {
+        return `  await expect(${aLoc}).toHaveAttribute("aria-expanded", ${JSON.stringify(String(a.ariaExpanded))});`;
+      }
+      if (a.type === "aria-checked" && a.ariaChecked != null) {
+        return `  await expect(${aLoc}).toHaveAttribute("aria-checked", ${JSON.stringify(String(a.ariaChecked))});`;
       }
       return "";
     }).filter(Boolean).join("\n");
     return step + "\n" + wait + (asserts ? "\n" + asserts : "");
   }).join("\n");
   const hasAutoAssertions = (recording.assertions || []).length > 0;
+  const wsEvents = recording.websocketEvents || [];
+  const hasWsEvents = wsEvents.length > 0 && wsEvents.some((c) => c.messages?.length > 0);
+  const wsSetup = hasWsEvents ? `  const wsCollected = [];
+  page.on('websocket', ws => {
+    ws.on('framereceived', ev => wsCollected.push({ dir: 'in', payload: typeof ev.payload === 'string' ? ev.payload : String(ev.payload) }));
+    ws.on('framesent', ev => wsCollected.push({ dir: 'out', payload: typeof ev.payload === 'string' ? ev.payload : String(ev.payload) }));
+  });
+
+` : "";
+  const wsAssertions = hasWsEvents ? wsEvents.flatMap((conn) => (conn.messages || []).map((msg) => ({ dir: msg.dir, data: msg.data }))).map(
+    (msg) => `  expect(wsCollected).toContainEqual({ dir: ${JSON.stringify(msg.dir)}, payload: ${JSON.stringify(msg.data)} });`
+  ).join("\n") + "\n\n" : "";
   return `// Auto-generated by o.exportPlaywrightTest() \u2014 review and anonymize mocks before committing
 // Prerequisites: npm install @playwright/test && npx playwright install chromium
 // Run: npx playwright test recorded.spec.ts
@@ -2888,15 +3153,16 @@ import { test, expect } from '@playwright/test';
 
 test(${JSON.stringify(testName)}, async ({ page }) => {
 ` + (routes ? `  // Network mocks \u2014 edit/anonymize before committing
-` + routes + "\n\n" : "") + `  // Set baseURL in playwright.config.ts: { use: { baseURL: 'https://staging.example.com' } }
+` + routes + "\n\n" : "") + wsSetup + `  // Set baseURL in playwright.config.ts: { use: { baseURL: 'https://staging.example.com' } }
   await page.goto(${JSON.stringify(baseUrl)});
 
-` + (steps ? steps + "\n\n" : "") + (!hasAutoAssertions ? `  // TODO: Add assertions before committing, e.g.:
+` + (steps ? steps + "\n\n" : "") + (wsAssertions ? `  // WebSocket verifications
+` + wsAssertions : "") + (!hasAutoAssertions && !hasWsEvents ? `  // TODO: Add assertions before committing, e.g.:
   // await expect(page.locator('[data-qa="success-panel"]')).toBeVisible();
   // await expect(page).toHaveURL(/\\/confirmation/);
   // await expect(page.locator('[data-qa="error-banner"]')).not.toBeVisible();
-` : `  // Auto-generated assertions above \u2014 review for correctness before committing
-`) + `});
+` : hasAutoAssertions || hasWsEvents ? `  // Auto-generated assertions above \u2014 review for correctness before committing
+` : "") + `});
 `;
 };
 o.playRecording = (recording, opts = {}) => {
@@ -2918,6 +3184,32 @@ o.playRecording = (recording, opts = {}) => {
     }
     return origFetch(url, opts2);
   };
+  const origXHROpen = XMLHttpRequest.prototype.open;
+  const origXHRSend = XMLHttpRequest.prototype.send;
+  XMLHttpRequest.prototype.open = function(method, url) {
+    this._oMethod = (method || "GET").toUpperCase();
+    this._oUrl = url;
+    return origXHROpen.apply(this, arguments);
+  };
+  XMLHttpRequest.prototype.send = function(body) {
+    const xhr = this;
+    const key = (xhr._oMethod || "GET") + ":" + (xhr._oUrl || "");
+    const mock = allMocks[key];
+    if (mock) {
+      const respBody = typeof mock.response === "string" ? mock.response : JSON.stringify(mock.response);
+      setTimeout(() => {
+        xhr.readyState = 4;
+        xhr.status = mock.status || 200;
+        xhr.statusText = "OK";
+        xhr.responseText = respBody;
+        xhr.response = respBody;
+        xhr.dispatchEvent(new Event("readystatechange"));
+        xhr.dispatchEvent(new Event("load"));
+      }, 0);
+      return;
+    }
+    return origXHRSend.apply(this, arguments);
+  };
   const resolveRoot = () => {
     if (rootOpt != null) {
       return typeof rootOpt === "string" ? o.D.querySelector(rootOpt) || o.D.body : rootOpt;
@@ -2976,6 +3268,7 @@ o.playRecording = (recording, opts = {}) => {
           }
         }
         if (!el && action.type !== "scroll") {
+          if (action.type === "blur" || action.type === "focus") return true;
           return `element not found: ${action.target}`;
         }
         if (action.type === "scroll") {
@@ -2984,6 +3277,22 @@ o.playRecording = (recording, opts = {}) => {
           if (action.value !== void 0) el.value = action.value;
           if (action.checked !== void 0) el.checked = action.checked;
           el.dispatchEvent(new Event(action.type, { bubbles: true }));
+        } else if (action.type === "submit") {
+          if (typeof el.requestSubmit === "function") el.requestSubmit();
+          else el.submit();
+        } else if (action.type === "keydown") {
+          el.dispatchEvent(
+            new KeyboardEvent("keydown", {
+              key: action.key || "",
+              code: action.code || "",
+              bubbles: true,
+              cancelable: true
+            })
+          );
+        } else if (action.type === "focus") {
+          el.focus();
+        } else if (action.type === "blur") {
+          el.blur();
         } else {
           if (action.type === "click") {
             el.click();
@@ -3034,6 +3343,8 @@ o.playRecording = (recording, opts = {}) => {
   const onComplete = isOptions && opts.onComplete;
   const testId = o.test("Recorded playback", ...testCases, { sync: true }, (testId2) => {
     window.fetch = origFetch;
+    XMLHttpRequest.prototype.open = origXHROpen;
+    XMLHttpRequest.prototype.send = origXHRSend;
     const assertionResult = runAssertions && assertions.length > 0 ? assertionAccum : void 0;
     if (assertionResult?.failures?.length > 0) {
       o.tRes[testId2] = false;