@testspectra/skills 1.2.42 → 1.2.44

package/dist/skills/matchers-and-assertions/SKILL.md

@@ -100,6 +100,22 @@ intercept handle's, after a deliberate `delayMs`) — see the `network-intercept
 await ReportPage.statusBadge.shouldHaveText('Ready', { timeoutMs: 5000 });
 ```
 
+**Whose failure** — `err.name` tells the app's verdict from the machine's: every `should*` throws `AssertionError`; a hung tab or browser, a closed tab, a device or run timeout throw `CdpTimeoutError`, `BrowserHungError`, `CdpSocketClosedError`, `DriverTimeoutError`, `CaseAbortedError` or `TimeoutError`. To collect several differences from a spec and fail with all of them at the end, catch only `AssertionError` and rethrow the rest (never `.catch(() => {})` around an assertion: that passes the case):
+
+```typescript
+const open: string[] = [];
+const check = async (where: string, assertion: () => Promise<void>) => {
+  try {
+    await assertion();
+  } catch (err) {
+    if (!(err instanceof Error) || err.name !== 'AssertionError') throw err;
+    open.push(`${where}: ${err.message}`);
+  }
+};
+await check('amount', () => Page.amount.shouldHaveValue('10.50'));
+if (open.length > 0) throw new Error(`${open.length} open gap(s):\n${open.join('\n')}`);
+```
+
 ---
 
 ## 3. Collection Matchers (on `Spectra.getAll(selector)` getters)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/skills",
-  "version": "1.2.42",
+  "version": "1.2.44",
   "description": "Installer & manager for modular AI agent skills that standardize TestSpectra script authoring (specs, page objects, steps, actions, hooks, fixtures, matchers)",
   "keywords": [
     "agents",

package/skills/matchers-and-assertions/SKILL.md

@@ -100,6 +100,22 @@ intercept handle's, after a deliberate `delayMs`) — see the `network-intercept
 await ReportPage.statusBadge.shouldHaveText('Ready', { timeoutMs: 5000 });
 ```
 
+**Whose failure** — `err.name` tells the app's verdict from the machine's: every `should*` throws `AssertionError`; a hung tab or browser, a closed tab, a device or run timeout throw `CdpTimeoutError`, `BrowserHungError`, `CdpSocketClosedError`, `DriverTimeoutError`, `CaseAbortedError` or `TimeoutError`. To collect several differences from a spec and fail with all of them at the end, catch only `AssertionError` and rethrow the rest (never `.catch(() => {})` around an assertion: that passes the case):
+
+```typescript
+const open: string[] = [];
+const check = async (where: string, assertion: () => Promise<void>) => {
+  try {
+    await assertion();
+  } catch (err) {
+    if (!(err instanceof Error) || err.name !== 'AssertionError') throw err;
+    open.push(`${where}: ${err.message}`);
+  }
+};
+await check('amount', () => Page.amount.shouldHaveValue('10.50'));
+if (open.length > 0) throw new Error(`${open.length} open gap(s):\n${open.join('\n')}`);
+```
+
 ---
 
 ## 3. Collection Matchers (on `Spectra.getAll(selector)` getters)