playwright-clipboard-testing 0.5.0 → 0.6.0

package/README.md

@@ -24,12 +24,15 @@ Testing the Clipboard API in Playwright usually requires boilerplate code to man
 - [Usage](#usage)
   - [Direct Usage](#direct-usage) 
   - [Extended Usage](#extended-usage)
+- [Subpath Exports](#subpath-exports)
 - [API](#api)
   - [Fixtures](#fixtures)
   - [ClipboardHandler](#clipboardhandler)
   - [toBeBlank Matcher](#tobeblank-matcher)
+  - [toHaveContentLength Matcher](#tohavecontentlength-matcher)
   - [toHaveTextContent Matcher](#tohavetextcontent-matcher)
   - [toHaveJSONContent Matcher](#tohavejsoncontent-matcher)
+  - [toMatchJSONContent Matcher](#tomatchjsoncontent-matcher)
   - [PATTERNS](#patterns)
 - [Author](#author)
 - [License](#license)
@@ -58,7 +61,7 @@ test('should copy text to clipboard', async ({ page, clipboard, browserName }) =
 If your Playwright setup runs tests in Firefox, manually configure `firefoxUserPrefs` in your Playwright config:
 ```ts
 import { defineConfig, devices } from '@playwright/test';
-import { firefoxClipboardPrefs } from 'playwright-clipboard-testing';
+import { firefoxClipboardPrefs } from 'playwright-clipboard-testing/constants';
 
 export default defineConfig({
   projects: [
@@ -95,17 +98,26 @@ test('should copy text to clipboard', async ({ page, clipboard }) => {
 If you already have a custom test fixture file, extend Playwright's `test` and `expect` with `clipboardFixtures` and `clipboardMatchers`:
 ```ts
 import { expect as baseExpect, test as baseTest } from '@playwright/test';
-import {
-  type ClipboardHandler,
-  clipboardFixtures,
-  clipboardMatchers,
-} from 'playwright-clipboard-testing';
+import { type ClipboardHandler, clipboardFixtures } from 'playwright-clipboard-testing/fixtures';
+import { clipboardMatchers } from 'playwright-clipboard-testing/matchers';
 
 export const test = baseTest.extend<{ clipboard: ClipboardHandler }>(clipboardFixtures);
 
 export const expect = baseExpect.extend(clipboardMatchers);
+
 ```
 
+## Subpath Exports
+
+The package provides dedicated subpath exports to import specific utilities when extending Playwright:
+
+| Import Path                              | Exports                                                                       | Description                                                                                            |
+|:-----------------------------------------|:------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------|
+| `playwright-clipboard-testing`           | `test`, `expect`                                                              | Ready-to-use Playwright `test` runner and `expect` assertion function with built-in clipboard support. |
+| `playwright-clipboard-testing/constants` | `firefoxClipboardPrefs`, `PATTERNS`                                           | Firefox browser preferences for clipboard permissions and regex patterns for clipboard assertions.     |
+| `playwright-clipboard-testing/fixtures`  | `clipboardFixtures`, `clipboardFixture`, `contextFixture`, `ClipboardHandler` | Playwright test fixtures and `ClipboardHandler` class for extending custom test setups.                |
+| `playwright-clipboard-testing/matchers`  | `clipboardMatchers`                                                           | Custom Playwright matchers for extending custom `expect`.                                              |
+
 ## API
 
 ### Fixtures
@@ -118,13 +130,13 @@ The package exports the following fixtures for Playwright test configuration:
 ### ClipboardHandler
 The `clipboard` fixture provides direct access to the `ClipboardHandler` instance for managing clipboard state:
 
-| Method                         | Return Type       | Description                                                                                                              |
-|:-------------------------------|:------------------|:-------------------------------------------------------------------------------------------------------------------------|
-| `clipboard.read()`             | `Promise<string>` | Reads plain text content from the clipboard.                                                                             |
-| `clipboard.write(text)`        | `Promise<void>`   | Writes the specified plain text to the clipboard.                                                                        |
-| `clipboard.readJSON<T>()`      | `Promise<T>`      | Reads clipboard content and parses it as a JSON object of type `T`. Throws an error if invalid JSON.                     |
-| `clipboard.writeJSON<T>(data)` | `Promise<void>`   | Serializes an object of type `T` to JSON and writes it to the clipboard. Throws an error if object cannot be serialized. |
-| `clipboard.clear()`            | `Promise<void>`   | Clears all clipboard content.                                                                                            |
+| Method               | Return Type       | Description                                                                                                              |
+|:---------------------|:------------------|:-------------------------------------------------------------------------------------------------------------------------|
+| `read()`             | `Promise<string>` | Reads plain text content from the clipboard.                                                                             |
+| `write(text)`        | `Promise<void>`   | Writes the specified plain text to the clipboard.                                                                        |
+| `readJSON<T>()`      | `Promise<T>`      | Reads clipboard content and parses it as a JSON object of type `T`. Throws an error if invalid JSON.                     |
+| `writeJSON<T>(data)` | `Promise<void>`   | Serializes an object of type `T` to JSON and writes it to the clipboard. Throws an error if object cannot be serialized. |
+| `clear()`            | `Promise<void>`   | Clears all clipboard content.                                                                                            |
 
 ![NOTE](https://img.shields.io/badge/NOTE-For%20your%20tests%20we%20recommend%20using%20existing%20matchers%20to%20assert%20clipboard%20content-yellow)
 
@@ -142,6 +154,22 @@ await expect(clipboard).toBeBlank();
 await expect(clipboard).not.toBeBlank({ timeout: 5000 });
 ```
 
+### toHaveContentLength Matcher
+`expect(clipboard).toHaveContentLength(expected, options?)`
+
+Asserts that the clipboard content has the expected length. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
+- `expected: number` — Expected length of the clipboard content.
+- `options.timeout: number (optional, default: 10000ms)` — Time in milliseconds to wait for the clipboard content to match.
+- `options.trim: boolean (optional, default: false)` — Trims whitespace from the clipboard content before checking its length.
+```ts
+// assert that the clipboard content has the expected length
+await expect(clipboard).toHaveContentLength(13);
+```
+```ts
+// assert that the clipboard content does not have the expected length with trim option
+await expect(clipboard).not.toHaveContentLength(10, { trim: true });
+```
+
 ### toHaveTextContent Matcher
 `expect(clipboard).toHaveTextContent(expected, options?)`
 
@@ -177,22 +205,39 @@ await expect(clipboard).toHaveJSONContent({ message: 'Hello, World!' });
 await expect(clipboard).not.toHaveJSONContent({ message: 'Async copied value' }, { timeout: 5000 });
 ```
 
+### toMatchJSONContent Matcher
+`expect(clipboard).toMatchJSONContent(expected, options?)`
+Asserts that the expected JSON object is a subset of the clipboard content. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
+- `expected: unknown` — Expected JSON subset object to compare against.
+- `options.timeout: number (optional, default: 10000ms)` — Time in milliseconds to wait for the clipboard content to match.
+```ts
+// assert that the clipboard contains a subset of the expected JSON data
+await expect(clipboard).toMatchJSONContent({ status: 'success' });
+```
+```ts
+// assert that the clipboard is not containing a subset of the expected JSON data with a custom timeout
+await expect(clipboard).not.toMatchJSONContent({ status: 'failed' }, { timeout: 5000 });
+```
+
 ### PATTERNS
 The package exports pre-defined regular expression patterns for common data formats (`PATTERNS`), which can be passed directly to `toHaveTextContent`:
 
-| Pattern              | Description                          | Example Match                             |
-|:---------------------|:-------------------------------------|:------------------------------------------|
-| `PATTERNS.UUID`      | UUID v1–v5 format                    | `123e4567-e89b-12d3-a456-426614174000`    |
-| `PATTERNS.EMAIL`     | Email address format                 | `user@example.com`                        |
-| `PATTERNS.JWT`       | JWT token format                     | `header.payload.signature`                |
-| `PATTERNS.BEARER`    | Bearer authentication token format   | `Bearer token123`                         |
-| `PATTERNS.HEX_COLOR` | HEX color format                     | `#FFF`, `#FFFFFF`, `#FFFFFFFF`            |
-| `PATTERNS.IP.V4`     | IPv4 address format                  | `192.168.1.1`                             |
-| `PATTERNS.IP.V6`     | IPv6 address format                  | `2001:0db8:85a3:0000:0000:8a2e:0370:7334` |
-| `PATTERNS.IP.ANY`    | Any IP address format (IPv4 or IPv6) | `192.168.1.1` or `2001:db8::1`            |
-
+| Pattern     | Description                          | Example Match                             |
+|:------------|:-------------------------------------|:------------------------------------------|
+| `UUID`      | UUID v1–v5 format                    | `123e4567-e89b-12d3-a456-426614174000`    |
+| `EMAIL`     | Email address format                 | `user@example.com`                        |
+| `PHONE`     | Phone number in E.164 format         | `+1234567890`                             |
+| `JWT`       | JWT token format                     | `header.payload.signature`                |
+| `BEARER`    | Bearer authentication token format   | `Bearer token123`                         |
+| `HEX_COLOR` | HEX color format                     | `#FFF`, `#FFFFFF`, `#FFFFFFFF`            |
+| `IP.V4`     | IPv4 address format                  | `192.168.1.1`                             |
+| `IP.V6`     | IPv6 address format                  | `2001:0db8:85a3:0000:0000:8a2e:0370:7334` |
+| `IP.ANY`    | Any IP address format (IPv4 or IPv6) | `192.168.1.1` or `2001:db8::1`            |
+
+To use a pattern in your test, import `PATTERNS` and pass the desired pattern to `toHaveTextContent`:
 ```ts
-import { test, expect, PATTERNS } from 'playwright-clipboard-testing';
+import { expect, test } from 'playwright-clipboard-testing';
+import { PATTERNS } from 'playwright-clipboard-testing/constants';
 
 test('should copy UUID to clipboard', async ({ page, clipboard }) => {
   await page.goto('https://example.com');

package/dist/clipboardHandler-CFIUvkc0.d.cts

@@ -0,0 +1,51 @@
+import { Page } from '@playwright/test';
+
+/**
+ * Playwright-compatible Clipboard utilities.
+ *
+ * Core functions for interacting with the browser clipboard within Playwright tests.
+ * Provides wrappers for reading plain text and JSON.
+ *
+ * @remarks
+ * These utilities require 'clipboard-read' and 'clipboard-write' permissions
+ * to be granted in the browser context.
+ */
+
+declare class ClipboardHandler {
+    private readonly page;
+    constructor(page: Page);
+    /**
+     * Reads the current text content from the browser clipboard.
+     * If the content is a JSON-encoded string (e.g., has extra quotes),
+     * it will be returned as is. Use readJSON for automatic parsing.
+     *
+     * @returns A promise that resolves to the clipboard string content.
+     */
+    read(): Promise<string>;
+    /**
+     * Reads the clipboard content and parses it as JSON.
+     * If the content is a string literal (e.g., '"value"'), it returns the unwrapped string ('value').
+     *
+     * @template T - The expected type of the parsed JSON object.
+     * @returns A promise that resolves to the parsed JSON object of type T.
+     * @throws {Error} If the clipboard content is not a valid JSON string.
+     */
+    readJSON<T = unknown>(): Promise<T>;
+    /**
+     * Writes the provided string data to the browser clipboard.
+     * @param data The data to write to the clipboard.
+     */
+    write(data: string): Promise<void>;
+    /**
+     * Writes the provided data to the browser clipboard as a JSON string.
+     * @param data The data to write to the clipboard. It will be stringified as JSON.
+     */
+    writeJSON<T = unknown>(data: T): Promise<void>;
+    /**
+     * Clears the browser clipboard by writing an empty string to it.
+     * This effectively removes any existing content from the clipboard.
+     */
+    clear(): Promise<void>;
+}
+
+export { ClipboardHandler as C };

package/dist/clipboardHandler-CFIUvkc0.d.ts

@@ -0,0 +1,51 @@
+import { Page } from '@playwright/test';
+
+/**
+ * Playwright-compatible Clipboard utilities.
+ *
+ * Core functions for interacting with the browser clipboard within Playwright tests.
+ * Provides wrappers for reading plain text and JSON.
+ *
+ * @remarks
+ * These utilities require 'clipboard-read' and 'clipboard-write' permissions
+ * to be granted in the browser context.
+ */
+
+declare class ClipboardHandler {
+    private readonly page;
+    constructor(page: Page);
+    /**
+     * Reads the current text content from the browser clipboard.
+     * If the content is a JSON-encoded string (e.g., has extra quotes),
+     * it will be returned as is. Use readJSON for automatic parsing.
+     *
+     * @returns A promise that resolves to the clipboard string content.
+     */
+    read(): Promise<string>;
+    /**
+     * Reads the clipboard content and parses it as JSON.
+     * If the content is a string literal (e.g., '"value"'), it returns the unwrapped string ('value').
+     *
+     * @template T - The expected type of the parsed JSON object.
+     * @returns A promise that resolves to the parsed JSON object of type T.
+     * @throws {Error} If the clipboard content is not a valid JSON string.
+     */
+    readJSON<T = unknown>(): Promise<T>;
+    /**
+     * Writes the provided string data to the browser clipboard.
+     * @param data The data to write to the clipboard.
+     */
+    write(data: string): Promise<void>;
+    /**
+     * Writes the provided data to the browser clipboard as a JSON string.
+     * @param data The data to write to the clipboard. It will be stringified as JSON.
+     */
+    writeJSON<T = unknown>(data: T): Promise<void>;
+    /**
+     * Clears the browser clipboard by writing an empty string to it.
+     * This effectively removes any existing content from the clipboard.
+     */
+    clear(): Promise<void>;
+}
+
+export { ClipboardHandler as C };

package/dist/constants/index.cjs

@@ -0,0 +1,80 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/constants/index.ts
+var constants_exports = {};
+__export(constants_exports, {
+  PATTERNS: () => PATTERNS,
+  firefoxClipboardPrefs: () => firefoxClipboardPrefs
+});
+module.exports = __toCommonJS(constants_exports);
+
+// src/constants/constants.ts
+var firefoxClipboardPrefs = {
+  "dom.events.testing.asyncClipboard": true,
+  "dom.events.asyncClipboard.readText": true,
+  "dom.events.asyncClipboard.writeText": true,
+  "permissions.default.clipboard-read": 1,
+  "permissions.default.clipboard-write": 1
+};
+
+// src/constants/patterns.ts
+var PATTERNS = {
+  /**
+   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+   */
+  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+  /**
+   * Email addresses (example: user@example.com).
+   */
+  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+  /**
+   * Phone numbers in E.164 format (example: +1234567890).
+   */
+  PHONE: /^\+[1-9]\d{1,14}$/,
+  /**
+   * JWT tokens (example: header.payload.signature).
+   */
+  JWT: /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/,
+  /**
+   * Authorization Bearer tokens (example: Bearer <token>).
+   */
+  BEARER: /^Bearer\s+[a-zA-Z0-9._~+/-]+=*$/i,
+  /**
+   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+   */
+  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,
+  /**
+   * IP (IPv4, IPv6 or any).
+   */
+  IP: {
+    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
+    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,
+    /** Any IP address (IPv4 or IPv6) */
+    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PATTERNS,
+  firefoxClipboardPrefs
+});
+//# sourceMappingURL=index.cjs.map

package/dist/constants/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants/index.ts","../../src/constants/constants.ts","../../src/constants/patterns.ts"],"sourcesContent":["import { firefoxClipboardPrefs } from './constants.ts';\nimport { PATTERNS } from './patterns.ts';\n\nexport { firefoxClipboardPrefs, PATTERNS };\n","export const firefoxClipboardPrefs = {\n  'dom.events.testing.asyncClipboard': true,\n  'dom.events.asyncClipboard.readText': true,\n  'dom.events.asyncClipboard.writeText': true,\n  'permissions.default.clipboard-read': 1,\n  'permissions.default.clipboard-write': 1,\n};\n","/**\n * This module contains regular expression patterns for various common formats.\n * These patterns can be used for validation purposes in applications.\n */\nexport const PATTERNS = {\n  /**\n   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).\n   */\n  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,\n\n  /**\n   * Email addresses (example: user@example.com).\n   */\n  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/,\n\n  /**\n   * Phone numbers in E.164 format (example: +1234567890).\n   */\n  PHONE: /^\\+[1-9]\\d{1,14}$/,\n\n  /**\n   * JWT tokens (example: header.payload.signature).\n   */\n  JWT: /^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$/,\n\n  /**\n   * Authorization Bearer tokens (example: Bearer <token>).\n   */\n  BEARER: /^Bearer\\s+[a-zA-Z0-9._~+/-]+=*$/i,\n\n  /**\n   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).\n   */\n  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,\n\n  /**\n   * IP (IPv4, IPv6 or any).\n   */\n  IP: {\n    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */\n    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,\n\n    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */\n    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,\n\n    /** Any IP address (IPv4 or IPv6) */\n    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/,\n  },\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,wBAAwB;AAAA,EACnC,qCAAqC;AAAA,EACrC,sCAAsC;AAAA,EACtC,uCAAuC;AAAA,EACvC,sCAAsC;AAAA,EACtC,uCAAuC;AACzC;;;ACFO,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAItB,MAAM;AAAA;AAAA;AAAA;AAAA,EAKN,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,KAAK;AAAA;AAAA;AAAA;AAAA,EAKL,QAAQ;AAAA;AAAA;AAAA;AAAA,EAKR,WAAW;AAAA;AAAA;AAAA;AAAA,EAKX,IAAI;AAAA;AAAA,IAEF,IAAI;AAAA;AAAA,IAGJ,IAAI;AAAA;AAAA,IAGJ,KAAK;AAAA,EACP;AACF;","names":[]}

package/dist/constants/index.d.cts

@@ -0,0 +1,51 @@
+declare const firefoxClipboardPrefs: {
+    'dom.events.testing.asyncClipboard': boolean;
+    'dom.events.asyncClipboard.readText': boolean;
+    'dom.events.asyncClipboard.writeText': boolean;
+    'permissions.default.clipboard-read': number;
+    'permissions.default.clipboard-write': number;
+};
+
+/**
+ * This module contains regular expression patterns for various common formats.
+ * These patterns can be used for validation purposes in applications.
+ */
+declare const PATTERNS: {
+    /**
+     * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+     */
+    readonly UUID: RegExp;
+    /**
+     * Email addresses (example: user@example.com).
+     */
+    readonly EMAIL: RegExp;
+    /**
+     * Phone numbers in E.164 format (example: +1234567890).
+     */
+    readonly PHONE: RegExp;
+    /**
+     * JWT tokens (example: header.payload.signature).
+     */
+    readonly JWT: RegExp;
+    /**
+     * Authorization Bearer tokens (example: Bearer <token>).
+     */
+    readonly BEARER: RegExp;
+    /**
+     * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+     */
+    readonly HEX_COLOR: RegExp;
+    /**
+     * IP (IPv4, IPv6 or any).
+     */
+    readonly IP: {
+        /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+        readonly V4: RegExp;
+        /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+        readonly V6: RegExp;
+        /** Any IP address (IPv4 or IPv6) */
+        readonly ANY: RegExp;
+    };
+};
+
+export { PATTERNS, firefoxClipboardPrefs };

package/dist/constants/index.d.ts

@@ -0,0 +1,51 @@
+declare const firefoxClipboardPrefs: {
+    'dom.events.testing.asyncClipboard': boolean;
+    'dom.events.asyncClipboard.readText': boolean;
+    'dom.events.asyncClipboard.writeText': boolean;
+    'permissions.default.clipboard-read': number;
+    'permissions.default.clipboard-write': number;
+};
+
+/**
+ * This module contains regular expression patterns for various common formats.
+ * These patterns can be used for validation purposes in applications.
+ */
+declare const PATTERNS: {
+    /**
+     * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+     */
+    readonly UUID: RegExp;
+    /**
+     * Email addresses (example: user@example.com).
+     */
+    readonly EMAIL: RegExp;
+    /**
+     * Phone numbers in E.164 format (example: +1234567890).
+     */
+    readonly PHONE: RegExp;
+    /**
+     * JWT tokens (example: header.payload.signature).
+     */
+    readonly JWT: RegExp;
+    /**
+     * Authorization Bearer tokens (example: Bearer <token>).
+     */
+    readonly BEARER: RegExp;
+    /**
+     * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+     */
+    readonly HEX_COLOR: RegExp;
+    /**
+     * IP (IPv4, IPv6 or any).
+     */
+    readonly IP: {
+        /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+        readonly V4: RegExp;
+        /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+        readonly V6: RegExp;
+        /** Any IP address (IPv4 or IPv6) */
+        readonly ANY: RegExp;
+    };
+};
+
+export { PATTERNS, firefoxClipboardPrefs };

package/dist/constants/index.js

@@ -0,0 +1,52 @@
+// src/constants/constants.ts
+var firefoxClipboardPrefs = {
+  "dom.events.testing.asyncClipboard": true,
+  "dom.events.asyncClipboard.readText": true,
+  "dom.events.asyncClipboard.writeText": true,
+  "permissions.default.clipboard-read": 1,
+  "permissions.default.clipboard-write": 1
+};
+
+// src/constants/patterns.ts
+var PATTERNS = {
+  /**
+   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+   */
+  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+  /**
+   * Email addresses (example: user@example.com).
+   */
+  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+  /**
+   * Phone numbers in E.164 format (example: +1234567890).
+   */
+  PHONE: /^\+[1-9]\d{1,14}$/,
+  /**
+   * JWT tokens (example: header.payload.signature).
+   */
+  JWT: /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/,
+  /**
+   * Authorization Bearer tokens (example: Bearer <token>).
+   */
+  BEARER: /^Bearer\s+[a-zA-Z0-9._~+/-]+=*$/i,
+  /**
+   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+   */
+  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,
+  /**
+   * IP (IPv4, IPv6 or any).
+   */
+  IP: {
+    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
+    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,
+    /** Any IP address (IPv4 or IPv6) */
+    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/
+  }
+};
+export {
+  PATTERNS,
+  firefoxClipboardPrefs
+};
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants/constants.ts","../../src/constants/patterns.ts"],"sourcesContent":["export const firefoxClipboardPrefs = {\n  'dom.events.testing.asyncClipboard': true,\n  'dom.events.asyncClipboard.readText': true,\n  'dom.events.asyncClipboard.writeText': true,\n  'permissions.default.clipboard-read': 1,\n  'permissions.default.clipboard-write': 1,\n};\n","/**\n * This module contains regular expression patterns for various common formats.\n * These patterns can be used for validation purposes in applications.\n */\nexport const PATTERNS = {\n  /**\n   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).\n   */\n  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,\n\n  /**\n   * Email addresses (example: user@example.com).\n   */\n  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/,\n\n  /**\n   * Phone numbers in E.164 format (example: +1234567890).\n   */\n  PHONE: /^\\+[1-9]\\d{1,14}$/,\n\n  /**\n   * JWT tokens (example: header.payload.signature).\n   */\n  JWT: /^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$/,\n\n  /**\n   * Authorization Bearer tokens (example: Bearer <token>).\n   */\n  BEARER: /^Bearer\\s+[a-zA-Z0-9._~+/-]+=*$/i,\n\n  /**\n   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).\n   */\n  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,\n\n  /**\n   * IP (IPv4, IPv6 or any).\n   */\n  IP: {\n    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */\n    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,\n\n    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */\n    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,\n\n    /** Any IP address (IPv4 or IPv6) */\n    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/,\n  },\n} as const;\n"],"mappings":";AAAO,IAAM,wBAAwB;AAAA,EACnC,qCAAqC;AAAA,EACrC,sCAAsC;AAAA,EACtC,uCAAuC;AAAA,EACvC,sCAAsC;AAAA,EACtC,uCAAuC;AACzC;;;ACFO,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAItB,MAAM;AAAA;AAAA;AAAA;AAAA,EAKN,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,KAAK;AAAA;AAAA;AAAA;AAAA,EAKL,QAAQ;AAAA;AAAA;AAAA;AAAA,EAKR,WAAW;AAAA;AAAA;AAAA;AAAA,EAKX,IAAI;AAAA;AAAA,IAEF,IAAI;AAAA;AAAA,IAGJ,IAAI;AAAA;AAAA,IAGJ,KAAK;AAAA,EACP;AACF;","names":[]}

package/dist/fixtures/index.cjs

@@ -0,0 +1,130 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/fixtures/index.ts
+var fixtures_exports = {};
+__export(fixtures_exports, {
+  ClipboardHandler: () => ClipboardHandler,
+  clipboardFixture: () => clipboardFixture,
+  clipboardFixtures: () => clipboardFixtures,
+  contextFixture: () => contextFixture
+});
+module.exports = __toCommonJS(fixtures_exports);
+
+// src/utils/clipboardHandler.ts
+var ClipboardHandler = class {
+  constructor(page) {
+    this.page = page;
+  }
+  page;
+  /**
+   * Reads the current text content from the browser clipboard.
+   * If the content is a JSON-encoded string (e.g., has extra quotes),
+   * it will be returned as is. Use readJSON for automatic parsing.
+   *
+   * @returns A promise that resolves to the clipboard string content.
+   */
+  async read() {
+    return await this.page.evaluate(() => navigator.clipboard.readText());
+  }
+  /**
+   * Reads the clipboard content and parses it as JSON.
+   * If the content is a string literal (e.g., '"value"'), it returns the unwrapped string ('value').
+   *
+   * @template T - The expected type of the parsed JSON object.
+   * @returns A promise that resolves to the parsed JSON object of type T.
+   * @throws {Error} If the clipboard content is not a valid JSON string.
+   */
+  async readJSON() {
+    const text = await this.read();
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new Error(
+        `[playwright-clipboard] Clipboard content is not a valid JSON: ${JSON.stringify(text)}`
+      );
+    }
+  }
+  /**
+   * Writes the provided string data to the browser clipboard.
+   * @param data The data to write to the clipboard.
+   */
+  async write(data) {
+    await this.page.evaluate((value) => navigator.clipboard.writeText(value), data);
+  }
+  /**
+   * Writes the provided data to the browser clipboard as a JSON string.
+   * @param data The data to write to the clipboard. It will be stringified as JSON.
+   */
+  async writeJSON(data) {
+    const errorMessage = "[playwright-clipboard] Provided data cannot be stringified to valid JSON";
+    let jsonString;
+    try {
+      jsonString = JSON.stringify(data);
+    } catch (error) {
+      const message = error instanceof Error ? error : String(error);
+      throw new Error(`${errorMessage}: ${message}`);
+    }
+    if (jsonString === void 0) {
+      throw new Error(`${errorMessage} (received undefined).`);
+    }
+    await this.write(jsonString);
+  }
+  /**
+   * Clears the browser clipboard by writing an empty string to it.
+   * This effectively removes any existing content from the clipboard.
+   */
+  async clear() {
+    await this.write("");
+  }
+};
+
+// src/fixtures/clipboardFixture.ts
+var clipboardFixture = async ({ page, browserName }, use) => {
+  if (browserName === "webkit") {
+    throw new Error(
+      `[playwright-clipboard] Browser '${browserName}' is not supported. Clipboard API testing is currently supported only in Chromium-based and Firefox browsers.
+Add test.skip(browserName === 'webkit', 'Clipboard API is only supported in Chromium and Firefox'); to your test body.`
+    );
+  }
+  const handler = new ClipboardHandler(page);
+  await use(handler);
+};
+
+// src/fixtures/contextFixture.ts
+var contextFixture = async ({ context, browserName }, use) => {
+  if (browserName === "chromium") {
+    await context.grantPermissions(["clipboard-read", "clipboard-write"]);
+  }
+  await use(context);
+};
+
+// src/fixtures/index.ts
+var clipboardFixtures = {
+  context: contextFixture,
+  clipboard: clipboardFixture
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ClipboardHandler,
+  clipboardFixture,
+  clipboardFixtures,
+  contextFixture
+});
+//# sourceMappingURL=index.cjs.map