@thisisagile/easy-playwright 20.1.1 → 21.0.0

package/README.md

@@ -280,3 +280,14 @@ The `@requires` decorator group also contains `@requires.labCoat()` this decorat
 
 To use these decorators, the generic `security` middleware must be loaded first. In most cases, it should be added to the `pre` list of handlers of a service.
 The security middleware takes an optional configuration object, which is documented [in code](packages/easy-express/src/express/SecurityHandler.ts).
+
+## Side effects and tree shaking
+Every package declares `sideEffects` in its `package.json`, so a bundler only keeps the modules a consumer actually uses. Contributors keep that declaration true by following these rules:
+
+- **No module-level mutation of anything outside the module.** Do not patch globals, prototypes or imported objects when a module loads. If something must be configured, configure it in the module that needs it, so it is kept exactly when that module is used.
+- **Catalogue values are pure factories.** Build enum and catalogue values with plain constructors or factory calls that only create objects, so an unused value can be dropped.
+- **A module that must run for its effect on import is listed explicitly.** `easy-test` lists its index and matcher files because `import '@thisisagile/easy-test'` exists to call `expect.extend`. `easy-test-react` lists its index because importing it mocks the timezone. Runtime packages declare `false`.
+- **`DateTime` and `Meta` are deliberately not listed.** `DateTime` extends Day.js and `Meta` loads `reflect-metadata` at module level, but only their own exports need that setup. Bundlers keep a module's top-level code whenever any of its exports are used, so they stay correct unlisted. Listing them would make every root import, such as `isDefined`, pay for Day.js and `reflect-metadata`.
+- **No `emitDecoratorMetadata`.** Nothing in easy reads `design:` metadata; decorators store what they need under their own keys.
+
+`test/bundle/workspaces.mjs` checks these rules against the packed packages.

package/dist/PlaywrightTester.d.ts

@@ -1,13 +1,9 @@
-import { Id, Json, UseCase } from "@thisisagile/easy";
+import { Json } from "@thisisagile/easy";
 import { Browser, Page } from "playwright";
-import { TestElement, Tester } from "@thisisagile/easy-test-web";
+import { ClosableBrowserTester, TestElement, Tester } from "@thisisagile/easy-test-web";
 //#region src/PlaywrightTester.d.ts
 export type BrowserType = 'Chromium' | 'Webkit' | 'Firefox';
-export declare class PlaywrightTester implements Tester {
-  host: string;
-  private readonly browser;
-  private readonly page;
-  constructor(host: string, browser: Browser, page: Page);
+export declare class PlaywrightTester extends ClosableBrowserTester<Page> implements Tester {
   get url(): string;
   static launch: (browserType: BrowserType, headless: boolean, launchProps: Json) => Promise<Browser>;
   static init(browserType: BrowserType, host?: string, headless?: boolean, width?: number, height?: number, launchProps?: {}): Promise<Tester>;
@@ -18,10 +14,6 @@ export declare class PlaywrightTester implements Tester {
   by(key: string, value: string): TestElement;
   submit(): TestElement;
   row(contains: string): TestElement;
-  redirect(url: string): Promise<boolean>;
-  goto(to: UseCase, id?: Id): Promise<boolean>;
-  wait(): Promise<boolean>;
-  close(): Promise<void>;
   private byXPath;
 }
 //#endregion

package/dist/PlaywrightTester.js

@@ -1,17 +1,9 @@
 import { PlaywrightElement } from "./PlaywrightElement.js";
 import { ctx } from "@thisisagile/easy";
 import { chromium, firefox, webkit } from "playwright";
-import { toUrl } from "@thisisagile/easy-test-web";
+import { ClosableBrowserTester } from "@thisisagile/easy-test-web";
 //#region src/PlaywrightTester.ts
-var PlaywrightTester = class PlaywrightTester {
-	host;
-	browser;
-	page;
-	constructor(host, browser, page) {
-		this.host = host;
-		this.browser = browser;
-		this.page = page;
-	}
+var PlaywrightTester = class PlaywrightTester extends ClosableBrowserTester {
 	get url() {
 		return this.page.url();
 	}
@@ -62,18 +54,6 @@ var PlaywrightTester = class PlaywrightTester {
 	row(contains) {
 		return this.byXPath(`(//tr[contains(., '${contains}')])[1]`);
 	}
-	redirect(url) {
-		return this.page.goto(url).then((r) => r?.ok() ?? false);
-	}
-	goto(to, id) {
-		return this.redirect(toUrl(to, this.host, id));
-	}
-	wait() {
-		return this.page.waitForNavigation().then((r) => r?.ok() || false);
-	}
-	close() {
-		return this.browser.close();
-	}
 	byXPath(q) {
 		const h = this.page.waitForSelector(`${q}`);
 		return new PlaywrightElement(h);

package/dist/PlaywrightTester.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaywrightTester.js","names":[],"sources":["../src/PlaywrightTester.ts"],"sourcesContent":["import playwright, { Browser, chromium, firefox, Page, webkit } from 'playwright';\nimport { PlaywrightElement } from './PlaywrightElement';\nimport { ctx, Id, Json, UseCase } from '@thisisagile/easy';\nimport { TestElement, Tester, toUrl } from '@thisisagile/easy-test-web';\n\nexport type BrowserType = 'Chromium' | 'Webkit' | 'Firefox';\n\nexport class PlaywrightTester implements Tester {\n  constructor(public host: string, private readonly browser: Browser, private readonly page: Page) {}\n\n  get url(): string {\n    return this.page.url();\n  }\n\n  /* istanbul ignore next */\n  static launch = (browserType: BrowserType, headless: boolean, launchProps: Json): Promise<Browser> => {\n    const options: playwright.LaunchOptions = {\n      headless: headless,\n      args: ['--no-sandbox', '--start-maximized'],\n      ...launchProps,\n    };\n    switch (browserType) {\n      case 'Firefox':\n        return firefox.launch(options);\n      case 'Webkit':\n        return webkit.launch(options);\n      default:\n        return chromium.launch(options);\n    }\n  };\n\n  /* istanbul ignore next */\n  static async init(\n    browserType: BrowserType,\n    host: string = ctx.env.get('webHost', '') as string,\n    headless = true,\n    width = 1200,\n    height = 800,\n    launchProps = {}\n  ): Promise<Tester> {\n    const browser = await PlaywrightTester.launch(browserType, headless, launchProps);\n    const page = await browser.newPage();\n    await page.setViewportSize({ width, height });\n    return new PlaywrightTester(host, browser, page);\n  }\n\n  byClass(c: string): TestElement {\n    const h = this.page.waitForSelector(`.${c}`);\n    return new PlaywrightElement(h);\n  }\n\n  byId(id: string): TestElement {\n    const h = this.page.waitForSelector(`#${id}`);\n    return new PlaywrightElement(h);\n  }\n\n  byDataTestId(id: string): TestElement {\n    return this.by('data-testid', id);\n  }\n\n  byName(name: string): TestElement {\n    return this.by('name', name);\n  }\n\n  by(key: string, value: string): TestElement {\n    const h = this.page.waitForSelector(`[${key}=${value}]`);\n    return new PlaywrightElement(h);\n  }\n\n  submit(): TestElement {\n    return this.by('type', 'submit');\n  }\n\n  row(contains: string): TestElement {\n    // Select the first row that contains the given input\n    return this.byXPath(`(//tr[contains(., '${contains}')])[1]`);\n  }\n\n  redirect(url: string): Promise<boolean> {\n    return this.page.goto(url).then(r => r?.ok() ?? false);\n  }\n\n  goto(to: UseCase, id?: Id): Promise<boolean> {\n    return this.redirect(toUrl(to, this.host, id));\n  }\n\n  wait(): Promise<boolean> {\n    return this.page.waitForNavigation().then(r => r?.ok() || false);\n  }\n\n  close(): Promise<void> {\n    return this.browser.close();\n  }\n\n  private byXPath(q: string): TestElement {\n    const h = this.page.waitForSelector(`${q}`);\n    return new PlaywrightElement(h);\n  }\n}\n"],"mappings":";;;;;AAOA,IAAa,mBAAb,MAAa,iBAAmC;CAC3B;CAA+B;CAAmC;CAArF,YAAY,MAAqB,SAAmC,MAA6B;EAA9E,KAAA,OAAA;EAA+B,KAAA,UAAA;EAAmC,KAAA,OAAA;CAAa;CAElG,IAAI,MAAc;EAChB,OAAO,KAAK,KAAK,IAAI;CACvB;;CAGA,OAAO,UAAU,aAA0B,UAAmB,gBAAwC;EACpG,MAAM,UAAoC;GAC9B;GACV,MAAM,CAAC,gBAAgB,mBAAmB;GAC1C,GAAG;EACL;EACA,QAAQ,aAAR;GACE,KAAK,WACH,OAAO,QAAQ,OAAO,OAAO;GAC/B,KAAK,UACH,OAAO,OAAO,OAAO,OAAO;GAC9B,SACE,OAAO,SAAS,OAAO,OAAO;EAClC;CACF;;CAGA,aAAa,KACX,aACA,OAAe,IAAI,IAAI,IAAI,WAAW,EAAE,GACxC,WAAW,MACX,QAAQ,MACR,SAAS,KACT,cAAc,CAAC,GACE;EACjB,MAAM,UAAU,MAAM,iBAAiB,OAAO,aAAa,UAAU,WAAW;EAChF,MAAM,OAAO,MAAM,QAAQ,QAAQ;EACnC,MAAM,KAAK,gBAAgB;GAAE;GAAO;EAAO,CAAC;EAC5C,OAAO,IAAI,iBAAiB,MAAM,SAAS,IAAI;CACjD;CAEA,QAAQ,GAAwB;EAC9B,MAAM,IAAI,KAAK,KAAK,gBAAgB,IAAI,GAAG;EAC3C,OAAO,IAAI,kBAAkB,CAAC;CAChC;CAEA,KAAK,IAAyB;EAC5B,MAAM,IAAI,KAAK,KAAK,gBAAgB,IAAI,IAAI;EAC5C,OAAO,IAAI,kBAAkB,CAAC;CAChC;CAEA,aAAa,IAAyB;EACpC,OAAO,KAAK,GAAG,eAAe,EAAE;CAClC;CAEA,OAAO,MAA2B;EAChC,OAAO,KAAK,GAAG,QAAQ,IAAI;CAC7B;CAEA,GAAG,KAAa,OAA4B;EAC1C,MAAM,IAAI,KAAK,KAAK,gBAAgB,IAAI,IAAI,GAAG,MAAM,EAAE;EACvD,OAAO,IAAI,kBAAkB,CAAC;CAChC;CAEA,SAAsB;EACpB,OAAO,KAAK,GAAG,QAAQ,QAAQ;CACjC;CAEA,IAAI,UAA+B;EAEjC,OAAO,KAAK,QAAQ,sBAAsB,SAAS,QAAQ;CAC7D;CAEA,SAAS,KAA+B;EACtC,OAAO,KAAK,KAAK,KAAK,GAAG,CAAC,CAAC,MAAK,MAAK,GAAG,GAAG,KAAK,KAAK;CACvD;CAEA,KAAK,IAAa,IAA2B;EAC3C,OAAO,KAAK,SAAS,MAAM,IAAI,KAAK,MAAM,EAAE,CAAC;CAC/C;CAEA,OAAyB;EACvB,OAAO,KAAK,KAAK,kBAAkB,CAAC,CAAC,MAAK,MAAK,GAAG,GAAG,KAAK,KAAK;CACjE;CAEA,QAAuB;EACrB,OAAO,KAAK,QAAQ,MAAM;CAC5B;CAEA,QAAgB,GAAwB;EACtC,MAAM,IAAI,KAAK,KAAK,gBAAgB,GAAG,GAAG;EAC1C,OAAO,IAAI,kBAAkB,CAAC;CAChC;AACF"}
+{"version":3,"file":"PlaywrightTester.js","names":[],"sources":["../src/PlaywrightTester.ts"],"sourcesContent":["import playwright, { Browser, chromium, firefox, Page, webkit } from 'playwright';\nimport { PlaywrightElement } from './PlaywrightElement';\nimport { ctx, Json } from '@thisisagile/easy';\nimport { ClosableBrowserTester, TestElement, Tester } from '@thisisagile/easy-test-web';\n\nexport type BrowserType = 'Chromium' | 'Webkit' | 'Firefox';\n\nexport class PlaywrightTester extends ClosableBrowserTester<Page> implements Tester {\n  get url(): string {\n    return this.page.url();\n  }\n\n  /* istanbul ignore next */\n  static launch = (browserType: BrowserType, headless: boolean, launchProps: Json): Promise<Browser> => {\n    const options: playwright.LaunchOptions = {\n      headless: headless,\n      args: ['--no-sandbox', '--start-maximized'],\n      ...launchProps,\n    };\n    switch (browserType) {\n      case 'Firefox':\n        return firefox.launch(options);\n      case 'Webkit':\n        return webkit.launch(options);\n      default:\n        return chromium.launch(options);\n    }\n  };\n\n  /* istanbul ignore next */\n  static async init(\n    browserType: BrowserType,\n    host: string = ctx.env.get('webHost', '') as string,\n    headless = true,\n    width = 1200,\n    height = 800,\n    launchProps = {}\n  ): Promise<Tester> {\n    const browser = await PlaywrightTester.launch(browserType, headless, launchProps);\n    const page = await browser.newPage();\n    await page.setViewportSize({ width, height });\n    return new PlaywrightTester(host, browser, page);\n  }\n\n  byClass(c: string): TestElement {\n    const h = this.page.waitForSelector(`.${c}`);\n    return new PlaywrightElement(h);\n  }\n\n  byId(id: string): TestElement {\n    const h = this.page.waitForSelector(`#${id}`);\n    return new PlaywrightElement(h);\n  }\n\n  byDataTestId(id: string): TestElement {\n    return this.by('data-testid', id);\n  }\n\n  byName(name: string): TestElement {\n    return this.by('name', name);\n  }\n\n  by(key: string, value: string): TestElement {\n    const h = this.page.waitForSelector(`[${key}=${value}]`);\n    return new PlaywrightElement(h);\n  }\n\n  submit(): TestElement {\n    return this.by('type', 'submit');\n  }\n\n  row(contains: string): TestElement {\n    // Select the first row that contains the given input\n    return this.byXPath(`(//tr[contains(., '${contains}')])[1]`);\n  }\n\n  private byXPath(q: string): TestElement {\n    const h = this.page.waitForSelector(`${q}`);\n    return new PlaywrightElement(h);\n  }\n}\n"],"mappings":";;;;;AAOA,IAAa,mBAAb,MAAa,yBAAyB,sBAA8C;CAClF,IAAI,MAAc;EAChB,OAAO,KAAK,KAAK,IAAI;CACvB;;CAGA,OAAO,UAAU,aAA0B,UAAmB,gBAAwC;EACpG,MAAM,UAAoC;GAC9B;GACV,MAAM,CAAC,gBAAgB,mBAAmB;GAC1C,GAAG;EACL;EACA,QAAQ,aAAR;GACE,KAAK,WACH,OAAO,QAAQ,OAAO,OAAO;GAC/B,KAAK,UACH,OAAO,OAAO,OAAO,OAAO;GAC9B,SACE,OAAO,SAAS,OAAO,OAAO;EAClC;CACF;;CAGA,aAAa,KACX,aACA,OAAe,IAAI,IAAI,IAAI,WAAW,EAAE,GACxC,WAAW,MACX,QAAQ,MACR,SAAS,KACT,cAAc,CAAC,GACE;EACjB,MAAM,UAAU,MAAM,iBAAiB,OAAO,aAAa,UAAU,WAAW;EAChF,MAAM,OAAO,MAAM,QAAQ,QAAQ;EACnC,MAAM,KAAK,gBAAgB;GAAE;GAAO;EAAO,CAAC;EAC5C,OAAO,IAAI,iBAAiB,MAAM,SAAS,IAAI;CACjD;CAEA,QAAQ,GAAwB;EAC9B,MAAM,IAAI,KAAK,KAAK,gBAAgB,IAAI,GAAG;EAC3C,OAAO,IAAI,kBAAkB,CAAC;CAChC;CAEA,KAAK,IAAyB;EAC5B,MAAM,IAAI,KAAK,KAAK,gBAAgB,IAAI,IAAI;EAC5C,OAAO,IAAI,kBAAkB,CAAC;CAChC;CAEA,aAAa,IAAyB;EACpC,OAAO,KAAK,GAAG,eAAe,EAAE;CAClC;CAEA,OAAO,MAA2B;EAChC,OAAO,KAAK,GAAG,QAAQ,IAAI;CAC7B;CAEA,GAAG,KAAa,OAA4B;EAC1C,MAAM,IAAI,KAAK,KAAK,gBAAgB,IAAI,IAAI,GAAG,MAAM,EAAE;EACvD,OAAO,IAAI,kBAAkB,CAAC;CAChC;CAEA,SAAsB;EACpB,OAAO,KAAK,GAAG,QAAQ,QAAQ;CACjC;CAEA,IAAI,UAA+B;EAEjC,OAAO,KAAK,QAAQ,sBAAsB,SAAS,QAAQ;CAC7D;CAEA,QAAgB,GAAwB;EACtC,MAAM,IAAI,KAAK,KAAK,gBAAgB,GAAG,GAAG;EAC1C,OAAO,IAAI,kBAAkB,CAAC;CAChC;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thisisagile/easy-playwright",
-  "version": "20.1.1",
+  "version": "21.0.0",
   "description": "Straightforward wrapper library for Playwright web testing framework",
   "author": "Sander Hoogendoorn",
   "license": "MIT",
@@ -24,7 +24,7 @@
   "scripts": {
     "lint": "yarn g:eslint . --ext .js,.jsx,.ts,.tsx --fix",
     "format": "yarn g:prettier --check --write src test *.json",
-    "build": "yarn g:tsdown && yarn g:exports",
+    "build": "yarn g:tsdown",
     "test": "yarn g:jest --coverage",
     "prepack": "yarn g:copy-readme"
   },
@@ -43,8 +43,8 @@
     "@thisisagile/easy-test": "*"
   },
   "dependencies": {
-    "@thisisagile/easy": "^20.1.1",
-    "@thisisagile/easy-test-web": "^20.1.1",
+    "@thisisagile/easy": "^21.0.0",
+    "@thisisagile/easy-test-web": "^21.0.0",
     "playwright": "^1.41.2"
   },
   "exports": {

package/src/PlaywrightTester.ts

@@ -1,13 +1,11 @@
 import playwright, { Browser, chromium, firefox, Page, webkit } from 'playwright';
 import { PlaywrightElement } from './PlaywrightElement';
-import { ctx, Id, Json, UseCase } from '@thisisagile/easy';
-import { TestElement, Tester, toUrl } from '@thisisagile/easy-test-web';
+import { ctx, Json } from '@thisisagile/easy';
+import { ClosableBrowserTester, TestElement, Tester } from '@thisisagile/easy-test-web';
 
 export type BrowserType = 'Chromium' | 'Webkit' | 'Firefox';
 
-export class PlaywrightTester implements Tester {
-  constructor(public host: string, private readonly browser: Browser, private readonly page: Page) {}
-
+export class PlaywrightTester extends ClosableBrowserTester<Page> implements Tester {
   get url(): string {
     return this.page.url();
   }
@@ -76,22 +74,6 @@ export class PlaywrightTester implements Tester {
     return this.byXPath(`(//tr[contains(., '${contains}')])[1]`);
   }
 
-  redirect(url: string): Promise<boolean> {
-    return this.page.goto(url).then(r => r?.ok() ?? false);
-  }
-
-  goto(to: UseCase, id?: Id): Promise<boolean> {
-    return this.redirect(toUrl(to, this.host, id));
-  }
-
-  wait(): Promise<boolean> {
-    return this.page.waitForNavigation().then(r => r?.ok() || false);
-  }
-
-  close(): Promise<void> {
-    return this.browser.close();
-  }
-
   private byXPath(q: string): TestElement {
     const h = this.page.waitForSelector(`${q}`);
     return new PlaywrightElement(h);