@immense/vue-pom-generator 1.0.112 → 1.0.114
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/RELEASE_NOTES.md +26 -16
- package/class-generation/base-page.ts +14 -4
- package/class-generation/playwright-types.ts +16 -1
- package/dist/class-generation/base-page.d.ts +10 -2
- package/dist/class-generation/base-page.d.ts.map +1 -1
- package/dist/class-generation/playwright-types.d.ts +15 -1
- package/dist/class-generation/playwright-types.d.ts.map +1 -1
- package/dist/playwright/runtime.cjs +12 -1
- package/dist/playwright/runtime.cjs.map +1 -1
- package/dist/playwright/runtime.mjs +12 -1
- package/dist/playwright/runtime.mjs.map +1 -1
- package/dist/tests/broad/helpers/fake-runtime.d.ts +5 -1
- package/dist/tests/broad/helpers/fake-runtime.d.ts.map +1 -1
- package/dist/tests/playwright/pom-screenshot.spec.d.ts +2 -0
- package/dist/tests/playwright/pom-screenshot.spec.d.ts.map +1 -0
- package/package.json +1 -1
package/RELEASE_NOTES.md
CHANGED
|
@@ -1,26 +1,35 @@
|
|
|
1
|
-
|
|
2
|
-
a single commit — PR #77 — so that's the only PR included in this release.
|
|
1
|
+
I'll verify the actual contents of the compare range and the PR's changes before writing the notes.
|
|
3
2
|
|
|
4
|
-
|
|
3
|
+
The range contains exactly one commit (#79). Let me review its diff to describe the feature
|
|
4
|
+
accurately.
|
|
5
5
|
|
|
6
6
|
Highlights
|
|
7
7
|
|
|
8
|
-
-
|
|
9
|
-
|
|
10
|
-
-
|
|
11
|
-
|
|
8
|
+
- Generated POMs now expose BasePage.screenshot() as a first-class proof-capture seam — no more
|
|
9
|
+
reaching for the raw Page escape hatch to save evidence screenshots.
|
|
10
|
+
- Options mirror Playwright's own page.screenshot (path, fullPage, timeout) and pass through
|
|
11
|
+
verbatim; the method resolves to the image buffer and writes the file when path is set.
|
|
12
|
+
- screenshot is recognized as a value-returning method in the fluent chain, so awaited destination
|
|
13
|
+
POMs (e.g. after goTo...()) can capture screenshots directly.
|
|
12
14
|
|
|
13
15
|
Changes
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
POM class generation
|
|
16
18
|
|
|
17
|
-
- Added
|
|
18
|
-
|
|
19
|
-
|
|
19
|
+
- Added BasePage.screenshot(options?) as a thin delegate to Playwright's page.screenshot — no
|
|
20
|
+
animation, callout, or annotation side effects (]8;id=md-78o31g;https://github.com/immense/vue-pom-generator/blob/main/class-generation/base-page.tsbase-page.ts]8;;]8;;).]8;;
|
|
21
|
+
- Added BasePageScreenshotOptions (path, fullPage, timeout) and wired screenshot into the narrowed
|
|
22
|
+
BasePagePage interface (]8;id=md-14v2psc;https://github.com/immense/vue-pom-generator/blob/main/class-generation/playwright-types.tsplaywright-types.ts]8;;]8;;).]8;;
|
|
23
|
+
- Extended fluent-chain handling so screenshot joins getObjectId/getObjectIdAsInt as a
|
|
24
|
+
value-returning method, returning the awaited image buffer.
|
|
20
25
|
|
|
21
|
-
|
|
26
|
+
Tests
|
|
22
27
|
|
|
23
|
-
-
|
|
28
|
+
- New Playwright spec tests/playwright/pom-screenshot.spec.ts covering: writing a real PNG file
|
|
29
|
+
(path) and verifying the resolved buffer matches it, capturing without options, and the consumer
|
|
30
|
+
pattern of screenshotting an awaited fluent destination POM.
|
|
31
|
+
- Extended broad unit coverage for base-page.ts and updated the fake-runtime test helper to support
|
|
32
|
+
the new seam.
|
|
24
33
|
|
|
25
34
|
Breaking Changes
|
|
26
35
|
|
|
@@ -28,10 +37,11 @@ None.
|
|
|
28
37
|
|
|
29
38
|
Pull Requests Included
|
|
30
39
|
|
|
31
|
-
- ]8;id=md-
|
|
40
|
+
- ]8;id=md-fq4e9m;https://github.com/immense/vue-pom-generator/pull/79#79 — feat(pom): BasePage.screenshot proof-capture seam]8;;]8;; (@dkattan)]8;;
|
|
32
41
|
|
|
33
42
|
Testing
|
|
34
43
|
|
|
35
|
-
-
|
|
36
|
-
|
|
44
|
+
- Unit tests for base-page generation extended in
|
|
45
|
+
tests/broad/class-generation-base-page-ts.test.ts.
|
|
46
|
+
- New Playwright end-to-end spec validates buffer content, PNG magic bytes, and file-write parity.
|
|
37
47
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Locator, Page } from "playwright";
|
|
2
|
-
import type { PwLocator, PwPage } from "./playwright-types";
|
|
2
|
+
import type { BasePageScreenshotOptions, PwLocator, PwPage } from "./playwright-types";
|
|
3
3
|
|
|
4
4
|
import { TESTID_CLICK_EVENT_NAME } from "../click-instrumentation";
|
|
5
5
|
import type { TestIdClickEventDetail } from "../click-instrumentation";
|
|
@@ -53,9 +53,7 @@ const CLICK_EVENT_DEBUG = false;
|
|
|
53
53
|
*/
|
|
54
54
|
type DeepFluent<T, TRoot extends object> = {
|
|
55
55
|
[K in keyof T]: T[K] extends (...args: infer A) => infer _R
|
|
56
|
-
? K extends "getObjectId"
|
|
57
|
-
? (...args: A) => ValueFluent<Awaited<_R>>
|
|
58
|
-
: K extends "getObjectIdAsInt"
|
|
56
|
+
? K extends "getObjectId" | "getObjectIdAsInt" | "screenshot"
|
|
59
57
|
? (...args: A) => ValueFluent<Awaited<_R>>
|
|
60
58
|
: (...args: A) => Fluent<TRoot>
|
|
61
59
|
: T[K] extends object
|
|
@@ -168,6 +166,17 @@ export class BasePage {
|
|
|
168
166
|
return this.page.screencast;
|
|
169
167
|
}
|
|
170
168
|
|
|
169
|
+
/**
|
|
170
|
+
* Captures a screenshot of the page through the POM, so specs never need the
|
|
171
|
+
* raw-Page escape hatch for proof captures. Thin delegate to Playwright's
|
|
172
|
+
* `page.screenshot` — no animation, callout or annotation side effects;
|
|
173
|
+
* options mirror Playwright's own (`path`, `fullPage`, `timeout`). Resolves
|
|
174
|
+
* to the image buffer; when `path` is set the file is also written.
|
|
175
|
+
*/
|
|
176
|
+
public screenshot(options?: BasePageScreenshotOptions): ReturnType<Page["screenshot"]> {
|
|
177
|
+
return this._page.screenshot(options);
|
|
178
|
+
}
|
|
179
|
+
|
|
171
180
|
private async waitForTestIdClickEventAfter(testId: string, options?: { timeoutMs?: number }): Promise<void> {
|
|
172
181
|
if (!REQUIRE_CLICK_EVENT) {
|
|
173
182
|
return;
|
|
@@ -454,6 +463,7 @@ export class BasePage {
|
|
|
454
463
|
const VALUE_RETURNING_METHODS = new Set<PropertyKey>([
|
|
455
464
|
"getObjectId",
|
|
456
465
|
"getObjectIdAsInt",
|
|
466
|
+
"screenshot",
|
|
457
467
|
]);
|
|
458
468
|
|
|
459
469
|
const getCtorName = (obj: object): string => {
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { Keyboard, Locator, Response, Screencast } from "playwright";
|
|
1
|
+
import type { Keyboard, Locator, Page, Response, Screencast } from "playwright";
|
|
2
2
|
|
|
3
3
|
|
|
4
4
|
/**
|
|
@@ -78,6 +78,20 @@ export interface BasePageLocator {
|
|
|
78
78
|
}) => R | Promise<R>): Promise<R>;
|
|
79
79
|
}
|
|
80
80
|
|
|
81
|
+
/**
|
|
82
|
+
* Narrow subset of Playwright's screenshot options that
|
|
83
|
+
* {@link BasePagePage.screenshot} passes through verbatim. Member names and
|
|
84
|
+
* semantics mirror Playwright's own `page.screenshot` options.
|
|
85
|
+
*/
|
|
86
|
+
export interface BasePageScreenshotOptions {
|
|
87
|
+
/** Save the screenshot to this file path (PNG unless the extension says otherwise). */
|
|
88
|
+
path?: string;
|
|
89
|
+
/** Capture the full scrollable page instead of the visible viewport. */
|
|
90
|
+
fullPage?: boolean;
|
|
91
|
+
/** Maximum operation time in milliseconds; `0` disables the timeout. */
|
|
92
|
+
timeout?: number;
|
|
93
|
+
}
|
|
94
|
+
|
|
81
95
|
/**
|
|
82
96
|
* Narrow subset of the Playwright {@link Page} surface that the generated POM
|
|
83
97
|
* runtime depends on.
|
|
@@ -99,6 +113,7 @@ export interface BasePagePage {
|
|
|
99
113
|
evaluate<R, Arg = never>(pageFunction: string | ((arg: Arg) => R | Promise<R>), arg?: Arg): Promise<R>;
|
|
100
114
|
readonly keyboard: Keyboard;
|
|
101
115
|
readonly screencast: Screencast;
|
|
116
|
+
screenshot(options?: BasePageScreenshotOptions): ReturnType<Page["screenshot"]>;
|
|
102
117
|
}
|
|
103
118
|
|
|
104
119
|
/**
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Locator, Page } from "playwright";
|
|
2
|
-
import type { PwLocator, PwPage } from "./playwright-types";
|
|
2
|
+
import type { BasePageScreenshotOptions, PwLocator, PwPage } from "./playwright-types";
|
|
3
3
|
import type { CalloutRenderer } from "./callout";
|
|
4
4
|
import { type AfterPointerClick, type PointerRenderer } from "./pointer";
|
|
5
5
|
/**
|
|
@@ -16,7 +16,7 @@ import { type AfterPointerClick, type PointerRenderer } from "./pointer";
|
|
|
16
16
|
* all methods chain back to the root fluent type.
|
|
17
17
|
*/
|
|
18
18
|
type DeepFluent<T, TRoot extends object> = {
|
|
19
|
-
[K in keyof T]: T[K] extends (...args: infer A) => infer _R ? K extends "getObjectId"
|
|
19
|
+
[K in keyof T]: T[K] extends (...args: infer A) => infer _R ? K extends "getObjectId" | "getObjectIdAsInt" | "screenshot" ? (...args: A) => ValueFluent<Awaited<_R>> : (...args: A) => Fluent<TRoot> : T[K] extends object ? DeepFluent<T[K], TRoot> : T[K];
|
|
20
20
|
};
|
|
21
21
|
type DeepValueFluent<T> = {
|
|
22
22
|
[K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: A) => ValueFluent<Awaited<R>> : T[K] extends object ? DeepValueFluent<T[K]> : T[K];
|
|
@@ -70,6 +70,14 @@ export declare class BasePage {
|
|
|
70
70
|
*/
|
|
71
71
|
constructor(page: PwPage, options?: BasePageOptions);
|
|
72
72
|
get screencast(): Page["screencast"];
|
|
73
|
+
/**
|
|
74
|
+
* Captures a screenshot of the page through the POM, so specs never need the
|
|
75
|
+
* raw-Page escape hatch for proof captures. Thin delegate to Playwright's
|
|
76
|
+
* `page.screenshot` — no animation, callout or annotation side effects;
|
|
77
|
+
* options mirror Playwright's own (`path`, `fullPage`, `timeout`). Resolves
|
|
78
|
+
* to the image buffer; when `path` is set the file is also written.
|
|
79
|
+
*/
|
|
80
|
+
screenshot(options?: BasePageScreenshotOptions): ReturnType<Page["screenshot"]>;
|
|
73
81
|
private waitForTestIdClickEventAfter;
|
|
74
82
|
private getAfterPointerClick;
|
|
75
83
|
protected selectorForTestId(testId: string): string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base-page.d.ts","sourceRoot":"","sources":["../../class-generation/base-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"base-page.d.ts","sourceRoot":"","sources":["../../class-generation/base-page.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { Keyboard, Response, Screencast } from "playwright";
|
|
1
|
+
import type { Keyboard, Page, Response, Screencast } from "playwright";
|
|
2
2
|
/**
|
|
3
3
|
* Narrow subset of the Playwright {@link Locator} surface that the generated
|
|
4
4
|
* POM runtime (`base-page.ts`, `callout.ts`, `pointer.ts`) and generated page
|
|
@@ -174,6 +174,19 @@ export interface BasePageLocator {
|
|
|
174
174
|
getAnimations?: () => Animation[];
|
|
175
175
|
}) => R | Promise<R>): Promise<R>;
|
|
176
176
|
}
|
|
177
|
+
/**
|
|
178
|
+
* Narrow subset of Playwright's screenshot options that
|
|
179
|
+
* {@link BasePagePage.screenshot} passes through verbatim. Member names and
|
|
180
|
+
* semantics mirror Playwright's own `page.screenshot` options.
|
|
181
|
+
*/
|
|
182
|
+
export interface BasePageScreenshotOptions {
|
|
183
|
+
/** Save the screenshot to this file path (PNG unless the extension says otherwise). */
|
|
184
|
+
path?: string;
|
|
185
|
+
/** Capture the full scrollable page instead of the visible viewport. */
|
|
186
|
+
fullPage?: boolean;
|
|
187
|
+
/** Maximum operation time in milliseconds; `0` disables the timeout. */
|
|
188
|
+
timeout?: number;
|
|
189
|
+
}
|
|
177
190
|
/**
|
|
178
191
|
* Narrow subset of the Playwright {@link Page} surface that the generated POM
|
|
179
192
|
* runtime depends on.
|
|
@@ -204,6 +217,7 @@ export interface BasePagePage {
|
|
|
204
217
|
evaluate<R, Arg = never>(pageFunction: string | ((arg: Arg) => R | Promise<R>), arg?: Arg): Promise<R>;
|
|
205
218
|
readonly keyboard: Keyboard;
|
|
206
219
|
readonly screencast: Screencast;
|
|
220
|
+
screenshot(options?: BasePageScreenshotOptions): ReturnType<Page["screenshot"]>;
|
|
207
221
|
}
|
|
208
222
|
/**
|
|
209
223
|
* Page dependency type used by the generated POM runtime. Narrowed from
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playwright-types.d.ts","sourceRoot":"","sources":["../../class-generation/playwright-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAW,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"playwright-types.d.ts","sourceRoot":"","sources":["../../class-generation/playwright-types.ts"],"names":[],"mappings":"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"}
|
|
@@ -579,6 +579,16 @@ class BasePage {
|
|
|
579
579
|
get screencast() {
|
|
580
580
|
return this.page.screencast;
|
|
581
581
|
}
|
|
582
|
+
/**
|
|
583
|
+
* Captures a screenshot of the page through the POM, so specs never need the
|
|
584
|
+
* raw-Page escape hatch for proof captures. Thin delegate to Playwright's
|
|
585
|
+
* `page.screenshot` — no animation, callout or annotation side effects;
|
|
586
|
+
* options mirror Playwright's own (`path`, `fullPage`, `timeout`). Resolves
|
|
587
|
+
* to the image buffer; when `path` is set the file is also written.
|
|
588
|
+
*/
|
|
589
|
+
screenshot(options) {
|
|
590
|
+
return this._page.screenshot(options);
|
|
591
|
+
}
|
|
582
592
|
async waitForTestIdClickEventAfter(testId, options) {
|
|
583
593
|
{
|
|
584
594
|
return;
|
|
@@ -696,7 +706,8 @@ class BasePage {
|
|
|
696
706
|
let rootProxy;
|
|
697
707
|
const VALUE_RETURNING_METHODS = /* @__PURE__ */ new Set([
|
|
698
708
|
"getObjectId",
|
|
699
|
-
"getObjectIdAsInt"
|
|
709
|
+
"getObjectIdAsInt",
|
|
710
|
+
"screenshot"
|
|
700
711
|
]);
|
|
701
712
|
const getCtorName = (obj) => {
|
|
702
713
|
const o = obj;
|