@testspectra/skills 1.2.31 → 1.2.33

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

@@ -173,13 +173,24 @@ collection carry the scope forward too. No behavior difference on web vs. Androi
 | `await Spectra.browser.openTab(url?, { isolated: true })` | Open a tab as a second browser: own cookies and storage            |
 | `await Spectra.browser.switchToTab(index)`                | Act on tab `index` (0 = first; tabs the app opens follow in order) |
 | `await Spectra.browser.closeTab()`                        | Close the active tab (any but the last), act on the one before     |
+| `await Spectra.browser.openTab({ userAgent })`            | Open a tab whose user agent is `userAgent` (also with `isolated`)  |
 | `await Spectra.browser.shouldHaveTabCount(n)`             | Assert `n` tabs open                                               |
+| `await Spectra.browser.getClipboardText()`                | Read the page clipboard (origin granted `clipboardReadWrite`)      |
+| `await Spectra.browser.shouldHaveClipboardText(text)`     | Assert the clipboard text, polling                                 |
+| `await Spectra.browser.getPageLoadCount(tab?)`            | Loads of a tab since the test case began / the tab attached        |
+| `await Spectra.browser.shouldHavePageLoadCount(n, { tab? })` | Assert a tab's load count: only the refreshed tab grew          |
+| `await Spectra.browser.waitForDownload({ timeout? })`     | Next file the page downloads: `{ fileName, path, size, text(), rows() }` |
+| `await file.shouldHaveRows(rows, { header? })`            | Assert the CSV / first XLSX sheet; `header: false`: `rows` omit the header row |
+| `await file.shouldContainRow(row)`                        | Assert one row of the file equals `row`                            |
+| `await Spectra.browser.shouldHaveDownloaded(name \| /re/)` | Assert a download with that name completed, polling                |
+| `await Spectra.browser.shouldNotHaveDownloaded({ within? })` | Assert no download this test case, nor in `within` ms (1000)    |
+| `await Spectra.browser.shouldHaveDownloadCount(n)`        | Assert `n` downloads completed                                     |
 | `await Spectra.browser.installClock()`                    | Fake page clock, before the page loads                             |
 | `await Spectra.browser.advanceClock(ms)`                  | Jump the clock; timers that fall due run                           |
 | `await Spectra.browser.shouldHaveOpenedDialog(msg?)`      | Assert a JS dialog opened (each is answered as it opens)           |
 | `await Spectra.browser.shouldNotHaveOpenedDialog()`       | Assert none opened, nor opens for 500ms                            |
 
-Tabs, the clock and dialogs are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
+Tabs, the clock, dialogs and downloads are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs or downloads recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
 
 ---
 

package/dist/skills/network-interception/SKILL.md

@@ -35,6 +35,7 @@ interface MockHandle {
   shouldHaveCallCount(count: number, options?: { timeout?: number }): Promise<void>; // polls; 0 proves no request went out
   shouldHaveStatus(status: number, options?: { count?: number; timeout?: number }): Promise<void>; // default: the last answer
   shouldHaveRequestBody(expected: string | object, options?: { timeout?: number }): Promise<void>; // object: JSON subset; string: substring
+  shouldHaveResponseBody(expected: string | object, options?: { count?: number; timeout?: number }): Promise<void>; // the answer's body; default: the last
   readonly callCount: number;
   readonly calls: InterceptedRequest[];
 }
@@ -141,12 +142,15 @@ await OtpPage.boxes.setValue('000000');
 await verify.waitForResponse(); // default timeout: the implicit wait
 await verify.shouldHaveStatus(422);
 await verify.shouldHaveRequestBody({ code: '000000' });
+await verify.shouldHaveResponseBody({ reason: 'invalid_code' }); // the response body: JSON subset or substring
 await OtpPage.error.shouldHaveText('Invalid code');
 ```
 
 The spy handle has the same `waitForResponse` / `shouldHaveCallCount` / `shouldHaveStatus` /
-`shouldHaveRequestBody` / `callCount` / `calls` as above. Only requests answered after the spy is
-made count. `requestBody` is cut to 500 characters: expect a part of a long body as a string.
+`shouldHaveRequestBody` / `shouldHaveResponseBody` / `callCount` / `calls` as above. Only requests
+answered after the spy is made count. `requestBody` and `responseBody` are cut to 500 characters:
+expect a part of a long body as a string. `responseBody` is recorded for text Fetch/XHR responses
+only; any other fails the assertion saying why.
 
 Intercept with `delayMs` only when the step reads the page while the request is in flight; then
 `waitForResponse()` before checking the result:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/skills",
-  "version": "1.2.31",
+  "version": "1.2.33",
   "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

@@ -173,13 +173,24 @@ collection carry the scope forward too. No behavior difference on web vs. Androi
 | `await Spectra.browser.openTab(url?, { isolated: true })` | Open a tab as a second browser: own cookies and storage            |
 | `await Spectra.browser.switchToTab(index)`                | Act on tab `index` (0 = first; tabs the app opens follow in order) |
 | `await Spectra.browser.closeTab()`                        | Close the active tab (any but the last), act on the one before     |
+| `await Spectra.browser.openTab({ userAgent })`            | Open a tab whose user agent is `userAgent` (also with `isolated`)  |
 | `await Spectra.browser.shouldHaveTabCount(n)`             | Assert `n` tabs open                                               |
+| `await Spectra.browser.getClipboardText()`                | Read the page clipboard (origin granted `clipboardReadWrite`)      |
+| `await Spectra.browser.shouldHaveClipboardText(text)`     | Assert the clipboard text, polling                                 |
+| `await Spectra.browser.getPageLoadCount(tab?)`            | Loads of a tab since the test case began / the tab attached        |
+| `await Spectra.browser.shouldHavePageLoadCount(n, { tab? })` | Assert a tab's load count: only the refreshed tab grew          |
+| `await Spectra.browser.waitForDownload({ timeout? })`     | Next file the page downloads: `{ fileName, path, size, text(), rows() }` |
+| `await file.shouldHaveRows(rows, { header? })`            | Assert the CSV / first XLSX sheet; `header: false`: `rows` omit the header row |
+| `await file.shouldContainRow(row)`                        | Assert one row of the file equals `row`                            |
+| `await Spectra.browser.shouldHaveDownloaded(name \| /re/)` | Assert a download with that name completed, polling                |
+| `await Spectra.browser.shouldNotHaveDownloaded({ within? })` | Assert no download this test case, nor in `within` ms (1000)    |
+| `await Spectra.browser.shouldHaveDownloadCount(n)`        | Assert `n` downloads completed                                     |
 | `await Spectra.browser.installClock()`                    | Fake page clock, before the page loads                             |
 | `await Spectra.browser.advanceClock(ms)`                  | Jump the clock; timers that fall due run                           |
 | `await Spectra.browser.shouldHaveOpenedDialog(msg?)`      | Assert a JS dialog opened (each is answered as it opens)           |
 | `await Spectra.browser.shouldNotHaveOpenedDialog()`       | Assert none opened, nor opens for 500ms                            |
 
-Tabs, the clock and dialogs are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
+Tabs, the clock, dialogs and downloads are web only, and reset when the next test case starts: one tab, no fake clock, no dialogs or downloads recorded. Install the clock before `Spectra.navigate`: timers the current document started earlier do not move.
 
 ---
 

package/skills/network-interception/SKILL.md

@@ -35,6 +35,7 @@ interface MockHandle {
   shouldHaveCallCount(count: number, options?: { timeout?: number }): Promise<void>; // polls; 0 proves no request went out
   shouldHaveStatus(status: number, options?: { count?: number; timeout?: number }): Promise<void>; // default: the last answer
   shouldHaveRequestBody(expected: string | object, options?: { timeout?: number }): Promise<void>; // object: JSON subset; string: substring
+  shouldHaveResponseBody(expected: string | object, options?: { count?: number; timeout?: number }): Promise<void>; // the answer's body; default: the last
   readonly callCount: number;
   readonly calls: InterceptedRequest[];
 }
@@ -141,12 +142,15 @@ await OtpPage.boxes.setValue('000000');
 await verify.waitForResponse(); // default timeout: the implicit wait
 await verify.shouldHaveStatus(422);
 await verify.shouldHaveRequestBody({ code: '000000' });
+await verify.shouldHaveResponseBody({ reason: 'invalid_code' }); // the response body: JSON subset or substring
 await OtpPage.error.shouldHaveText('Invalid code');
 ```
 
 The spy handle has the same `waitForResponse` / `shouldHaveCallCount` / `shouldHaveStatus` /
-`shouldHaveRequestBody` / `callCount` / `calls` as above. Only requests answered after the spy is
-made count. `requestBody` is cut to 500 characters: expect a part of a long body as a string.
+`shouldHaveRequestBody` / `shouldHaveResponseBody` / `callCount` / `calls` as above. Only requests
+answered after the spy is made count. `requestBody` and `responseBody` are cut to 500 characters:
+expect a part of a long body as a string. `responseBody` is recorded for text Fetch/XHR responses
+only; any other fails the assertion saying why.
 
 Intercept with `delayMs` only when the step reads the page while the request is in flight; then
 `waitForResponse()` before checking the result: