pomwright 0.0.8 → 1.0.0

package/.vscode/playwright-snippets.code-snippets

@@ -0,0 +1,82 @@
+{
+    "Playwright Import": {
+      "prefix": "pw-import",
+      "body": [
+        "import { test, expect } from \"@fixtures/$1\";"
+      ],
+      "description": "Import Playwright Test through our Fixtures"
+    },
+    "Playwright Describe": {
+      "prefix": "pw-describe",
+      "body": [
+        "test.describe(\"$1\", () => {",
+        "  $2",
+        "});"
+      ],
+      "description": "Playwright Test describe block"
+    },
+    "Playwright Test": {
+      "prefix": "pw-test",
+      "body": [
+        "test(\"$1\", async ({ $2 }) => {",
+        "  $3",
+        "});"
+      ],
+      "description": "Playwright Test test block"
+    },
+    "Playwright Step": {
+      "prefix": "pw-step",
+      "body": [
+        "await test.step(`${$1.pocName}: $2`, async () => {",
+        "  $3",
+        "});"
+      ],
+      "description": "Playwright Test step block"
+    },
+    "Playwright Use": {
+      "prefix": "pw-use",
+      "body": [
+        "test.use({",
+        "  $1",
+        "});"
+      ],
+      "description": "Playwright Test use block"
+    },
+    "Playwright beforeEach": {
+      "prefix": "pw-beforeEach",
+      "body": [
+        "test.beforeEach(async ({ $1 }) => {",
+        "  $2",
+        "});"
+      ],
+      "description": "Playwright Test beforeEach block"
+    },
+    "Playwright afterEach": {
+      "prefix": "pw-afterEach",
+      "body": [
+        "test.afterEach(async ({ $1 }) => {",
+        "  $2",
+        "});"
+      ],
+      "description": "Playwright Test afterEach block"
+    },
+    "Playwright beforeAll": {
+      "prefix": "pw-beforeAll",
+      "body": [
+        "test.beforeAll(async ({ $1 }) => {",
+        "  $2",
+        "});"
+      ],
+      "description": "Playwright Test beforeAll block"
+    },
+    "Playwright afterAll": {
+      "prefix": "pw-afterAll",
+      "body": [
+        "test.afterAll(async ({ $1 }) => {",
+        "  $2",
+        "});"
+      ],
+      "description": "Playwright Test afterAll block"
+    }
+  }
+  

package/.vscode/settings.json

@@ -1,3 +1,4 @@
 {
-  "editor.defaultFormatter": "biomejs.biome"
+	"editor.defaultFormatter": "biomejs.biome",
+	"editor.formatOnSave": true
 }

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # pomwright
 
+## 1.0.0
+
+### Major Changes
+
+- 130784f: BREAKING: The following index.ts exports have been renamed:
+
+  - "POMWright" changed to "BasePage"
+  - "POMWrightTestFixture" changed to "test"
+  - "POMWrightLogger" changed to "PlaywrightReportLogger"
+  - "POMWrightGetLocatorBase" changed to "GetLocatorBase"
+  - "POMWrightApi" changed to "BaseApi"
+
+  Documentation updated
+
+  README updated
+
+## 0.0.9
+
+### Patch Changes
+
+- 7e8b7d1: removes an abstract method from POMWright/BasePage which should have been removed previously
+
 ## 0.0.8
 
 ### Patch Changes

package/README.md

@@ -1,7 +1,6 @@
 # POMWright
 
-![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/DyHex/POMWright/main.yaml?label=CI%20on%20main) ![NPM Version](https://img.shields.io/npm/v/pomwright?link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2Fpomwright) ![NPM Downloads](https://img.shields.io/npm/dt/pomwright) ![GitHub License](https://img.shields.io/github/license/DyHex/POMWright) ![NPM dev or peer Dependency Version](https://img.shields.io/npm/dependency-version/pomwright/peer/%40playwright%2Ftest) 
-
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/DyHex/POMWright/main.yaml?label=CI%20on%20main) [![NPM Version](https://img.shields.io/npm/v/pomwright)](https://www.npmjs.com/package/pomwright) ![NPM Downloads](https://img.shields.io/npm/dt/pomwright) ![GitHub License](https://img.shields.io/github/license/DyHex/POMWright) [![NPM dev or peer Dependency Version](https://img.shields.io/npm/dependency-version/pomwright/peer/%40playwright%2Ftest)](https://www.npmjs.com/package/playwright) [![Static Badge](https://img.shields.io/badge/created%40-ICE-ffcd00)](https://www.ice.no/)
 
 POMWright is a TypeScript-based framework that implements the Page Object Model Design Pattern, designed specifically to augment Playwright's testing capabilities.
 
@@ -9,39 +8,105 @@ POMWright provides a way of abstracting the implementation details of a web page
 
 ## Features
 
-**Easy Creation of Page Object Classes:**
-Extend a class with POMwright to create a Page Object Class (POC).
+### Easy Creation of Page Object Classes
+
+Simply extend a class with BasePage to create a Page Object Class (POC).
+
+### Support for Multiple Domains/BaseURLs
+
+Define different base URLs by extending an abstract class with BasePage and have your POCs extend it.
+
+### Custom Playwright Fixture Integration
+
+Seamlessly integrate custom Playwright Fixtures with your POMWright POCs.
+
+### LocatorSchema Interface
 
-**Support for Multiple Domains/BaseURLs:**
-Extend an abstract class with POMWright with a given BaseUrl, then create POCs for that BaseUrl by extending the abstract class.
+Define comprehensive locators for each POC and share common locators between them.
 
-**Custom Playwright Fixture Integration:** Create custom Playwright Fixtures from your POMWright POCs by extending test as POMWrightTestFixture.
+### Advanced Locator Management
 
-**LocatorSchema Interface:** Offers a way to define and structure comprehensive locators per POC and share common locators between them.
+Efficiently manage and chain locators through LocatorSchemaPaths.
 
-**Advanced Locator Management:** Enables retrieval and automatic chaining of locators using LocatorSchemaPath.
+### Dynamic Locator Schema Updates
 
-**LocatorSchema Update/Updatess:** Allows updating single locators aswell as each locator a chained locator consist of, dynamically throughout a test.
+Modify single or multiple locators within a chained locator dynamically during tests.
 
-**Deep Copy of LocatorSchemas:** Ensures original LocatorSchemas are reusable in tests.
+### Deep Copy of LocatorSchemas
 
-**Custom HTML Logger:** Provides detailed logs for nested locators, aiding in debugging and integration with Playwright's HTML report.
+Ensure that original LocatorSchemas remain immutable and reusable across tests.
 
-**SessionStorage Handling:** Includes methods for managing sessionStorage, complementing Playwright's capabilities.
+### Custom HTML Logger
+
+Gain insights with detailed logs for nested locators, integrated with Playwright's HTML report. Or use the Log fixture throughout your own POCs and tests to easily attach them to the HTML report based on log levels.
+
+### SessionStorage Handling
+
+Enhance your tests with advanced sessionStorage handling capabilities.
 
 ## Installation
 
+Ensure you have Node.js installed, then run:
+
 ```bash
 npm install pomwright --save-dev
 ```
 
+or
+
+```bash
+pnpm i -D pomwright
+```
+
+## Playwright Example Project
+
+Explore POMWright in action by diving into the example project located in the "example" folder. Follow these steps to get started:
+
+### Install
+
+Navigate to the "example" folder and install the necessary dependencies:
+
+```bash
+pnpm install
+```
+
+### Playwright browsers
+
+Install or update Playwright browsers:
+
+```bash
+pnpm playwright install --with-deps
+```
+
+### Run tests
+
+Execute tests across chromium, firefox, and webkit:
+
+```bash
+pnpm playwright test
+```
+
+### Parallelism
+
+Control parallel test execution. By default, up to 4 tests run in parallel. Modify this setting as needed:
+
+```bash
+pnpm playwright test --workers 2  # Set the number of parallel workers
+```
+
+### Reports
+
+After the tests complete, a Playwright HTML report is available in ./example/playwright-report. Open the index.html file in your browser to view the results.
+
 ## Usage
 
-**Simple example of creating a Page Object Class:**
+Dive into using POMWright with these examples:
+
+### Create a Page Object Class (POC)
 
 ```TS
 import { Page, TestInfo } from "@playwright/test";
-import { POMWright, POMWrightLogger } from "pomwright";
+import { BasePage, PlaywrightReportLogger, GetByMethod } from "pomwright";
 
 type LocatorSchemaPath = 
   | "content"
@@ -49,8 +114,8 @@ type LocatorSchemaPath =
   | "content.region.details"
   | "content.region.details.button.edit";
 
-export default class Profile extends POMWright<LocatorSchemaPath> {
-  constructor(page: Page, testInfo: TestInfo, pwrl: POMWrightLogger) {
+export default class Profile extends BasePage<LocatorSchemaPath> {
+  constructor(page: Page, testInfo: TestInfo, pwrl: PlaywrightReportLogger) {
     super(page, testInfo, "https://someDomain.com", "/profile", Profile.name, pwrl);
   }
 
@@ -64,7 +129,7 @@ export default class Profile extends POMWright<LocatorSchemaPath> {
       role: "heading",
       roleOptions: {
         name: "Your Profile"
-      }
+      },
       locatorMethod: GetByMethod.role
     });
 
@@ -72,7 +137,7 @@ export default class Profile extends POMWright<LocatorSchemaPath> {
       role: "region",
       roleOptions: {
         name: "Profile Details"
-      }
+      },
       locatorMethod: GetByMethod.role
     });
 
@@ -80,7 +145,7 @@ export default class Profile extends POMWright<LocatorSchemaPath> {
       role: "button",
       roleOptions: {
         name: "Edit"
-      }
+      },
       locatorMethod: GetByMethod.role
     });
   }
@@ -89,10 +154,10 @@ export default class Profile extends POMWright<LocatorSchemaPath> {
 }
 ```
 
-**Creating a Custom Playwright Fixture for the Profile POC:**
+### Creating a Custom Playwright Fixture
 
 ```TS
-import { POMWrightTestFixture as base } from "pomwright";
+import { test as base } from "pomwright";
 import Profile from "...";
 
 type fixtures = {
@@ -107,7 +172,9 @@ export const test = base.extend<fixtures>({
 });
 ```
 
-**Using the fixture in a Playwright tests:**
+### Using the fixture in a Playwright tests
+
+#### Click edit button with a single locator
 
 ```TS
 import { test } from ".../fixtures";
@@ -127,6 +194,8 @@ test("click edit button with a single locator", async ({ profile }) => {
 });
 ```
 
+#### Click edit button with a nested locator
+
 ```TS
 import { test } from ".../fixtures";
 
@@ -148,6 +217,8 @@ test("click edit button with a nested locator", async ({ profile }) => {
 });
 ```
 
+#### Specify index for nested locator(s)
+
 ```TS
 import { test } from ".../fixtures";
 
@@ -171,6 +242,8 @@ test("specify index for nested locator(s)", async ({ profile }) => {
 });
 ```
 
+#### Update a locator before use
+
 ```TS
 import { test } from ".../fixtures";
 
@@ -194,6 +267,8 @@ test("update a locator before use", async ({ profile }) => {
 });
 ```
 
+#### Update a nested locator before use
+
 ```TS
 import { test } from ".../fixtures";
 
@@ -222,6 +297,8 @@ test("update a nested locator before use", async ({ profile }) => {
 });
 ```
 
+#### Make multiple versions of a locator
+
 ```TS
 import { test } from ".../fixtures";
 
@@ -247,3 +324,15 @@ test("make multiple versions of a locator", async ({ profile }) => {
 
 });
 ```
+
+## Troubleshooting and Support
+
+If you encounter any issues or have questions, please check our issues page or reach out to us directly.
+
+## Contributing
+
+Pull Requests are welcome!
+
+## License
+
+POMWright is open-source software licensed under the Apache-2.0 license

package/biome.json

@@ -1,15 +1,20 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.2.2/schema.json",
-  "organizeImports": {
-    "enabled": true
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true
-    }
-  },
-  "formatter": {
-    "formatWithErrors": true
-  }
-}
+	"$schema": "https://biomejs.dev/schemas/1.2.2/schema.json",
+	"organizeImports": {
+		"enabled": true
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true
+		}
+	},
+	"formatter": {
+		"enabled": true,
+		"formatWithErrors": true,
+		"indentStyle": "tab",
+		"indentWidth": 2,
+		"lineWidth": 120,
+		"ignore": []
+	}
+}