@one2x/playwright 1.57.0-alpha.1

package/lib/matchers/toHaveURL.js

@@ -0,0 +1,102 @@
+"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);
+var toHaveURL_exports = {};
+__export(toHaveURL_exports, {
+  toHaveURLWithPredicate: () => toHaveURLWithPredicate
+});
+module.exports = __toCommonJS(toHaveURL_exports);
+var import_utils = require("playwright-core/lib/utils");
+var import_expect = require("./expect");
+var import_matcherHint = require("./matcherHint");
+var import_expectBundle = require("../common/expectBundle");
+async function toHaveURLWithPredicate(page, expected, options) {
+  const matcherName = "toHaveURL";
+  const timeout = options?.timeout ?? this.timeout;
+  const baseURL = page.context()._options.baseURL;
+  let conditionSucceeded = false;
+  let lastCheckedURLString = void 0;
+  try {
+    await page.mainFrame().waitForURL(
+      (url) => {
+        lastCheckedURLString = url.toString();
+        if (options?.ignoreCase) {
+          return !this.isNot === (0, import_utils.urlMatches)(
+            baseURL?.toLocaleLowerCase(),
+            lastCheckedURLString.toLocaleLowerCase(),
+            expected
+          );
+        }
+        return !this.isNot === (0, import_utils.urlMatches)(baseURL, lastCheckedURLString, expected);
+      },
+      { timeout }
+    );
+    conditionSucceeded = true;
+  } catch (e) {
+    conditionSucceeded = false;
+  }
+  if (conditionSucceeded)
+    return { name: matcherName, pass: !this.isNot, message: () => "" };
+  return {
+    name: matcherName,
+    pass: this.isNot,
+    message: () => toHaveURLMessage(
+      this,
+      matcherName,
+      expected,
+      lastCheckedURLString,
+      this.isNot,
+      true,
+      timeout
+    ),
+    actual: lastCheckedURLString,
+    timeout
+  };
+}
+function toHaveURLMessage(state, matcherName, expected, received, pass, timedOut, timeout) {
+  const receivedString = received || "";
+  let printedReceived;
+  let printedExpected;
+  let printedDiff;
+  if (typeof expected === "function") {
+    printedExpected = `Expected: predicate to ${!state.isNot ? "succeed" : "fail"}`;
+    printedReceived = `Received: ${(0, import_expectBundle.printReceived)(receivedString)}`;
+  } else {
+    if (pass) {
+      printedExpected = `Expected pattern: not ${state.utils.printExpected(expected)}`;
+      const formattedReceived = (0, import_expect.printReceivedStringContainExpectedResult)(receivedString, null);
+      printedReceived = `Received string: ${formattedReceived}`;
+    } else {
+      const labelExpected = `Expected ${typeof expected === "string" ? "string" : "pattern"}`;
+      printedDiff = state.utils.printDiffOrStringify(expected, receivedString, labelExpected, "Received string", false);
+    }
+  }
+  return (0, import_matcherHint.formatMatcherMessage)(state, {
+    matcherName,
+    expectation: "expected",
+    timeout,
+    timedOut,
+    printedExpected,
+    printedReceived,
+    printedDiff
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  toHaveURLWithPredicate
+});

package/lib/matchers/toHaveURL.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/matchers/toHaveURL.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { urlMatches } from 'playwright-core/lib/utils';\n\nimport { printReceivedStringContainExpectedResult } from './expect';\nimport { formatMatcherMessage } from './matcherHint';\nimport { printReceived } from '../common/expectBundle';\n\nimport type { MatcherResult } from './matcherHint';\nimport type { ExpectMatcherState } from '../../types/test';\nimport type { Page } from 'playwright-core';\n\nexport async function toHaveURLWithPredicate(\n  this: ExpectMatcherState,\n  page: Page,\n  expected: (url: URL) => boolean,\n  options?: { ignoreCase?: boolean; timeout?: number },\n): Promise<MatcherResult<string | RegExp, string>> {\n  const matcherName = 'toHaveURL';\n  const timeout = options?.timeout ?? this.timeout;\n  const baseURL: string | undefined = (page.context() as any)._options.baseURL;\n  let conditionSucceeded = false;\n  let lastCheckedURLString: string | undefined = undefined;\n  try {\n    await page.mainFrame().waitForURL(\n        url => {\n          lastCheckedURLString = url.toString();\n\n          if (options?.ignoreCase) {\n            return (\n              !this.isNot ===\n              urlMatches(\n                  baseURL?.toLocaleLowerCase(),\n                  lastCheckedURLString.toLocaleLowerCase(),\n                  expected,\n              )\n            );\n          }\n\n          return (\n            !this.isNot === urlMatches(baseURL, lastCheckedURLString, expected)\n          );\n        },\n        { timeout },\n    );\n\n    conditionSucceeded = true;\n  } catch (e) {\n    conditionSucceeded = false;\n  }\n\n  if (conditionSucceeded)\n    return { name: matcherName, pass: !this.isNot, message: () => '' };\n\n  return {\n    name: matcherName,\n    pass: this.isNot,\n    message: () =>\n      toHaveURLMessage(\n          this,\n          matcherName,\n          expected,\n          lastCheckedURLString,\n          this.isNot,\n          true,\n          timeout,\n      ),\n    actual: lastCheckedURLString,\n    timeout,\n  };\n}\n\nfunction toHaveURLMessage(\n  state: ExpectMatcherState,\n  matcherName: string,\n  expected: Function,\n  received: string | undefined,\n  pass: boolean,\n  timedOut: boolean,\n  timeout: number,\n): string {\n  const receivedString = received || '';\n\n  let printedReceived: string | undefined;\n  let printedExpected: string | undefined;\n  let printedDiff: string | undefined;\n  if (typeof expected === 'function') {\n    printedExpected = `Expected: predicate to ${!state.isNot ? 'succeed' : 'fail'}`;\n    printedReceived = `Received: ${printReceived(receivedString)}`;\n  } else {\n    if (pass) {\n      printedExpected = `Expected pattern: not ${state.utils.printExpected(expected)}`;\n      const formattedReceived = printReceivedStringContainExpectedResult(receivedString, null);\n      printedReceived = `Received string: ${formattedReceived}`;\n    } else {\n      const labelExpected = `Expected ${typeof expected === 'string' ? 'string' : 'pattern'}`;\n      printedDiff = state.utils.printDiffOrStringify(expected, receivedString, labelExpected, 'Received string', false);\n    }\n  }\n\n  return formatMatcherMessage(state, {\n    matcherName,\n    expectation: 'expected',\n    timeout,\n    timedOut,\n    printedExpected,\n    printedReceived,\n    printedDiff,\n  });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,mBAA2B;AAE3B,oBAAyD;AACzD,yBAAqC;AACrC,0BAA8B;AAM9B,eAAsB,uBAEpB,MACA,UACA,SACiD;AACjD,QAAM,cAAc;AACpB,QAAM,UAAU,SAAS,WAAW,KAAK;AACzC,QAAM,UAA+B,KAAK,QAAQ,EAAU,SAAS;AACrE,MAAI,qBAAqB;AACzB,MAAI,uBAA2C;AAC/C,MAAI;AACF,UAAM,KAAK,UAAU,EAAE;AAAA,MACnB,SAAO;AACL,+BAAuB,IAAI,SAAS;AAEpC,YAAI,SAAS,YAAY;AACvB,iBACE,CAAC,KAAK,cACN;AAAA,YACI,SAAS,kBAAkB;AAAA,YAC3B,qBAAqB,kBAAkB;AAAA,YACvC;AAAA,UACJ;AAAA,QAEJ;AAEA,eACE,CAAC,KAAK,cAAU,yBAAW,SAAS,sBAAsB,QAAQ;AAAA,MAEtE;AAAA,MACA,EAAE,QAAQ;AAAA,IACd;AAEA,yBAAqB;AAAA,EACvB,SAAS,GAAG;AACV,yBAAqB;AAAA,EACvB;AAEA,MAAI;AACF,WAAO,EAAE,MAAM,aAAa,MAAM,CAAC,KAAK,OAAO,SAAS,MAAM,GAAG;AAEnE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK;AAAA,IACX,SAAS,MACP;AAAA,MACI;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,KAAK;AAAA,MACL;AAAA,MACA;AAAA,IACJ;AAAA,IACF,QAAQ;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,iBACP,OACA,aACA,UACA,UACA,MACA,UACA,SACQ;AACR,QAAM,iBAAiB,YAAY;AAEnC,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI,OAAO,aAAa,YAAY;AAClC,sBAAkB,0BAA0B,CAAC,MAAM,QAAQ,YAAY,MAAM;AAC7E,sBAAkB,iBAAa,mCAAc,cAAc,CAAC;AAAA,EAC9D,OAAO;AACL,QAAI,MAAM;AACR,wBAAkB,yBAAyB,MAAM,MAAM,cAAc,QAAQ,CAAC;AAC9E,YAAM,wBAAoB,wDAAyC,gBAAgB,IAAI;AACvF,wBAAkB,oBAAoB,iBAAiB;AAAA,IACzD,OAAO;AACL,YAAM,gBAAgB,YAAY,OAAO,aAAa,WAAW,WAAW,SAAS;AACrF,oBAAc,MAAM,MAAM,qBAAqB,UAAU,gBAAgB,eAAe,mBAAmB,KAAK;AAAA,IAClH;AAAA,EACF;AAEA,aAAO,yCAAqB,OAAO;AAAA,IACjC;AAAA,IACA,aAAa;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/lib/matchers/toMatchAriaSnapshot.js

@@ -0,0 +1,159 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var toMatchAriaSnapshot_exports = {};
+__export(toMatchAriaSnapshot_exports, {
+  toMatchAriaSnapshot: () => toMatchAriaSnapshot
+});
+module.exports = __toCommonJS(toMatchAriaSnapshot_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_utils = require("playwright-core/lib/utils");
+var import_matcherHint = require("./matcherHint");
+var import_util = require("../util");
+var import_expect = require("./expect");
+var import_globals = require("../common/globals");
+async function toMatchAriaSnapshot(locator, expectedParam, options = {}) {
+  const matcherName = "toMatchAriaSnapshot";
+  const testInfo = (0, import_globals.currentTestInfo)();
+  if (!testInfo)
+    throw new Error(`toMatchAriaSnapshot() must be called during the test`);
+  if (testInfo._projectInternal.ignoreSnapshots)
+    return { pass: !this.isNot, message: () => "", name: "toMatchAriaSnapshot", expected: "" };
+  const updateSnapshots = testInfo.config.updateSnapshots;
+  let expected;
+  let timeout;
+  let expectedPath;
+  if ((0, import_utils.isString)(expectedParam)) {
+    expected = expectedParam;
+    timeout = options.timeout ?? this.timeout;
+  } else {
+    const legacyPath = testInfo._resolveSnapshotPaths("aria", expectedParam?.name, "dontUpdateSnapshotIndex", ".yml").absoluteSnapshotPath;
+    expectedPath = testInfo._resolveSnapshotPaths("aria", expectedParam?.name, "updateSnapshotIndex").absoluteSnapshotPath;
+    if (!await (0, import_util.fileExistsAsync)(expectedPath) && await (0, import_util.fileExistsAsync)(legacyPath))
+      expectedPath = legacyPath;
+    expected = await import_fs.default.promises.readFile(expectedPath, "utf8").catch(() => "");
+    timeout = expectedParam?.timeout ?? this.timeout;
+  }
+  const generateMissingBaseline = updateSnapshots === "missing" && !expected;
+  if (generateMissingBaseline) {
+    if (this.isNot) {
+      const message2 = `Matchers using ".not" can't generate new baselines`;
+      return { pass: this.isNot, message: () => message2, name: "toMatchAriaSnapshot" };
+    } else {
+      expected = `- none "Generating new baseline"`;
+    }
+  }
+  expected = unshift(expected);
+  const { matches: pass, received, log, timedOut, errorMessage } = await locator._expect("to.match.aria", { expectedValue: expected, isNot: this.isNot, timeout });
+  const typedReceived = received;
+  const message = () => {
+    let printedExpected;
+    let printedReceived;
+    let printedDiff;
+    if (errorMessage) {
+      printedExpected = `Expected: ${this.isNot ? "not " : ""}${this.utils.printExpected(expected)}`;
+    } else if (pass) {
+      const receivedString = (0, import_expect.printReceivedStringContainExpectedSubstring)(typedReceived.raw, typedReceived.raw.indexOf(expected), expected.length);
+      printedExpected = `Expected: not ${this.utils.printExpected(expected)}`;
+      printedReceived = `Received: ${receivedString}`;
+    } else {
+      printedDiff = this.utils.printDiffOrStringify(expected, typedReceived.raw, "Expected", "Received", false);
+    }
+    return (0, import_matcherHint.formatMatcherMessage)(this, {
+      matcherName,
+      expectation: "expected",
+      locator,
+      timeout,
+      timedOut,
+      printedExpected,
+      printedReceived,
+      printedDiff,
+      errorMessage,
+      log
+    });
+  };
+  if (errorMessage)
+    return { pass: this.isNot, message, name: "toMatchAriaSnapshot", expected };
+  if (!this.isNot) {
+    if (updateSnapshots === "all" || updateSnapshots === "changed" && pass === this.isNot || generateMissingBaseline) {
+      if (expectedPath) {
+        await import_fs.default.promises.mkdir(import_path.default.dirname(expectedPath), { recursive: true });
+        await import_fs.default.promises.writeFile(expectedPath, typedReceived.regex, "utf8");
+        const relativePath = import_path.default.relative(process.cwd(), expectedPath);
+        if (updateSnapshots === "missing") {
+          const message2 = `A snapshot doesn't exist at ${relativePath}, writing actual.`;
+          testInfo._hasNonRetriableError = true;
+          testInfo._failWithError(new Error(message2));
+        } else {
+          const message2 = `A snapshot is generated at ${relativePath}.`;
+          console.log(message2);
+        }
+        return { pass: true, message: () => "", name: "toMatchAriaSnapshot" };
+      } else {
+        const suggestedRebaseline = `\`
+${(0, import_utils.escapeTemplateString)(indent(typedReceived.regex, "{indent}  "))}
+{indent}\``;
+        if (updateSnapshots === "missing") {
+          const message2 = "A snapshot is not provided, generating new baseline.";
+          testInfo._hasNonRetriableError = true;
+          testInfo._failWithError(new Error(message2));
+        }
+        return { pass: false, message: () => "", name: "toMatchAriaSnapshot", suggestedRebaseline };
+      }
+    }
+  }
+  return {
+    name: matcherName,
+    expected,
+    message,
+    pass,
+    actual: received,
+    log,
+    timeout: timedOut ? timeout : void 0
+  };
+}
+function unshift(snapshot) {
+  const lines = snapshot.split("\n");
+  let whitespacePrefixLength = 100;
+  for (const line of lines) {
+    if (!line.trim())
+      continue;
+    const match = line.match(/^(\s*)/);
+    if (match && match[1].length < whitespacePrefixLength)
+      whitespacePrefixLength = match[1].length;
+  }
+  return lines.filter((t) => t.trim()).map((line) => line.substring(whitespacePrefixLength)).join("\n");
+}
+function indent(snapshot, indent2) {
+  return snapshot.split("\n").map((line) => indent2 + line).join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  toMatchAriaSnapshot
+});

package/lib/matchers/toMatchAriaSnapshot.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/matchers/toMatchAriaSnapshot.ts"],
+  "sourcesContent": ["/**\n * Copyright Microsoft Corporation. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n\nimport fs from 'fs';\nimport path from 'path';\n\nimport { escapeTemplateString, isString } from 'playwright-core/lib/utils';\n\nimport { formatMatcherMessage } from './matcherHint';\nimport { fileExistsAsync } from '../util';\nimport { printReceivedStringContainExpectedSubstring } from './expect';\nimport { currentTestInfo } from '../common/globals';\n\nimport type { MatcherResult } from './matcherHint';\nimport type { LocatorEx } from './matchers';\nimport type { ExpectMatcherState } from '../../types/test';\nimport type { MatcherReceived } from '@injected/ariaSnapshot';\n\n\ntype ToMatchAriaSnapshotExpected = {\n  name?: string;\n  path?: string;\n  timeout?: number;\n} | string;\n\nexport async function toMatchAriaSnapshot(\n  this: ExpectMatcherState,\n  locator: LocatorEx,\n  expectedParam?: ToMatchAriaSnapshotExpected,\n  options: { timeout?: number } = {},\n): Promise<MatcherResult<string | RegExp, string>> {\n  const matcherName = 'toMatchAriaSnapshot';\n\n  const testInfo = currentTestInfo();\n  if (!testInfo)\n    throw new Error(`toMatchAriaSnapshot() must be called during the test`);\n\n  if (testInfo._projectInternal.ignoreSnapshots)\n    return { pass: !this.isNot, message: () => '', name: 'toMatchAriaSnapshot', expected: '' };\n\n  const updateSnapshots = testInfo.config.updateSnapshots;\n\n  let expected: string;\n  let timeout: number;\n  let expectedPath: string | undefined;\n  if (isString(expectedParam)) {\n    expected = expectedParam;\n    timeout = options.timeout ?? this.timeout;\n  } else {\n    const legacyPath = testInfo._resolveSnapshotPaths('aria', expectedParam?.name, 'dontUpdateSnapshotIndex', '.yml').absoluteSnapshotPath;\n    expectedPath = testInfo._resolveSnapshotPaths('aria', expectedParam?.name, 'updateSnapshotIndex').absoluteSnapshotPath;\n    // in 1.51, we changed the default template to use .aria.yml extension\n    // for backwards compatibility, we check for the legacy .yml extension\n    if (!(await fileExistsAsync(expectedPath)) && await fileExistsAsync(legacyPath))\n      expectedPath = legacyPath;\n    expected = await fs.promises.readFile(expectedPath, 'utf8').catch(() => '');\n    timeout = expectedParam?.timeout ?? this.timeout;\n  }\n\n  const generateMissingBaseline = updateSnapshots === 'missing' && !expected;\n  if (generateMissingBaseline) {\n    if (this.isNot) {\n      const message = `Matchers using \".not\" can't generate new baselines`;\n      return { pass: this.isNot, message: () => message, name: 'toMatchAriaSnapshot' };\n    } else {\n      // When generating new baseline, run entire pipeline against impossible match.\n      expected = `- none \"Generating new baseline\"`;\n    }\n  }\n\n  expected = unshift(expected);\n  const { matches: pass, received, log, timedOut, errorMessage } = await locator._expect('to.match.aria', { expectedValue: expected, isNot: this.isNot, timeout });\n  const typedReceived = received as MatcherReceived;\n\n  const message = () => {\n    let printedExpected: string | undefined;\n    let printedReceived: string | undefined;\n    let printedDiff: string | undefined;\n    if (errorMessage) {\n      printedExpected = `Expected: ${this.isNot ? 'not ' : ''}${this.utils.printExpected(expected)}`;\n    } else if (pass) {\n      const receivedString = printReceivedStringContainExpectedSubstring(typedReceived.raw, typedReceived.raw.indexOf(expected), expected.length);\n      printedExpected = `Expected: not ${this.utils.printExpected(expected)}`;\n      printedReceived = `Received: ${receivedString}`;\n    } else {\n      printedDiff = this.utils.printDiffOrStringify(expected, typedReceived.raw, 'Expected', 'Received', false);\n    }\n    return formatMatcherMessage(this, {\n      matcherName,\n      expectation: 'expected',\n      locator,\n      timeout,\n      timedOut,\n      printedExpected,\n      printedReceived,\n      printedDiff,\n      errorMessage,\n      log,\n    });\n  };\n\n  if (errorMessage)\n    return { pass: this.isNot, message, name: 'toMatchAriaSnapshot', expected };\n\n  if (!this.isNot) {\n    if ((updateSnapshots === 'all') ||\n        (updateSnapshots === 'changed' && pass === this.isNot) ||\n        generateMissingBaseline) {\n      if (expectedPath) {\n        await fs.promises.mkdir(path.dirname(expectedPath), { recursive: true });\n        await fs.promises.writeFile(expectedPath, typedReceived.regex, 'utf8');\n        const relativePath = path.relative(process.cwd(), expectedPath);\n        if (updateSnapshots === 'missing') {\n          const message = `A snapshot doesn't exist at ${relativePath}, writing actual.`;\n          testInfo._hasNonRetriableError = true;\n          testInfo._failWithError(new Error(message));\n        } else {\n          const message = `A snapshot is generated at ${relativePath}.`;\n          /* eslint-disable no-console */\n          console.log(message);\n        }\n        return { pass: true, message: () => '', name: 'toMatchAriaSnapshot' };\n      } else {\n        const suggestedRebaseline = `\\`\\n${escapeTemplateString(indent(typedReceived.regex, '{indent}  '))}\\n{indent}\\``;\n        if (updateSnapshots === 'missing') {\n          const message = 'A snapshot is not provided, generating new baseline.';\n          testInfo._hasNonRetriableError = true;\n          testInfo._failWithError(new Error(message));\n        }\n        // TODO: ideally, we should return \"pass: true\" here because this matcher passes\n        // when regenerating baselines. However, we can only access suggestedRebaseline in case\n        // of an error, so we fail here and workaround it in the expect implementation.\n        return { pass: false, message: () => '', name: 'toMatchAriaSnapshot', suggestedRebaseline };\n      }\n    }\n  }\n\n  return {\n    name: matcherName,\n    expected,\n    message,\n    pass,\n    actual: received,\n    log,\n    timeout: timedOut ? timeout : undefined,\n  };\n}\n\nfunction unshift(snapshot: string): string {\n  const lines = snapshot.split('\\n');\n  let whitespacePrefixLength = 100;\n  for (const line of lines) {\n    if (!line.trim())\n      continue;\n    const match = line.match(/^(\\s*)/);\n    if (match && match[1].length < whitespacePrefixLength)\n      whitespacePrefixLength = match[1].length;\n  }\n  return lines.filter(t => t.trim()).map(line => line.substring(whitespacePrefixLength)).join('\\n');\n}\n\nfunction indent(snapshot: string, indent: string): string {\n  return snapshot.split('\\n').map(line => indent + line).join('\\n');\n}\n"],
+  "mappings": "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",
+  "names": ["fs", "message", "path", "indent"]
+}

package/lib/matchers/toMatchSnapshot.js

@@ -0,0 +1,341 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var toMatchSnapshot_exports = {};
+__export(toMatchSnapshot_exports, {
+  toHaveScreenshot: () => toHaveScreenshot,
+  toHaveScreenshotStepTitle: () => toHaveScreenshotStepTitle,
+  toMatchSnapshot: () => toMatchSnapshot
+});
+module.exports = __toCommonJS(toMatchSnapshot_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_utils = require("playwright-core/lib/utils");
+var import_utils2 = require("playwright-core/lib/utils");
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_util = require("../util");
+var import_matcherHint = require("./matcherHint");
+var import_globals = require("../common/globals");
+const NonConfigProperties = [
+  "clip",
+  "fullPage",
+  "mask",
+  "maskColor",
+  "omitBackground",
+  "timeout"
+];
+class SnapshotHelper {
+  constructor(testInfo, matcherName, locator, anonymousSnapshotExtension, configOptions, nameOrOptions, optOptions) {
+    let name;
+    if (Array.isArray(nameOrOptions) || typeof nameOrOptions === "string") {
+      name = nameOrOptions;
+      this.options = { ...optOptions };
+    } else {
+      const { name: nameFromOptions, ...options } = nameOrOptions;
+      this.options = options;
+      name = nameFromOptions;
+    }
+    this.name = Array.isArray(name) ? name.join(import_path.default.sep) : name || "";
+    const resolvedPaths = testInfo._resolveSnapshotPaths(matcherName === "toHaveScreenshot" ? "screenshot" : "snapshot", name, "updateSnapshotIndex", anonymousSnapshotExtension);
+    this.expectedPath = resolvedPaths.absoluteSnapshotPath;
+    this.attachmentBaseName = resolvedPaths.relativeOutputPath;
+    const outputBasePath = testInfo._getOutputPath(resolvedPaths.relativeOutputPath);
+    this.legacyExpectedPath = (0, import_util.addSuffixToFilePath)(outputBasePath, "-expected");
+    this.previousPath = (0, import_util.addSuffixToFilePath)(outputBasePath, "-previous");
+    this.actualPath = (0, import_util.addSuffixToFilePath)(outputBasePath, "-actual");
+    this.diffPath = (0, import_util.addSuffixToFilePath)(outputBasePath, "-diff");
+    const filteredConfigOptions = { ...configOptions };
+    for (const prop of NonConfigProperties)
+      delete filteredConfigOptions[prop];
+    this.options = {
+      ...filteredConfigOptions,
+      ...this.options
+    };
+    if (this.options._comparator) {
+      this.options.comparator = this.options._comparator;
+      delete this.options._comparator;
+    }
+    if (this.options.maxDiffPixels !== void 0 && this.options.maxDiffPixels < 0)
+      throw new Error("`maxDiffPixels` option value must be non-negative integer");
+    if (this.options.maxDiffPixelRatio !== void 0 && (this.options.maxDiffPixelRatio < 0 || this.options.maxDiffPixelRatio > 1))
+      throw new Error("`maxDiffPixelRatio` option value must be between 0 and 1");
+    this.matcherName = matcherName;
+    this.locator = locator;
+    this.updateSnapshots = testInfo.config.updateSnapshots;
+    this.mimeType = import_utilsBundle.mime.getType(import_path.default.basename(this.expectedPath)) ?? "application/octet-stream";
+    this.comparator = (0, import_utils.getComparator)(this.mimeType);
+    this.testInfo = testInfo;
+    this.kind = this.mimeType.startsWith("image/") ? "Screenshot" : "Snapshot";
+  }
+  createMatcherResult(message, pass, log) {
+    const unfiltered = {
+      name: this.matcherName,
+      expected: this.expectedPath,
+      actual: this.actualPath,
+      diff: this.diffPath,
+      pass,
+      message: () => message,
+      log
+    };
+    return Object.fromEntries(Object.entries(unfiltered).filter(([_, v]) => v !== void 0));
+  }
+  handleMissingNegated() {
+    const isWriteMissingMode = this.updateSnapshots !== "none";
+    const message = `A snapshot doesn't exist at ${this.expectedPath}${isWriteMissingMode ? `, matchers using ".not" won't write them automatically.` : "."}`;
+    return this.createMatcherResult(message, true);
+  }
+  handleDifferentNegated() {
+    return this.createMatcherResult("", false);
+  }
+  handleMatchingNegated() {
+    const message = [
+      import_utils2.colors.red(`${this.kind} comparison failed:`),
+      "",
+      indent("Expected result should be different from the actual one.", "  ")
+    ].join("\n");
+    return this.createMatcherResult(message, true);
+  }
+  handleMissing(actual, step) {
+    const isWriteMissingMode = this.updateSnapshots !== "none";
+    if (isWriteMissingMode)
+      writeFileSync(this.expectedPath, actual);
+    step?._attachToStep({ name: (0, import_util.addSuffixToFilePath)(this.attachmentBaseName, "-expected"), contentType: this.mimeType, path: this.expectedPath });
+    writeFileSync(this.actualPath, actual);
+    step?._attachToStep({ name: (0, import_util.addSuffixToFilePath)(this.attachmentBaseName, "-actual"), contentType: this.mimeType, path: this.actualPath });
+    const message = `A snapshot doesn't exist at ${this.expectedPath}${isWriteMissingMode ? ", writing actual." : "."}`;
+    if (this.updateSnapshots === "all" || this.updateSnapshots === "changed") {
+      console.log(message);
+      return this.createMatcherResult(message, true);
+    }
+    if (this.updateSnapshots === "missing") {
+      this.testInfo._hasNonRetriableError = true;
+      this.testInfo._failWithError(new Error(message));
+      return this.createMatcherResult("", true);
+    }
+    return this.createMatcherResult(message, false);
+  }
+  handleDifferent(actual, expected, previous, diff, header, diffError, log, step) {
+    const output = [`${header}${indent(diffError, "  ")}`];
+    if (this.name) {
+      output.push("");
+      output.push(`  Snapshot: ${this.name}`);
+    }
+    if (expected !== void 0) {
+      writeFileSync(this.legacyExpectedPath, expected);
+      step?._attachToStep({ name: (0, import_util.addSuffixToFilePath)(this.attachmentBaseName, "-expected"), contentType: this.mimeType, path: this.expectedPath });
+    }
+    if (previous !== void 0) {
+      writeFileSync(this.previousPath, previous);
+      step?._attachToStep({ name: (0, import_util.addSuffixToFilePath)(this.attachmentBaseName, "-previous"), contentType: this.mimeType, path: this.previousPath });
+    }
+    if (actual !== void 0) {
+      writeFileSync(this.actualPath, actual);
+      step?._attachToStep({ name: (0, import_util.addSuffixToFilePath)(this.attachmentBaseName, "-actual"), contentType: this.mimeType, path: this.actualPath });
+    }
+    if (diff !== void 0) {
+      writeFileSync(this.diffPath, diff);
+      step?._attachToStep({ name: (0, import_util.addSuffixToFilePath)(this.attachmentBaseName, "-diff"), contentType: this.mimeType, path: this.diffPath });
+    }
+    if (log?.length)
+      output.push((0, import_matcherHint.callLogText)(log));
+    else
+      output.push("");
+    return this.createMatcherResult(output.join("\n"), false, log);
+  }
+  handleMatching() {
+    return this.createMatcherResult("", true);
+  }
+}
+function toMatchSnapshot(received, nameOrOptions = {}, optOptions = {}) {
+  const testInfo = (0, import_globals.currentTestInfo)();
+  if (!testInfo)
+    throw new Error(`toMatchSnapshot() must be called during the test`);
+  if (received instanceof Promise)
+    throw new Error("An unresolved Promise was passed to toMatchSnapshot(), make sure to resolve it by adding await to it.");
+  if (testInfo._projectInternal.ignoreSnapshots)
+    return { pass: !this.isNot, message: () => "", name: "toMatchSnapshot", expected: nameOrOptions };
+  const configOptions = testInfo._projectInternal.expect?.toMatchSnapshot || {};
+  const helper = new SnapshotHelper(
+    testInfo,
+    "toMatchSnapshot",
+    void 0,
+    "." + determineFileExtension(received),
+    configOptions,
+    nameOrOptions,
+    optOptions
+  );
+  if (this.isNot) {
+    if (!import_fs.default.existsSync(helper.expectedPath))
+      return helper.handleMissingNegated();
+    const isDifferent = !!helper.comparator(received, import_fs.default.readFileSync(helper.expectedPath), helper.options);
+    return isDifferent ? helper.handleDifferentNegated() : helper.handleMatchingNegated();
+  }
+  if (!import_fs.default.existsSync(helper.expectedPath))
+    return helper.handleMissing(received, this._stepInfo);
+  const expected = import_fs.default.readFileSync(helper.expectedPath);
+  if (helper.updateSnapshots === "all") {
+    if (!(0, import_utils.compareBuffersOrStrings)(received, expected))
+      return helper.handleMatching();
+    writeFileSync(helper.expectedPath, received);
+    console.log(helper.expectedPath + " is not the same, writing actual.");
+    return helper.createMatcherResult(helper.expectedPath + " running with --update-snapshots, writing actual.", true);
+  }
+  if (helper.updateSnapshots === "changed") {
+    const result2 = helper.comparator(received, expected, helper.options);
+    if (!result2)
+      return helper.handleMatching();
+    writeFileSync(helper.expectedPath, received);
+    console.log(helper.expectedPath + " does not match, writing actual.");
+    return helper.createMatcherResult(helper.expectedPath + " running with --update-snapshots, writing actual.", true);
+  }
+  const result = helper.comparator(received, expected, helper.options);
+  if (!result)
+    return helper.handleMatching();
+  const header = (0, import_matcherHint.formatMatcherMessage)(this, { matcherName: "toMatchSnapshot", receiver: (0, import_utils.isString)(received) ? "string" : "Buffer", expectation: "expected" });
+  return helper.handleDifferent(received, expected, void 0, result.diff, header, result.errorMessage, void 0, this._stepInfo);
+}
+function toHaveScreenshotStepTitle(nameOrOptions = {}, optOptions = {}) {
+  let name;
+  if (typeof nameOrOptions === "object" && !Array.isArray(nameOrOptions))
+    name = nameOrOptions.name;
+  else
+    name = nameOrOptions;
+  return Array.isArray(name) ? name.join(import_path.default.sep) : name || "";
+}
+async function toHaveScreenshot(pageOrLocator, nameOrOptions = {}, optOptions = {}) {
+  const testInfo = (0, import_globals.currentTestInfo)();
+  if (!testInfo)
+    throw new Error(`toHaveScreenshot() must be called during the test`);
+  if (testInfo._projectInternal.ignoreSnapshots)
+    return { pass: !this.isNot, message: () => "", name: "toHaveScreenshot", expected: nameOrOptions };
+  (0, import_util.expectTypes)(pageOrLocator, ["Page", "Locator"], "toHaveScreenshot");
+  const [page, locator] = pageOrLocator.constructor.name === "Page" ? [pageOrLocator, void 0] : [pageOrLocator.page(), pageOrLocator];
+  const configOptions = testInfo._projectInternal.expect?.toHaveScreenshot || {};
+  const helper = new SnapshotHelper(testInfo, "toHaveScreenshot", locator, void 0, configOptions, nameOrOptions, optOptions);
+  if (!helper.expectedPath.toLowerCase().endsWith(".png"))
+    throw new Error(`Screenshot name "${import_path.default.basename(helper.expectedPath)}" must have '.png' extension`);
+  (0, import_util.expectTypes)(pageOrLocator, ["Page", "Locator"], "toHaveScreenshot");
+  const style = await loadScreenshotStyles(helper.options.stylePath);
+  const timeout = helper.options.timeout ?? this.timeout;
+  const expectScreenshotOptions = {
+    locator,
+    animations: helper.options.animations ?? "disabled",
+    caret: helper.options.caret ?? "hide",
+    clip: helper.options.clip,
+    fullPage: helper.options.fullPage,
+    mask: helper.options.mask,
+    maskColor: helper.options.maskColor,
+    omitBackground: helper.options.omitBackground,
+    scale: helper.options.scale ?? "css",
+    style,
+    isNot: !!this.isNot,
+    timeout,
+    comparator: helper.options.comparator,
+    maxDiffPixels: helper.options.maxDiffPixels,
+    maxDiffPixelRatio: helper.options.maxDiffPixelRatio,
+    threshold: helper.options.threshold
+  };
+  const hasSnapshot = import_fs.default.existsSync(helper.expectedPath);
+  if (this.isNot) {
+    if (!hasSnapshot)
+      return helper.handleMissingNegated();
+    expectScreenshotOptions.expected = await import_fs.default.promises.readFile(helper.expectedPath);
+    const isDifferent = !(await page._expectScreenshot(expectScreenshotOptions)).errorMessage;
+    return isDifferent ? helper.handleDifferentNegated() : helper.handleMatchingNegated();
+  }
+  if (helper.updateSnapshots === "none" && !hasSnapshot)
+    return helper.createMatcherResult(`A snapshot doesn't exist at ${helper.expectedPath}.`, false);
+  if (!hasSnapshot) {
+    const { actual: actual2, previous: previous2, diff: diff2, errorMessage: errorMessage2, log: log2, timedOut: timedOut2 } = await page._expectScreenshot(expectScreenshotOptions);
+    if (errorMessage2) {
+      const header2 = (0, import_matcherHint.formatMatcherMessage)(this, { matcherName: "toHaveScreenshot", locator, expectation: "expected", timeout, timedOut: timedOut2 });
+      return helper.handleDifferent(actual2, void 0, previous2, diff2, header2, errorMessage2, log2, this._stepInfo);
+    }
+    return helper.handleMissing(actual2, this._stepInfo);
+  }
+  const expected = await import_fs.default.promises.readFile(helper.expectedPath);
+  expectScreenshotOptions.expected = helper.updateSnapshots === "all" ? void 0 : expected;
+  const { actual, previous, diff, errorMessage, log, timedOut } = await page._expectScreenshot(expectScreenshotOptions);
+  const writeFiles = (actualBuffer) => {
+    writeFileSync(helper.expectedPath, actualBuffer);
+    writeFileSync(helper.actualPath, actualBuffer);
+    console.log(helper.expectedPath + " is re-generated, writing actual.");
+    return helper.createMatcherResult(helper.expectedPath + " running with --update-snapshots, writing actual.", true);
+  };
+  if (!errorMessage) {
+    if (helper.updateSnapshots === "all" && actual && (0, import_utils.compareBuffersOrStrings)(actual, expected)) {
+      console.log(helper.expectedPath + " is re-generated, writing actual.");
+      return writeFiles(actual);
+    }
+    return helper.handleMatching();
+  }
+  if (helper.updateSnapshots === "changed" || helper.updateSnapshots === "all") {
+    if (actual)
+      return writeFiles(actual);
+    let header2 = (0, import_matcherHint.formatMatcherMessage)(this, { matcherName: "toHaveScreenshot", locator, expectation: "expected", timeout, timedOut });
+    header2 += "  Failed to re-generate expected.\n";
+    return helper.handleDifferent(actual, expectScreenshotOptions.expected, previous, diff, header2, errorMessage, log, this._stepInfo);
+  }
+  const header = (0, import_matcherHint.formatMatcherMessage)(this, { matcherName: "toHaveScreenshot", locator, expectation: "expected", timeout, timedOut });
+  return helper.handleDifferent(actual, expectScreenshotOptions.expected, previous, diff, header, errorMessage, log, this._stepInfo);
+}
+function writeFileSync(aPath, content) {
+  import_fs.default.mkdirSync(import_path.default.dirname(aPath), { recursive: true });
+  import_fs.default.writeFileSync(aPath, content);
+}
+function indent(lines, tab) {
+  return lines.replace(/^(?=.+$)/gm, tab);
+}
+function determineFileExtension(file) {
+  if (typeof file === "string")
+    return "txt";
+  if (compareMagicBytes(file, [137, 80, 78, 71, 13, 10, 26, 10]))
+    return "png";
+  if (compareMagicBytes(file, [255, 216, 255]))
+    return "jpg";
+  return "dat";
+}
+function compareMagicBytes(file, magicBytes) {
+  return Buffer.compare(Buffer.from(magicBytes), file.slice(0, magicBytes.length)) === 0;
+}
+async function loadScreenshotStyles(stylePath) {
+  if (!stylePath)
+    return;
+  const stylePaths = Array.isArray(stylePath) ? stylePath : [stylePath];
+  const styles = await Promise.all(stylePaths.map(async (stylePath2) => {
+    const text = await import_fs.default.promises.readFile(stylePath2, "utf8");
+    return text.trim();
+  }));
+  return styles.join("\n").trim() || void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  toHaveScreenshot,
+  toHaveScreenshotStepTitle,
+  toMatchSnapshot
+});