playwright-clipboard-testing 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,36 +1,12 @@
-// src/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/baseFixtures.ts
+import { expect as baseExpect, test as baseTest } from "@playwright/test";
 
 // src/utils/clipboardHandler.ts
 var ClipboardHandler = class {
-  constructor(page, context, browserName = "chromium") {
+  constructor(page) {
     this.page = page;
-    this.context = context;
-    this.browserName = browserName;
-    this.isPermissionGranted = false;
   }
   page;
-  context;
-  browserName;
-  isPermissionGranted;
-  /**
-   * Grants clipboard permissions to the Chromium browser context if not already granted.
-   * @private
-   */
-  async grantPermissions() {
-    if (this.browserName === "chromium") {
-      if (!this.isPermissionGranted) {
-        await this.context.grantPermissions(["clipboard-read", "clipboard-write"]);
-        this.isPermissionGranted = true;
-      }
-    }
-  }
   /**
    * Reads the current text content from the browser clipboard.
    * If the content is a JSON-encoded string (e.g., has extra quotes),
@@ -39,7 +15,6 @@ var ClipboardHandler = class {
    * @returns A promise that resolves to the clipboard string content.
    */
   async read() {
-    await this.grantPermissions();
     return await this.page.evaluate(() => navigator.clipboard.readText());
   }
   /**
@@ -55,27 +30,72 @@ var ClipboardHandler = class {
     try {
       return JSON.parse(text);
     } catch {
-      throw new Error(`Clipboard content is not a valid JSON: ${JSON.stringify(text)}`);
+      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, context, browserName }, use) => {
+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, context, browserName);
+  const handler = new ClipboardHandler(page);
   await use(handler);
 };
 
-// src/fixtures.ts
-import { expect as baseExpect, test as baseTest } from "@playwright/test";
+// src/fixtures/contextFixture.ts
+var contextFixture = async ({ context, browserName }, use) => {
+  if (browserName === "chromium") {
+    await context.grantPermissions(["clipboard-read", "clipboard-write"]);
+  }
+  await use(context);
+};
 
-// src/matchers/toHaveJSON.ts
+// src/fixtures/index.ts
+var clipboardFixtures = {
+  context: contextFixture,
+  clipboard: clipboardFixture
+};
+
+// src/matchers/toBeBlank.ts
 import { expect } from "@playwright/test";
 
 // src/utils/matcherUtils.ts
@@ -93,27 +113,43 @@ ${error.message}`;
   return () => message + `Expected: ${this.isNot ? "not " : ""}${this.utils.printExpected(expected)}
 Received: ${this.utils.printReceived(actual)}`;
 }
+function normalizeText(data, options = {}) {
+  const { ignoreCase, trim } = options;
+  if (typeof data === "string") {
+    let result = data;
+    if (trim) result = result.trim();
+    if (ignoreCase) result = result.toLowerCase();
+    return result;
+  }
+  if (data instanceof RegExp) {
+    const flags = data.flags.replace(/[gy]/g, "");
+    const clearFlags = ignoreCase && !flags.includes("i") ? `${flags}i` : flags;
+    return new RegExp(data.source, clearFlags);
+  }
+  return data;
+}
 
-// src/matchers/toHaveJSON.ts
-async function toHaveJSON(clipboard, expected, options = {}) {
-  const name = "toHaveJSON";
+// src/matchers/toBeBlank.ts
+async function toBeBlank(clipboard, options = {}) {
+  const name = "toBeBlank";
   let pass;
   let actual;
+  let normalizedActual;
+  const expected = "";
   let errorReason = null;
-  const { timeout = 1e4 } = options;
+  const { timeout = 1e4, trim = false } = options;
   const poll = expect.poll(
     async () => {
       try {
-        actual = await clipboard.readJSON();
+        actual = await clipboard.read();
+        normalizedActual = actual;
+        normalizedActual = normalizeText(normalizedActual, { trim });
         errorReason = null;
-        return actual;
+        return normalizedActual;
       } catch (error) {
         errorReason = error instanceof Error ? error : new Error(String(error));
-        try {
-          actual = await clipboard.read();
-        } catch {
-          actual = void 0;
-        }
+        actual = void 0;
+        normalizedActual = void 0;
         throw errorReason;
       }
     },
@@ -137,10 +173,10 @@ async function toHaveJSON(clipboard, expected, options = {}) {
   return matcherReturn;
 }
 
-// src/matchers/toHaveText.ts
+// src/matchers/toHaveJSONContent.ts
 import { expect as expect2 } from "@playwright/test";
-async function toHaveText(clipboard, expected, options = {}) {
-  const name = "toHaveText";
+async function toHaveJSONContent(clipboard, expected, options = {}) {
+  const name = "toHaveJSONContent";
   let pass;
   let actual;
   let errorReason = null;
@@ -148,12 +184,16 @@ async function toHaveText(clipboard, expected, options = {}) {
   const poll = expect2.poll(
     async () => {
       try {
-        actual = await clipboard.read();
+        actual = await clipboard.readJSON();
         errorReason = null;
         return actual;
       } catch (error) {
         errorReason = error instanceof Error ? error : new Error(String(error));
-        actual = void 0;
+        try {
+          actual = await clipboard.read();
+        } catch {
+          actual = void 0;
+        }
         throw errorReason;
       }
     },
@@ -177,46 +217,117 @@ async function toHaveText(clipboard, expected, options = {}) {
   return matcherReturn;
 }
 
-// src/matchers/toHaveData.ts
-async function toHaveData(clipboard, expected, options = {}) {
-  const name = "toHaveData";
-  let matcherReturn = null;
-  if (typeof expected === "string") {
-    matcherReturn = await toHaveText.call(this, clipboard, expected, options);
-  } else {
-    matcherReturn = await toHaveJSON.call(this, clipboard, expected, options);
-  }
-  return {
-    ...matcherReturn,
-    name,
-    message: () => {
-      const originalMessage = matcherReturn.message();
-      return originalMessage.replace("toHaveText", name).replace("toHaveJSON", name);
+// src/matchers/toHaveTextContent.ts
+import { expect as expect3 } from "@playwright/test";
+async function toHaveTextContent(clipboard, expected, options = {}) {
+  const name = "toHaveTextContent";
+  let pass;
+  let actual;
+  let normalizedActual;
+  let errorReason = null;
+  const { timeout = 1e4, ignoreCase = false, trim = false } = options;
+  const normalizedExpected = normalizeText(expected, { ignoreCase, trim });
+  const poll = expect3.poll(
+    async () => {
+      try {
+        actual = await clipboard.read();
+        normalizedActual = actual;
+        normalizedActual = normalizeText(normalizedActual, { ignoreCase, trim });
+        errorReason = null;
+        return normalizedActual;
+      } catch (error) {
+        errorReason = error instanceof Error ? error : new Error(String(error));
+        actual = void 0;
+        normalizedActual = void 0;
+        throw errorReason;
+      }
+    },
+    { timeout }
+  );
+  try {
+    const expectation = this.isNot ? poll.not : poll;
+    if (expected instanceof RegExp) {
+      await expectation.toMatch(normalizedExpected);
+    } else {
+      await expectation.toEqual(normalizedExpected);
     }
+    pass = true;
+  } catch {
+    pass = false;
+  }
+  if (this.isNot) pass = !pass;
+  const matcherReturn = {
+    message: getErrorMessage.call(this, name, expected, actual, errorReason),
+    pass,
+    name,
+    expected,
+    actual
   };
+  return matcherReturn;
 }
 
 // src/matchers/clipboardMatchers.ts
 var clipboardMatchers = {
-  toHaveText,
-  toHaveJSON,
-  toHaveData
+  toBeBlank,
+  toHaveJSONContent,
+  toHaveTextContent
+};
+
+// src/baseFixtures.ts
+var test = baseTest.extend(clipboardFixtures);
+var expect4 = baseExpect.extend({ ...clipboardMatchers });
+
+// src/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/fixtures.ts
-var test = baseTest.extend({
+// src/patterns.ts
+var PATTERNS = {
   /**
-   * A fixture that provides an instance of the Clipboard utility for interacting with the system clipboard.
-   * It allows reading from the clipboard during tests.
+   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
    */
-  clipboard: clipboardFixture
-});
-var expect3 = baseExpect.extend({ ...clipboardMatchers });
+  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,}$/,
+  /**
+   * 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 {
   ClipboardHandler,
+  PATTERNS,
   clipboardFixture,
+  clipboardFixtures,
   clipboardMatchers,
-  expect3 as expect,
+  contextFixture,
+  expect4 as expect,
   firefoxClipboardPrefs,
   test
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/utils/clipboardHandler.ts","../src/fixtures/clipboardFixture.ts","../src/fixtures.ts","../src/matchers/toHaveJSON.ts","../src/utils/matcherUtils.ts","../src/matchers/toHaveText.ts","../src/matchers/toHaveData.ts","../src/matchers/clipboardMatchers.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 * Playwright-compatible Clipboard utilities.\n *\n * Core functions for interacting with the browser clipboard within Playwright tests.\n * Provides wrappers for reading plain text and JSON.\n *\n * @remarks\n * These utilities require 'clipboard-read' and 'clipboard-write' permissions\n * to be granted in the browser context.\n */\n\nimport type { BrowserContext, Page } from '@playwright/test';\nimport type { BrowserName } from '../types.js';\n\nexport class ClipboardHandler {\n  private readonly browserName: BrowserName;\n  private isPermissionGranted: boolean;\n\n  constructor(\n    private readonly page: Page,\n    private readonly context: BrowserContext,\n    browserName: BrowserName = 'chromium',\n  ) {\n    this.browserName = browserName;\n    this.isPermissionGranted = false;\n  }\n\n  /**\n   * Grants clipboard permissions to the Chromium browser context if not already granted.\n   * @private\n   */\n  private async grantPermissions() {\n    if (this.browserName === 'chromium') {\n      if (!this.isPermissionGranted) {\n        await this.context.grantPermissions(['clipboard-read', 'clipboard-write']);\n        this.isPermissionGranted = true;\n      }\n    }\n  }\n\n  /**\n   * Reads the current text content from the browser clipboard.\n   * If the content is a JSON-encoded string (e.g., has extra quotes),\n   * it will be returned as is. Use readJSON for automatic parsing.\n   *\n   * @returns A promise that resolves to the clipboard string content.\n   */\n  async read(): Promise<string> {\n    await this.grantPermissions();\n    return await this.page.evaluate(() => navigator.clipboard.readText());\n  }\n\n  /**\n   * Reads the clipboard content and parses it as JSON.\n   * If the content is a string literal (e.g., '\"value\"'), it returns the unwrapped string ('value').\n   *\n   * @template T - The expected type of the parsed JSON object.\n   * @returns A promise that resolves to the parsed JSON object of type T.\n   * @throws {Error} If the clipboard content is not a valid JSON string.\n   */\n  async readJSON<T = unknown>(): Promise<T> {\n    const text = await this.read();\n    try {\n      return JSON.parse(text);\n    } catch {\n      throw new Error(`Clipboard content is not a valid JSON: ${JSON.stringify(text)}`);\n    }\n  }\n}\n","import type { BrowserContext, Page, TestFixture } from '@playwright/test';\nimport type { BrowserName } from '../types.js';\nimport { ClipboardHandler } from '../utils/clipboardHandler.js';\n\n/**\n * A fixture that provides an instance of the Clipboard utility for interacting with the system clipboard.\n * It allows reading from the clipboard during tests.\n */\nexport const clipboardFixture: TestFixture<\n  ClipboardHandler,\n  { page: Page; context: BrowserContext; browserName: BrowserName }\n> = async ({ page, context, browserName }, use) => {\n  if (browserName === 'webkit') {\n    throw new Error(\n      `[playwright-clipboard] Browser '${browserName}' is not supported. ` +\n        'Clipboard API testing is currently supported only in Chromium-based and Firefox browsers.\\n' +\n        `Add test.skip(browserName === 'webkit', 'Clipboard API is only supported in Chromium and Firefox'); to your test body.`,\n    );\n  }\n\n  const handler = new ClipboardHandler(page, context, browserName);\n  await use(handler);\n};\n","import { expect as baseExpect, test as baseTest } from '@playwright/test';\nimport { clipboardFixture } from './fixtures/clipboardFixture.js';\nimport { clipboardMatchers } from './matchers/clipboardMatchers.js';\nimport type { ClipboardHandler } from './utils/clipboardHandler.js';\n\nexport const test = baseTest.extend<{\n  clipboard: ClipboardHandler;\n}>({\n  /**\n   * A fixture that provides an instance of the Clipboard utility for interacting with the system clipboard.\n   * It allows reading from the clipboard during tests.\n   */\n  clipboard: clipboardFixture,\n});\n\nexport const expect = baseExpect.extend({ ...clipboardMatchers });\n","import type { ExpectMatcherState, MatcherReturnType } from '@playwright/test';\nimport { expect } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils/clipboardHandler.js';\nimport { getErrorMessage } from '../utils/matcherUtils.js';\nimport type { MatcherOptions } from './types.js';\n\n/**\n * Asserts that the clipboard content matches the expected JSON value.\n *\n * @this ExpectMatcherState\n * @param clipboard The Clipboard utility instance.\n * @param expected The expected JSON value.\n * @param options Matcher options.\n * @returns A Promise that resolves to a MatcherReturnType object.\n */\nexport async function toHaveJSON(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: unknown,\n  options: MatcherOptions = {},\n) {\n  const name = 'toHaveJSON';\n  let pass: boolean;\n  let actual: unknown;\n  let errorReason: Error | null = null;\n\n  const { timeout = 10_000 } = options;\n\n  const poll = expect.poll(\n    async () => {\n      try {\n        actual = await clipboard.readJSON();\n        errorReason = null;\n        return actual;\n      } catch (error) {\n        errorReason = error instanceof Error ? error : new Error(String(error));\n\n        try {\n          actual = await clipboard.read();\n        } catch {\n          actual = undefined;\n        }\n\n        throw errorReason;\n      }\n    },\n    { timeout },\n  );\n\n  try {\n    const expectation = this.isNot ? poll.not : poll;\n    await expectation.toEqual(expected);\n    pass = true;\n  } catch {\n    pass = false;\n  }\n\n  if (this.isNot) pass = !pass;\n\n  const matcherReturn: MatcherReturnType = {\n    message: getErrorMessage.call(this, name, expected, actual, errorReason),\n    pass,\n    name,\n    expected,\n    actual,\n  };\n\n  return matcherReturn;\n}\n","import type { ExpectMatcherState } from '@playwright/test';\n\n/**\n * Generates an error message for a custom matcher.\n *\n * @this ExpectMatcherState\n * @param name The name of the matcher.\n * @param expected The expected value.\n * @param actual The actual value.\n * @param error An optional error object.\n * @param errorMessage An optional error message string.\n * @returns A function that returns the error message string.\n */\nexport function getErrorMessage(\n  this: ExpectMatcherState,\n  name: string,\n  expected: unknown,\n  actual: unknown,\n  error?: Error | null,\n  errorMessage?: string | undefined | null,\n): () => string {\n  const message = `${this.utils.matcherHint(name, undefined, undefined, { isNot: this.isNot })}\\n\\n`;\n\n  if (error) {\n    return () => `${message}An unexpected error occurred:\\n${error.message}`;\n  }\n\n  if (errorMessage) {\n    return () => `${message}${errorMessage}`;\n  }\n\n  return () =>\n    message +\n    `Expected: ${this.isNot ? 'not ' : ''}${this.utils.printExpected(expected)}\\n` +\n    `Received: ${this.utils.printReceived(actual)}`;\n}\n","import { type ExpectMatcherState, expect, type MatcherReturnType } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils/clipboardHandler.js';\nimport { getErrorMessage } from '../utils/matcherUtils.js';\nimport type { MatcherOptions } from './types.js';\n\n/**\n * Asserts that the clipboard content matches the expected text value.\n *\n * @this ExpectMatcherState\n * @param clipboard The Clipboard utility instance.\n * @param expected The expected text value.\n * @param options Matcher options.\n * @returns A Promise that resolves to a MatcherReturnType object.\n */\nexport async function toHaveText(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: string,\n  options: MatcherOptions = {},\n) {\n  const name = 'toHaveText';\n  let pass: boolean;\n  let actual: unknown;\n  let errorReason: Error | null = null;\n\n  const { timeout = 10_000 } = options;\n\n  const poll = expect.poll(\n    async () => {\n      try {\n        actual = await clipboard.read();\n        errorReason = null;\n        return actual;\n      } catch (error) {\n        errorReason = error instanceof Error ? error : new Error(String(error));\n        actual = undefined;\n\n        throw errorReason;\n      }\n    },\n    { timeout },\n  );\n\n  try {\n    const expectation = this.isNot ? poll.not : poll;\n    await expectation.toEqual(expected);\n    pass = true;\n  } catch {\n    pass = false;\n  }\n\n  if (this.isNot) pass = !pass;\n\n  const matcherReturn: MatcherReturnType = {\n    message: getErrorMessage.call(this, name, expected, actual, errorReason),\n    pass,\n    name,\n    expected,\n    actual,\n  };\n\n  return matcherReturn;\n}\n","import type { ExpectMatcherState, MatcherReturnType } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils/clipboardHandler.js';\nimport { toHaveJSON } from './toHaveJSON.js';\nimport { toHaveText } from './toHaveText.js';\nimport type { MatcherOptions } from './types.js';\n\n/**\n * Asserts that the clipboard content matches the expected value.\n * Uses smart polling to wait for the clipboard to be updated.\n * If the `expected` value is an object, it attempts to parse the clipboard\n * content as JSON before comparing.\n *\n * @this ExpectMatcherState\n * @param clipboard The Clipboard utility instance.\n * @param expected The string or object to compare against the clipboard content.\n * @param options Optional settings for the matcher, such as timeout.\n * @returns A Promise that resolves to a MatcherReturnType object.\n */\nexport async function toHaveData(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: unknown,\n  options: MatcherOptions = {},\n) {\n  const name = 'toHaveData';\n  let matcherReturn: MatcherReturnType | null = null;\n\n  if (typeof expected === 'string') {\n    matcherReturn = await toHaveText.call(this, clipboard, expected, options);\n  } else {\n    matcherReturn = await toHaveJSON.call(this, clipboard, expected, options);\n  }\n\n  return {\n    ...matcherReturn,\n    name,\n    message: () => {\n      const originalMessage = matcherReturn.message();\n      return originalMessage.replace('toHaveText', name).replace('toHaveJSON', name);\n    },\n  };\n}\n","import { toHaveData } from './toHaveData.js';\nimport { toHaveJSON } from './toHaveJSON.js';\nimport { toHaveText } from './toHaveText.js';\n\n/**\n * Export an object containing all the custom clipboard matchers for Playwright.\n */\nexport const clipboardMatchers = {\n  toHaveText,\n  toHaveJSON,\n  toHaveData,\n};\n"],"mappings":"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","names":["expect","expect","expect"]}
+{"version":3,"sources":["../src/baseFixtures.ts","../src/utils/clipboardHandler.ts","../src/fixtures/clipboardFixture.ts","../src/fixtures/contextFixture.ts","../src/fixtures/index.ts","../src/matchers/toBeBlank.ts","../src/utils/matcherUtils.ts","../src/matchers/toHaveJSONContent.ts","../src/matchers/toHaveTextContent.ts","../src/matchers/clipboardMatchers.ts","../src/constants.ts","../src/patterns.ts"],"sourcesContent":["import { expect as baseExpect, test as baseTest } from '@playwright/test';\nimport { clipboardFixtures } from './fixtures';\nimport { clipboardMatchers } from './matchers';\nimport type { ClipboardHandler } from './utils';\n\nexport const test = baseTest.extend<{\n  clipboard: ClipboardHandler;\n}>(clipboardFixtures);\n\nexport const expect = baseExpect.extend({ ...clipboardMatchers });\n","/**\n * Playwright-compatible Clipboard utilities.\n *\n * Core functions for interacting with the browser clipboard within Playwright tests.\n * Provides wrappers for reading plain text and JSON.\n *\n * @remarks\n * These utilities require 'clipboard-read' and 'clipboard-write' permissions\n * to be granted in the browser context.\n */\n\nimport type { Page } from '@playwright/test';\n\nexport class ClipboardHandler {\n  constructor(private readonly page: Page) {}\n\n  /**\n   * Reads the current text content from the browser clipboard.\n   * If the content is a JSON-encoded string (e.g., has extra quotes),\n   * it will be returned as is. Use readJSON for automatic parsing.\n   *\n   * @returns A promise that resolves to the clipboard string content.\n   */\n  async read(): Promise<string> {\n    return await this.page.evaluate(() => navigator.clipboard.readText());\n  }\n\n  /**\n   * Reads the clipboard content and parses it as JSON.\n   * If the content is a string literal (e.g., '\"value\"'), it returns the unwrapped string ('value').\n   *\n   * @template T - The expected type of the parsed JSON object.\n   * @returns A promise that resolves to the parsed JSON object of type T.\n   * @throws {Error} If the clipboard content is not a valid JSON string.\n   */\n  async readJSON<T = unknown>(): Promise<T> {\n    const text = await this.read();\n    try {\n      return JSON.parse(text);\n    } catch {\n      throw new Error(\n        `[playwright-clipboard] Clipboard content is not a valid JSON: ${JSON.stringify(text)}`,\n      );\n    }\n  }\n\n  /**\n   * Writes the provided string data to the browser clipboard.\n   * @param data The data to write to the clipboard.\n   */\n  async write(data: string): Promise<void> {\n    await this.page.evaluate((value) => navigator.clipboard.writeText(value), data);\n  }\n\n  /**\n   * Writes the provided data to the browser clipboard as a JSON string.\n   * @param data The data to write to the clipboard. It will be stringified as JSON.\n   */\n  async writeJSON<T = unknown>(data: T): Promise<void> {\n    const errorMessage = '[playwright-clipboard] Provided data cannot be stringified to valid JSON';\n    let jsonString: string | undefined;\n\n    try {\n      jsonString = JSON.stringify(data);\n    } catch (error) {\n      const message = error instanceof Error ? error : String(error);\n      throw new Error(`${errorMessage}: ${message}`);\n    }\n\n    if (jsonString === undefined) {\n      throw new Error(`${errorMessage} (received undefined).`);\n    }\n\n    await this.write(jsonString);\n  }\n\n  /**\n   * Clears the browser clipboard by writing an empty string to it.\n   * This effectively removes any existing content from the clipboard.\n   */\n  async clear(): Promise<void> {\n    await this.write('');\n  }\n}\n","import type { Page, TestFixture } from '@playwright/test';\nimport { ClipboardHandler } from '../utils';\nimport type { BrowserName } from './types';\n\n/**\n * A fixture that provides an instance of the Clipboard utility for interacting with the system clipboard.\n * It allows reading from the clipboard during tests.\n */\nexport const clipboardFixture: TestFixture<\n  ClipboardHandler,\n  { page: Page; browserName: BrowserName }\n> = async ({ page, browserName }, use) => {\n  if (browserName === 'webkit') {\n    throw new Error(\n      `[playwright-clipboard] Browser '${browserName}' is not supported. ` +\n        'Clipboard API testing is currently supported only in Chromium-based and Firefox browsers.\\n' +\n        `Add test.skip(browserName === 'webkit', 'Clipboard API is only supported in Chromium and Firefox'); to your test body.`,\n    );\n  }\n\n  const handler = new ClipboardHandler(page);\n  await use(handler);\n};\n","import type { BrowserContext, TestFixture } from '@playwright/test';\nimport type { BrowserName } from './types';\n\n/**\n * A fixture that provides a BrowserContext with clipboard permissions granted for Chromium browsers.\n */\nexport const contextFixture: TestFixture<\n  BrowserContext,\n  { context: BrowserContext; browserName: BrowserName }\n> = async ({ context, browserName }, use) => {\n  if (browserName === 'chromium') {\n    await context.grantPermissions(['clipboard-read', 'clipboard-write']);\n  }\n\n  await use(context);\n};\n","import { clipboardFixture } from './clipboardFixture';\nimport { contextFixture } from './contextFixture';\n\n/**\n * A collection of fixtures related to clipboard testing, including the clipboard fixture and context fixture.\n * These fixtures can be used in Playwright tests to facilitate clipboard interactions and context management.\n */\nexport const clipboardFixtures = {\n  context: contextFixture,\n  clipboard: clipboardFixture,\n};\n\nexport { clipboardFixture, contextFixture };\n","import { type ExpectMatcherState, expect, type MatcherReturnType } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils';\nimport { getErrorMessage, normalizeText } from '../utils/matcherUtils';\nimport type { TimeoutMatcherOptions, TrimMatcherOptions } from './types';\n\n/**\n * Asserts that the clipboard content is blank (empty string).\n *\n * @this ExpectMatcherState\n * @param clipboard The Clipboard utility instance.\n * @param options Matcher options.\n * @returns A Promise that resolves to a MatcherReturnType object.\n */\nexport async function toBeBlank(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  options: TimeoutMatcherOptions & TrimMatcherOptions = {},\n) {\n  const name = 'toBeBlank';\n  let pass: boolean;\n  let actual: string | undefined;\n  let normalizedActual: string | undefined;\n  const expected: string = '';\n  let errorReason: Error | null = null;\n\n  const { timeout = 10_000, trim = false } = options;\n\n  const poll = expect.poll(\n    async () => {\n      try {\n        actual = await clipboard.read();\n        normalizedActual = actual;\n        normalizedActual = normalizeText(normalizedActual, { trim });\n        errorReason = null;\n\n        return normalizedActual;\n      } catch (error) {\n        errorReason = error instanceof Error ? error : new Error(String(error));\n        actual = undefined;\n        normalizedActual = undefined;\n\n        throw errorReason;\n      }\n    },\n    { timeout },\n  );\n\n  try {\n    const expectation = this.isNot ? poll.not : poll;\n    await expectation.toEqual(expected);\n    pass = true;\n  } catch {\n    pass = false;\n  }\n\n  if (this.isNot) pass = !pass;\n\n  const matcherReturn: MatcherReturnType = {\n    message: getErrorMessage.call(this, name, expected, actual, errorReason),\n    pass,\n    name,\n    expected,\n    actual,\n  };\n\n  return matcherReturn;\n}\n","import type { ExpectMatcherState } from '@playwright/test';\n\n/**\n * Generates an error message for a custom matcher.\n *\n * @this ExpectMatcherState\n * @param name The name of the matcher.\n * @param expected The expected value.\n * @param actual The actual value.\n * @param error An optional error object.\n * @param errorMessage An optional error message string.\n * @returns A function that returns the error message string.\n */\nexport function getErrorMessage(\n  this: ExpectMatcherState,\n  name: string,\n  expected: unknown,\n  actual: unknown,\n  error?: Error | null,\n  errorMessage?: string | undefined | null,\n): () => string {\n  const message = `${this.utils.matcherHint(name, undefined, undefined, { isNot: this.isNot })}\\n\\n`;\n\n  if (error) {\n    return () => `${message}An unexpected error occurred:\\n${error.message}`;\n  }\n\n  if (errorMessage) {\n    return () => `${message}${errorMessage}`;\n  }\n\n  return () =>\n    message +\n    `Expected: ${this.isNot ? 'not ' : ''}${this.utils.printExpected(expected)}\\n` +\n    `Received: ${this.utils.printReceived(actual)}`;\n}\n\nexport function normalizeText<T extends string | RegExp>(\n  data: T,\n  options: { ignoreCase?: boolean; trim?: boolean } = {},\n): T {\n  const { ignoreCase, trim } = options;\n\n  if (typeof data === 'string') {\n    let result: string = data;\n\n    if (trim) result = result.trim();\n\n    if (ignoreCase) result = result.toLowerCase();\n\n    return result as T;\n  }\n\n  if (data instanceof RegExp) {\n    const flags = data.flags.replace(/[gy]/g, '');\n    const clearFlags = ignoreCase && !flags.includes('i') ? `${flags}i` : flags;\n\n    return new RegExp(data.source, clearFlags) as T;\n  }\n\n  return data;\n}\n","import type { ExpectMatcherState, MatcherReturnType } from '@playwright/test';\nimport { expect } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils';\nimport { getErrorMessage } from '../utils/matcherUtils';\nimport type { TimeoutMatcherOptions } from './types';\n\n/**\n * Asserts that the clipboard content matches the expected JSON value.\n *\n * @this ExpectMatcherState\n * @param clipboard The Clipboard utility instance.\n * @param expected The expected JSON value.\n * @param options Matcher options.\n * @returns A Promise that resolves to a MatcherReturnType object.\n */\nexport async function toHaveJSONContent(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: unknown,\n  options: TimeoutMatcherOptions = {},\n) {\n  const name = 'toHaveJSONContent';\n  let pass: boolean;\n  let actual: unknown;\n  let errorReason: Error | null = null;\n\n  const { timeout = 10_000 } = options;\n\n  const poll = expect.poll(\n    async () => {\n      try {\n        actual = await clipboard.readJSON();\n        errorReason = null;\n        return actual;\n      } catch (error) {\n        errorReason = error instanceof Error ? error : new Error(String(error));\n\n        try {\n          actual = await clipboard.read();\n        } catch {\n          actual = undefined;\n        }\n\n        throw errorReason;\n      }\n    },\n    { timeout },\n  );\n\n  try {\n    const expectation = this.isNot ? poll.not : poll;\n    await expectation.toEqual(expected);\n    pass = true;\n  } catch {\n    pass = false;\n  }\n\n  if (this.isNot) pass = !pass;\n\n  const matcherReturn: MatcherReturnType = {\n    message: getErrorMessage.call(this, name, expected, actual, errorReason),\n    pass,\n    name,\n    expected,\n    actual,\n  };\n\n  return matcherReturn;\n}\n","import { type ExpectMatcherState, expect, type MatcherReturnType } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils';\nimport { getErrorMessage, normalizeText } from '../utils/matcherUtils';\nimport type { IgnoreCaseMatcherOptions, TimeoutMatcherOptions, TrimMatcherOptions } from './types';\n\n/**\n * Asserts that the clipboard content matches the expected text value.\n *\n * @this ExpectMatcherState\n * @param clipboard The Clipboard utility instance.\n * @param expected The expected text value.\n * @param options Matcher options.\n * @returns A Promise that resolves to a MatcherReturnType object.\n */\nexport async function toHaveTextContent(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: string | RegExp,\n  options: TimeoutMatcherOptions & IgnoreCaseMatcherOptions & TrimMatcherOptions = {},\n) {\n  const name = 'toHaveTextContent';\n  let pass: boolean;\n  let actual: string | undefined;\n  let normalizedActual: string | undefined;\n  let errorReason: Error | null = null;\n\n  const { timeout = 10_000, ignoreCase = false, trim = false } = options;\n\n  const normalizedExpected = normalizeText(expected, { ignoreCase, trim });\n\n  const poll = expect.poll(\n    async () => {\n      try {\n        actual = await clipboard.read();\n\n        normalizedActual = actual;\n        normalizedActual = normalizeText(normalizedActual, { ignoreCase, trim });\n        errorReason = null;\n\n        return normalizedActual;\n      } catch (error) {\n        errorReason = error instanceof Error ? error : new Error(String(error));\n        actual = undefined;\n        normalizedActual = undefined;\n\n        throw errorReason;\n      }\n    },\n    { timeout },\n  );\n\n  try {\n    const expectation = this.isNot ? poll.not : poll;\n\n    if (expected instanceof RegExp) {\n      await expectation.toMatch(normalizedExpected as RegExp);\n    } else {\n      await expectation.toEqual(normalizedExpected);\n    }\n\n    pass = true;\n  } catch {\n    pass = false;\n  }\n\n  if (this.isNot) pass = !pass;\n\n  const matcherReturn: MatcherReturnType = {\n    message: getErrorMessage.call(this, name, expected, actual, errorReason),\n    pass,\n    name,\n    expected,\n    actual,\n  };\n\n  return matcherReturn;\n}\n","import { toBeBlank } from './toBeBlank';\nimport { toHaveJSONContent } from './toHaveJSONContent';\nimport { toHaveTextContent } from './toHaveTextContent';\n\n/**\n * Export an object containing all the custom clipboard matchers for Playwright.\n */\nexport const clipboardMatchers = {\n  toBeBlank,\n  toHaveJSONContent,\n  toHaveTextContent,\n};\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   * 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":"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","names":["expect","expect","expect","expect","expect"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright-clipboard-testing",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Playwright fixture and custom matchers for clipboard testing and assertions.",
   "author": "Sergii Oleksenko <serg.oleksenko@gmail.com>",
   "license": "MIT",
@@ -50,12 +50,18 @@
     "lint:fix": "biome check --write .",
     "typecheck": "tsc --noEmit",
     "format": "biome format --write .",
-    "test": "vitest run",
+    "serve": "serve tests/e2e/html -l 3000",
+    "test:unit": "vitest run",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test": "npm run test:unit && npm run test:e2e",
     "test:watch": "vitest"
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.10",
-    "@playwright/test": "1.62.1",
+    "@playwright/test": "^1.63.0",
+    "@types/node": "^26.4.1",
+    "serve": "^14.2.6",
     "tsup": "^8.5.1",
     "typescript": "5.8.3",
     "vitest": "^4.1.11"