playwright-clipboard-testing 0.4.0 → 0.6.0

package/dist/index.cjs

@@ -18,27 +18,15 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  ClipboardHandler: () => ClipboardHandler,
-  clipboardFixture: () => clipboardFixture,
-  clipboardFixtures: () => clipboardFixtures,
-  clipboardMatchers: () => clipboardMatchers,
-  contextFixture: () => contextFixture,
-  expect: () => expect3,
-  firefoxClipboardPrefs: () => firefoxClipboardPrefs,
+var src_exports = {};
+__export(src_exports, {
+  expect: () => expect6,
   test: () => test
 });
-module.exports = __toCommonJS(index_exports);
-
-// 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
-};
+module.exports = __toCommonJS(src_exports);
+
+// src/baseFixtures.ts
+var import_test6 = require("@playwright/test");
 
 // src/utils/clipboardHandler.ts
 var ClipboardHandler = class {
@@ -69,9 +57,43 @@ 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
@@ -100,10 +122,7 @@ var clipboardFixtures = {
   clipboard: clipboardFixture
 };
 
-// src/fixtures.ts
-var import_test3 = require("@playwright/test");
-
-// src/matchers/toHaveJSONContent.ts
+// src/matchers/toBeBlank.ts
 var import_test = require("@playwright/test");
 
 // src/utils/matcherUtils.ts
@@ -121,15 +140,116 @@ ${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/toBeBlank.ts
+async function toBeBlank(clipboard, options = {}) {
+  const name = "toBeBlank";
+  let pass;
+  let actual;
+  let normalizedActual;
+  const expected = "";
+  let errorReason = null;
+  const { timeout = 1e4, trim = false } = options;
+  const poll = import_test.expect.poll(
+    async () => {
+      try {
+        actual = await clipboard.read();
+        normalizedActual = actual;
+        normalizedActual = normalizeText(normalizedActual, { 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;
+    await expectation.toEqual(expected);
+    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/toHaveContentLength.ts
+var import_test2 = require("@playwright/test");
+async function toHaveContentLength(clipboard, expected, options = {}) {
+  const name = "toHaveContentLength";
+  let pass;
+  let actual;
+  let errorReason = null;
+  const { timeout = 1e4, trim = false } = options;
+  const poll = import_test2.expect.poll(
+    async () => {
+      try {
+        actual = await clipboard.read();
+        actual = normalizeText(actual, { trim });
+        errorReason = null;
+        return actual;
+      } catch (error) {
+        errorReason = error instanceof Error ? error : new Error(String(error));
+        actual = void 0;
+        throw errorReason;
+      }
+    },
+    { timeout }
+  );
+  try {
+    const expectation = this.isNot ? poll.not : poll;
+    await expectation.toHaveLength(expected);
+    pass = true;
+  } catch {
+    pass = false;
+  }
+  if (this.isNot) pass = !pass;
+  const matcherReturn = {
+    message: getErrorMessage.call(this, name, expected, actual?.length, errorReason),
+    pass,
+    name,
+    expected,
+    actual: actual?.length
+  };
+  return matcherReturn;
+}
 
 // src/matchers/toHaveJSONContent.ts
+var import_test3 = require("@playwright/test");
 async function toHaveJSONContent(clipboard, expected, options = {}) {
   const name = "toHaveJSONContent";
   let pass;
   let actual;
   let errorReason = null;
   const { timeout = 1e4 } = options;
-  const poll = import_test.expect.poll(
+  const poll = import_test3.expect.poll(
     async () => {
       try {
         actual = await clipboard.readJSON();
@@ -166,22 +286,27 @@ async function toHaveJSONContent(clipboard, expected, options = {}) {
 }
 
 // src/matchers/toHaveTextContent.ts
-var import_test2 = require("@playwright/test");
+var import_test4 = require("@playwright/test");
 async function toHaveTextContent(clipboard, expected, options = {}) {
   const name = "toHaveTextContent";
   let pass;
   let actual;
+  let normalizedActual;
   let errorReason = null;
-  const { timeout = 1e4 } = options;
-  const poll = import_test2.expect.poll(
+  const { timeout = 1e4, ignoreCase = false, trim = false } = options;
+  const normalizedExpected = normalizeText(expected, { ignoreCase, trim });
+  const poll = import_test4.expect.poll(
     async () => {
       try {
         actual = await clipboard.read();
+        normalizedActual = actual;
+        normalizedActual = normalizeText(normalizedActual, { ignoreCase, trim });
         errorReason = null;
-        return actual;
+        return normalizedActual;
       } catch (error) {
         errorReason = error instanceof Error ? error : new Error(String(error));
         actual = void 0;
+        normalizedActual = void 0;
         throw errorReason;
       }
     },
@@ -189,7 +314,11 @@ async function toHaveTextContent(clipboard, expected, options = {}) {
   );
   try {
     const expectation = this.isNot ? poll.not : poll;
-    await expectation.toEqual(expected);
+    if (expected instanceof RegExp) {
+      await expectation.toMatch(normalizedExpected);
+    } else {
+      await expectation.toEqual(normalizedExpected);
+    }
     pass = true;
   } catch {
     pass = false;
@@ -205,44 +334,65 @@ async function toHaveTextContent(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 toHaveTextContent.call(this, clipboard, expected, options);
-  } else {
-    matcherReturn = await toHaveJSONContent.call(this, clipboard, expected, options);
-  }
-  return {
-    ...matcherReturn,
+// src/matchers/toMatchJSONContent.ts
+var import_test5 = require("@playwright/test");
+async function toMatchJSONContent(clipboard, expected, options = {}) {
+  const name = "toMatchJSONContent";
+  let pass;
+  let actual;
+  let errorReason = null;
+  const { timeout = 1e4 } = options;
+  const poll = import_test5.expect.poll(
+    async () => {
+      try {
+        actual = await clipboard.readJSON();
+        errorReason = null;
+        return actual;
+      } catch (error) {
+        errorReason = error instanceof Error ? error : new Error(String(error));
+        try {
+          actual = await clipboard.read();
+        } catch {
+          actual = void 0;
+        }
+        throw errorReason;
+      }
+    },
+    { timeout }
+  );
+  try {
+    const expectation = this.isNot ? poll.not : poll;
+    await expectation.toMatchObject(expected);
+    pass = true;
+  } catch {
+    pass = false;
+  }
+  if (this.isNot) pass = !pass;
+  const matcherReturn = {
+    message: getErrorMessage.call(this, name, expected, actual, errorReason),
+    pass,
     name,
-    message: () => {
-      const originalMessage = matcherReturn.message();
-      return originalMessage.replace("toHaveText", name).replace("toHaveJSON", name);
-    }
+    expected,
+    actual
   };
+  return matcherReturn;
 }
 
 // src/matchers/clipboardMatchers.ts
 var clipboardMatchers = {
-  toHaveTextContent,
+  toBeBlank,
+  toHaveContentLength,
   toHaveJSONContent,
-  toHaveData
+  toHaveTextContent,
+  toMatchJSONContent
 };
 
-// src/fixtures.ts
-var test = import_test3.test.extend(clipboardFixtures);
-var expect3 = import_test3.expect.extend({ ...clipboardMatchers });
+// src/baseFixtures.ts
+var test = import_test6.test.extend(clipboardFixtures);
+var expect6 = import_test6.expect.extend({ ...clipboardMatchers });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ClipboardHandler,
-  clipboardFixture,
-  clipboardFixtures,
-  clipboardMatchers,
-  contextFixture,
   expect,
-  firefoxClipboardPrefs,
   test
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/utils/clipboardHandler.ts","../src/fixtures/clipboardFixture.ts","../src/fixtures/contextFixture.ts","../src/fixtures/index.ts","../src/fixtures.ts","../src/matchers/toHaveJSONContent.ts","../src/utils/matcherUtils.ts","../src/matchers/toHaveTextContent.ts","../src/matchers/toHaveData.ts","../src/matchers/clipboardMatchers.ts"],"sourcesContent":["export { firefoxClipboardPrefs } from './constants.js';\nexport { clipboardFixture, clipboardFixtures, contextFixture } from './fixtures/index.js';\nexport { expect, test } from './fixtures.js';\nexport { clipboardMatchers } from './matchers/index.js';\nexport { ClipboardHandler } from './utils/index.js';\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 * 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(`Clipboard content is not a valid JSON: ${JSON.stringify(text)}`);\n    }\n  }\n}\n","import type { Page, TestFixture } from '@playwright/test';\nimport type { BrowserName } from '../types.js';\nimport { ClipboardHandler } from '../utils/index.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; 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.js';\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.js';\nimport { contextFixture } from './contextFixture.js';\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 { expect as baseExpect, test as baseTest } from '@playwright/test';\nimport { clipboardFixtures } from './fixtures/index.js';\nimport { clipboardMatchers } from './matchers/index.js';\nimport type { ClipboardHandler } from './utils/index.js';\n\nexport const test = baseTest.extend<{\n  clipboard: ClipboardHandler;\n}>(clipboardFixtures);\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 toHaveJSONContent(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: unknown,\n  options: MatcherOptions = {},\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 } 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 toHaveTextContent(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: string,\n  options: MatcherOptions = {},\n) {\n  const name = 'toHaveTextContent';\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 { toHaveJSONContent } from './toHaveJSONContent.js';\nimport { toHaveTextContent } from './toHaveTextContent.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 toHaveTextContent.call(this, clipboard, expected, options);\n  } else {\n    matcherReturn = await toHaveJSONContent.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 { toHaveJSONContent } from './toHaveJSONContent.js';\nimport { toHaveTextContent } from './toHaveTextContent.js';\n\n/**\n * Export an object containing all the custom clipboard matchers for Playwright.\n */\nexport const clipboardMatchers = {\n  toHaveTextContent,\n  toHaveJSONContent,\n  toHaveData,\n};\n"],"mappings":"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","names":["expect","import_test","import_test","baseTest","expect","baseExpect"]}
+{"version":3,"sources":["../src/index.ts","../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/toHaveContentLength.ts","../src/matchers/toHaveJSONContent.ts","../src/matchers/toHaveTextContent.ts","../src/matchers/toMatchJSONContent.ts","../src/matchers/clipboardMatchers.ts"],"sourcesContent":["export { expect, test } from './baseFixtures.ts';\n","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.ts';\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.ts';\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 { ClipboardHandler } from '../utils';\nimport { clipboardFixture } from './clipboardFixture.ts';\nimport { contextFixture } from './contextFixture.ts';\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 { ClipboardHandler, clipboardFixture, contextFixture };\n","import { type ExpectMatcherState, expect, type MatcherReturnType } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils';\nimport { getErrorMessage, normalizeText } from '../utils/matcherUtils.ts';\nimport type { TimeoutMatcherOptions, TrimMatcherOptions } from './types.ts';\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, normalizeText } from '../utils/matcherUtils.ts';\nimport type { TimeoutMatcherOptions, TrimMatcherOptions } from './types.ts';\n\n/**\n * Asserts that the clipboard content has the expected length.\n *\n * @this ExpectMatcherState\n * @param clipboard The Clipboard utility instance.\n * @param expected The expected length of the clipboard content.\n * @param options Matcher options.\n * @returns A Promise that resolves to a MatcherReturnType object.\n */\nexport async function toHaveContentLength(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: number,\n  options: TimeoutMatcherOptions & TrimMatcherOptions = {},\n) {\n  const name = 'toHaveContentLength';\n  let pass: boolean;\n  let actual: string | undefined;\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\n        actual = normalizeText(actual, { trim });\n        errorReason = null;\n\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.toHaveLength(expected);\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?.length, errorReason),\n    pass,\n    name,\n    expected,\n    actual: actual?.length,\n  };\n\n  return matcherReturn;\n}\n","import type { ExpectMatcherState, MatcherReturnType } from '@playwright/test';\nimport { expect } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils';\nimport { getErrorMessage } from '../utils/matcherUtils.ts';\nimport type { TimeoutMatcherOptions } from './types.ts';\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\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.ts';\nimport type {\n  IgnoreCaseMatcherOptions,\n  TimeoutMatcherOptions,\n  TrimMatcherOptions,\n} from './types.ts';\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 type { ExpectMatcherState, MatcherReturnType } from '@playwright/test';\nimport { expect } from '@playwright/test';\nimport type { ClipboardHandler } from '../utils';\nimport { getErrorMessage } from '../utils/matcherUtils.ts';\nimport type { TimeoutMatcherOptions } from './types.ts';\n\n/**\n * Asserts that the clipboard content contains 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 toMatchJSONContent(\n  this: ExpectMatcherState,\n  clipboard: ClipboardHandler,\n  expected: unknown,\n  options: TimeoutMatcherOptions = {},\n) {\n  const name = 'toMatchJSONContent';\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\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.toMatchObject(expected as Record<string, unknown>);\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 { toHaveContentLength } from './toHaveContentLength.ts';\nimport { toHaveJSONContent } from './toHaveJSONContent';\nimport { toHaveTextContent } from './toHaveTextContent';\nimport { toMatchJSONContent } from './toMatchJSONContent.ts';\n\n/**\n * Export an object containing all the custom clipboard matchers for Playwright.\n */\nexport const clipboardMatchers = {\n  toBeBlank,\n  toHaveContentLength,\n  toHaveJSONContent,\n  toHaveTextContent,\n  toMatchJSONContent,\n};\n"],"mappings":"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","names":["expect","import_test","import_test","import_test","import_test","import_test","baseTest","expect","baseExpect"]}

package/dist/index.d.cts

@@ -1,194 +1,17 @@
+import { t as toBeBlank, a as toHaveContentLength, b as toHaveJSONContent, c as toHaveTextContent, d as toMatchJSONContent } from './toBeBlank-uFClUdzK.cjs';
 import * as playwright_test from 'playwright/test';
-import * as playwright_core from 'playwright-core';
-import * as _playwright_test from '@playwright/test';
-import { Page, TestFixture, BrowserContext, ExpectMatcherState, MatcherReturnType } from '@playwright/test';
+import { C as ClipboardHandler } from './clipboardHandler-CFIUvkc0.cjs';
+import '@playwright/test';
 
-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;
-};
-
-type BrowserName = 'chromium' | 'firefox' | 'webkit';
-
-/**
- * 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>;
-}
-
-/**
- * A fixture that provides an instance of the Clipboard utility for interacting with the system clipboard.
- * It allows reading from the clipboard during tests.
- */
-declare const clipboardFixture: TestFixture<ClipboardHandler, {
-    page: Page;
-    browserName: BrowserName;
-}>;
-
-/**
- * A fixture that provides a BrowserContext with clipboard permissions granted for Chromium browsers.
- */
-declare const contextFixture: TestFixture<BrowserContext, {
-    context: BrowserContext;
-    browserName: BrowserName;
-}>;
-
-/**
- * A collection of fixtures related to clipboard testing, including the clipboard fixture and context fixture.
- * These fixtures can be used in Playwright tests to facilitate clipboard interactions and context management.
- */
-declare const clipboardFixtures: {
-    context: playwright_test.TestFixture<playwright_core.BrowserContext, {
-        context: playwright_core.BrowserContext;
-        browserName: BrowserName;
-    }>;
-    clipboard: playwright_test.TestFixture<ClipboardHandler, {
-        page: playwright_core.Page;
-        browserName: BrowserName;
-    }>;
-};
-
-type MatcherOptions = {
-    timeout?: number;
-};
-declare global {
-    namespace PlaywrightTest {
-        interface Matchers<R> {
-            /**
-             * Asserts that the clipboard content matches the expected text.
-             * Uses smart polling to wait for the clipboard to be updated.
-             *
-             * @param expected The string to compare against the clipboard content.
-             * @param options Matcher options.
-             * @returns A Promise that resolves when the assertion completes.
-             *
-             * @example
-             * await expect(clipboard).toHaveText('Copied value');
-             */
-            toHaveTextContent(expected: string, options?: MatcherOptions): Promise<R>;
-            /**
-             * Asserts that the clipboard content matches the expected JSON value.
-             * Uses smart polling to wait for the clipboard to be updated.
-             *
-             * @param expected The JSON value to compare against the clipboard content.
-             * @param options Matcher options.
-             * @returns A Promise that resolves when the assertion completes.
-             *
-             * @example
-             * await expect(clipboard).toHaveJSON({ id: 123, status: 'success' });
-             */
-            toHaveJSONContent(expected: unknown, options?: MatcherOptions): Promise<R>;
-            /**
-             * Asserts that the clipboard content matches the expected value.
-             * Uses smart polling to wait for the clipboard to be updated.
-             * If the `expected` value is an object, it attempts to parse the clipboard
-             * content as JSON before comparing.
-             *
-             * @deprecated Use `toHaveText` or `toHaveJSON` instead. This matcher will be removed in future versions.
-             *
-             * @param expected The string or object to compare against the clipboard content.
-             * @param options Optional settings for the matcher, such as timeout.
-             * @returns A Promise that resolves when the assertion completes.
-             *
-             * @example
-             * await expect(clipboard).toHaveData('Copied value');
-             * await expect(clipboard).toHaveData({ id: 123, status: 'success' });
-             */
-            toHaveData(expected: unknown, options?: MatcherOptions): Promise<R>;
-        }
-    }
-}
-
-/**
- * Asserts that the clipboard content matches the expected value.
- * Uses smart polling to wait for the clipboard to be updated.
- * If the `expected` value is an object, it attempts to parse the clipboard
- * content as JSON before comparing.
- *
- * @this ExpectMatcherState
- * @param clipboard The Clipboard utility instance.
- * @param expected The string or object to compare against the clipboard content.
- * @param options Optional settings for the matcher, such as timeout.
- * @returns A Promise that resolves to a MatcherReturnType object.
- */
-declare function toHaveData(this: ExpectMatcherState, clipboard: ClipboardHandler, expected: unknown, options?: MatcherOptions): Promise<{
-    name: string;
-    message: () => string;
-    pass: boolean;
-    expected?: unknown;
-    actual?: any;
-    log?: string[];
-    timeout?: number;
-}>;
-
-/**
- * Asserts that the clipboard content matches the expected JSON value.
- *
- * @this ExpectMatcherState
- * @param clipboard The Clipboard utility instance.
- * @param expected The expected JSON value.
- * @param options Matcher options.
- * @returns A Promise that resolves to a MatcherReturnType object.
- */
-declare function toHaveJSONContent(this: ExpectMatcherState, clipboard: ClipboardHandler, expected: unknown, options?: MatcherOptions): Promise<MatcherReturnType>;
-
-/**
- * Asserts that the clipboard content matches the expected text value.
- *
- * @this ExpectMatcherState
- * @param clipboard The Clipboard utility instance.
- * @param expected The expected text value.
- * @param options Matcher options.
- * @returns A Promise that resolves to a MatcherReturnType object.
- */
-declare function toHaveTextContent(this: ExpectMatcherState, clipboard: ClipboardHandler, expected: string, options?: MatcherOptions): Promise<MatcherReturnType>;
-
-declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & {
+declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs & playwright_test.PlaywrightTestOptions & {
     clipboard: ClipboardHandler;
-}, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
-declare const expect: _playwright_test.Expect<{
-    toHaveTextContent: typeof toHaveTextContent;
+}, playwright_test.PlaywrightWorkerArgs & playwright_test.PlaywrightWorkerOptions>;
+declare const expect: playwright_test.Expect<{
+    toBeBlank: typeof toBeBlank;
+    toHaveContentLength: typeof toHaveContentLength;
     toHaveJSONContent: typeof toHaveJSONContent;
-    toHaveData: typeof toHaveData;
-}>;
-
-/**
- * Export an object containing all the custom clipboard matchers for Playwright.
- */
-declare const clipboardMatchers: {
     toHaveTextContent: typeof toHaveTextContent;
-    toHaveJSONContent: typeof toHaveJSONContent;
-    toHaveData: typeof toHaveData;
-};
+    toMatchJSONContent: typeof toMatchJSONContent;
+}>;
 
-export { ClipboardHandler, clipboardFixture, clipboardFixtures, clipboardMatchers, contextFixture, expect, firefoxClipboardPrefs, test };
+export { expect, test };