playwright 1.55.0-alpha-2025-07-16 → 1.55.0-alpha-2025-07-17

package/lib/matchers/matcherHint.js

@@ -25,14 +25,18 @@ __export(matcherHint_exports, {
 });
 module.exports = __toCommonJS(matcherHint_exports);
 var import_utils = require("playwright-core/lib/utils");
-var import_utils2 = require("playwright-core/lib/utils");
 const kNoElementsFoundError = "<element(s) not found>";
-function matcherHint(state, locator, matcherName, expression, actual, matcherOptions, timeout) {
-  let header = state.utils.matcherHint(matcherName, expression, actual, matcherOptions).replace(/ \/\/ deep equality/, "") + "\n\n";
-  if (timeout)
-    header = import_utils2.colors.red(`Timed out ${timeout}ms waiting for `) + header;
+function matcherHint(state, locator, matcherName, expression, actual, matcherOptions, timeout, expectedReceivedString, preventExtraStatIndent = false) {
+  let header = state.utils.matcherHint(matcherName, expression, actual, matcherOptions).replace(/ \/\/ deep equality/, "") + " failed\n\n";
+  const extraSpace = preventExtraStatIndent ? "" : " ";
   if (locator)
-    header += `Locator: ${String(locator)}
+    header += `Locator: ${extraSpace}${String(locator)}
+`;
+  if (expectedReceivedString)
+    header += `${expectedReceivedString}
+`;
+  if (timeout)
+    header += `Timeout: ${extraSpace}${timeout}ms
 `;
   return header;
 }

package/lib/matchers/matchers.js

@@ -189,7 +189,7 @@ function toHaveClass(locator, expected, options) {
     return import_toEqual.toEqual.call(this, "toHaveClass", locator, "Locator", async (isNot, timeout) => {
       const expectedText = (0, import_utils.serializeExpectedTextValues)(expected);
       return await locator._expect("to.have.class.array", { expectedText, isNot, timeout });
-    }, expected, options);
+    }, expected, options, true);
   } else {
     return import_toMatchText.toMatchText.call(this, "toHaveClass", locator, "Locator", async (isNot, timeout) => {
       const expectedText = (0, import_utils.serializeExpectedTextValues)([expected]);
@@ -204,7 +204,7 @@ function toContainClass(locator, expected, options) {
     return import_toEqual.toEqual.call(this, "toContainClass", locator, "Locator", async (isNot, timeout) => {
       const expectedText = (0, import_utils.serializeExpectedTextValues)(expected);
       return await locator._expect("to.contain.class.array", { expectedText, isNot, timeout });
-    }, expected, options);
+    }, expected, options, true);
   } else {
     if ((0, import_utils.isRegExp)(expected))
       throw new Error(`"expected" argument in toContainClass cannot be a RegExp value`);

package/lib/matchers/toBeTruthy.js

@@ -50,10 +50,10 @@ async function toBeTruthy(matcherName, receiver, receiverType, expected, arg, qu
     printedReceived = `Received: ${notFound ? import_matcherHint.kNoElementsFoundError : received}`;
   }
   const message = () => {
-    const header = (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", arg, matcherOptions, timedOut ? timeout : void 0);
+    const header = (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", arg, matcherOptions, timedOut ? timeout : void 0, `${printedExpected}
+${printedReceived}`);
     const logText = (0, import_util.callLogText)(log);
-    return `${header}${printedExpected}
-${printedReceived}${logText}`;
+    return `${header}${logText}`;
   };
   return {
     message,

package/lib/matchers/toEqual.js

@@ -26,7 +26,7 @@ var import_util = require("../util");
 var import_matcherHint = require("./matcherHint");
 const EXPECTED_LABEL = "Expected";
 const RECEIVED_LABEL = "Received";
-async function toEqual(matcherName, receiver, receiverType, query, expected, options = {}) {
+async function toEqual(matcherName, receiver, receiverType, query, expected, options = {}, messagePreventExtraStatIndent) {
   (0, import_util.expectTypes)(receiver, [receiverType], matcherName);
   const matcherOptions = {
     comment: options.contains ? "" : "deep equality",
@@ -73,10 +73,10 @@ async function toEqual(matcherName, receiver, receiverType, query, expected, opt
     );
   }
   const message = () => {
-    const header = (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", void 0, matcherOptions, timedOut ? timeout : void 0);
     const details = printedDiff || `${printedExpected}
 ${printedReceived}`;
-    return `${header}${details}${(0, import_util.callLogText)(log)}`;
+    const header = (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", void 0, matcherOptions, timedOut ? timeout : void 0, details, messagePreventExtraStatIndent);
+    return `${header}${(0, import_util.callLogText)(log)}`;
   };
   return {
     actual: received,

package/lib/matchers/toHaveURL.js

@@ -37,7 +37,7 @@ async function toHaveURLWithPredicate(page, expected, options) {
     throw new Error(
       [
         // Always display `expected` in expectation place
-        (0, import_matcherHint.matcherHint)(this, void 0, matcherName, expression, void 0, matcherOptions),
+        (0, import_matcherHint.matcherHint)(this, void 0, matcherName, expression, void 0, matcherOptions, void 0, void 0, true),
         `${import_utils2.colors.bold("Matcher error")}: ${(0, import_expectBundle.EXPECTED_COLOR)("expected")} value must be a string, regular expression, or predicate`,
         this.utils.printWithType("Expected", expected, this.utils.printExpected)
       ].join("\n\n")
@@ -91,7 +91,7 @@ function toHaveURLMessage(state, matcherName, expression, expected, received, pa
     promise: state.promise
   };
   const receivedString = received || "";
-  const messagePrefix = (0, import_matcherHint.matcherHint)(state, void 0, matcherName, expression, void 0, matcherOptions, didTimeout ? timeout : void 0);
+  const messagePrefix = (0, import_matcherHint.matcherHint)(state, void 0, matcherName, expression, void 0, matcherOptions, didTimeout ? timeout : void 0, void 0, true);
   let printedReceived;
   let printedExpected;
   let printedDiff;

package/lib/matchers/toMatchAriaSnapshot.js

@@ -77,13 +77,15 @@ async function toMatchAriaSnapshot(receiver, expectedParam, options = {}) {
   expected = unshift(expected);
   const { matches: pass, received, log, timedOut } = await receiver._expect("to.match.aria", { expectedValue: expected, isNot: this.isNot, timeout });
   const typedReceived = received;
-  const messagePrefix = (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", void 0, matcherOptions, timedOut ? timeout : void 0);
+  const matcherHintWithExpect = (expectedReceivedString) => {
+    return (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", void 0, matcherOptions, timedOut ? timeout : void 0, expectedReceivedString);
+  };
   const notFound = typedReceived === import_matcherHint.kNoElementsFoundError;
   if (notFound) {
     return {
       pass: this.isNot,
-      message: () => messagePrefix + `Expected: ${this.utils.printExpected(expected)}
-Received: ${(0, import_expectBundle.EXPECTED_COLOR)("<element not found>")}` + (0, import_util.callLogText)(log),
+      message: () => matcherHintWithExpect(`Expected: ${this.utils.printExpected(expected)}
+Received: ${(0, import_expectBundle.EXPECTED_COLOR)("<element not found>")}`) + (0, import_util.callLogText)(log),
       name: "toMatchAriaSnapshot",
       expected
     };
@@ -91,18 +93,15 @@ Received: ${(0, import_expectBundle.EXPECTED_COLOR)("<element not found>")}` + (
   const receivedText = typedReceived.raw;
   const message = () => {
     if (pass) {
-      if (notFound)
-        return messagePrefix + `Expected: not ${this.utils.printExpected(expected)}
-Received: ${receivedText}` + (0, import_util.callLogText)(log);
-      const printedReceived = (0, import_expect.printReceivedStringContainExpectedSubstring)(receivedText, receivedText.indexOf(expected), expected.length);
-      return messagePrefix + `Expected: not ${this.utils.printExpected(expected)}
-Received: ${printedReceived}` + (0, import_util.callLogText)(log);
+      const receivedString = notFound ? receivedText : (0, import_expect.printReceivedStringContainExpectedSubstring)(receivedText, receivedText.indexOf(expected), expected.length);
+      const expectedReceivedString = `Expected: not ${this.utils.printExpected(expected)}
+Received: ${receivedString}`;
+      return matcherHintWithExpect(expectedReceivedString) + (0, import_util.callLogText)(log);
     } else {
       const labelExpected = `Expected`;
-      if (notFound)
-        return messagePrefix + `${labelExpected}: ${this.utils.printExpected(expected)}
-Received: ${receivedText}` + (0, import_util.callLogText)(log);
-      return messagePrefix + this.utils.printDiffOrStringify(expected, receivedText, labelExpected, "Received", false) + (0, import_util.callLogText)(log);
+      const expectedReceivedString = notFound ? `${labelExpected}: ${this.utils.printExpected(expected)}
+Received: ${receivedText}` : this.utils.printDiffOrStringify(expected, receivedText, labelExpected, "Received", false);
+      return matcherHintWithExpect(expectedReceivedString) + (0, import_util.callLogText)(log);
     }
   };
   if (!this.isNot) {

package/lib/matchers/toMatchSnapshot.js

@@ -217,7 +217,7 @@ function toMatchSnapshot(received, nameOrOptions = {}, optOptions = {}) {
   if (!result)
     return helper.handleMatching();
   const receiver = (0, import_utils.isString)(received) ? "string" : "Buffer";
-  const header = (0, import_matcherHint.matcherHint)(this, void 0, "toMatchSnapshot", receiver, void 0, void 0);
+  const header = (0, import_matcherHint.matcherHint)(this, void 0, "toMatchSnapshot", receiver, void 0, void 0, void 0);
   return helper.handleDifferent(received, expected, void 0, result.diff, header, result.errorMessage, void 0, this._stepInfo);
 }
 function toHaveScreenshotStepTitle(nameOrOptions = {}, optOptions = {}) {

package/lib/matchers/toMatchText.js

@@ -34,7 +34,7 @@ async function toMatchText(matcherName, receiver, receiverType, query, expected,
   };
   if (!(typeof expected === "string") && !(expected && typeof expected.test === "function")) {
     throw new Error([
-      (0, import_matcherHint.matcherHint)(this, receiverType === "Locator" ? receiver : void 0, matcherName, options.receiverLabel ?? receiver, expected, matcherOptions),
+      (0, import_matcherHint.matcherHint)(this, receiverType === "Locator" ? receiver : void 0, matcherName, options.receiverLabel ?? receiver, expected, matcherOptions, void 0, void 0, true),
       `${import_utils.colors.bold("Matcher error")}: ${(0, import_expectBundle.EXPECTED_COLOR)("expected")} value must be a string or regular expression`,
       this.utils.printWithType("Expected", expected, this.utils.printExpected)
     ].join("\n\n"));
@@ -51,7 +51,6 @@ async function toMatchText(matcherName, receiver, receiverType, query, expected,
   }
   const stringSubstring = options.matchSubstring ? "substring" : "string";
   const receivedString = received || "";
-  const messagePrefix = (0, import_matcherHint.matcherHint)(this, receiverType === "Locator" ? receiver : void 0, matcherName, options.receiverLabel ?? "locator", void 0, matcherOptions, timedOut ? timeout : void 0);
   const notFound = received === import_matcherHint.kNoElementsFoundError;
   let printedReceived;
   let printedExpected;
@@ -87,7 +86,8 @@ async function toMatchText(matcherName, receiver, receiverType, query, expected,
   }
   const message = () => {
     const resultDetails = printedDiff ? printedDiff : printedExpected + "\n" + printedReceived;
-    return messagePrefix + resultDetails + (0, import_util.callLogText)(log);
+    const hints = (0, import_matcherHint.matcherHint)(this, receiverType === "Locator" ? receiver : void 0, matcherName, options.receiverLabel ?? "locator", void 0, matcherOptions, timedOut ? timeout : void 0, resultDetails, true);
+    return hints + (0, import_util.callLogText)(log);
   };
   return {
     name: matcherName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright",
-  "version": "1.55.0-alpha-2025-07-16",
+  "version": "1.55.0-alpha-2025-07-17",
   "description": "A high-level API to automate web browsers",
   "repository": {
     "type": "git",
@@ -56,7 +56,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "playwright-core": "1.55.0-alpha-2025-07-16"
+    "playwright-core": "1.55.0-alpha-2025-07-17"
   },
   "optionalDependencies": {
     "fsevents": "2.3.2"