feat(aria): extend toHaveAccessibleName() to accept an array of expected accessible names (#33277)

docs/src/api/class-locatorassertions.md

@@ -1236,7 +1236,7 @@ await Expect(locator).ToHaveAccessibleNameAsync("Save to disk");
 
 ### param: LocatorAssertions.toHaveAccessibleName.name
 * since: v1.44
-- `name` <[string]|[RegExp]>
+- `name` <[string]|[RegExp]|[Array]<[string]|[RegExp]>>
 
 Expected accessible name.
 

packages/playwright-core/src/server/injected/injectedScript.ts

@@ -1354,6 +1354,8 @@ export class InjectedScript {
       received = elements.map(e => options.useInnerText ? (e as HTMLElement).innerText : elementText(new Map(), e).full);
     else if (expression === 'to.have.class.array')
       received = elements.map(e => e.classList.toString());
+    else if (expression === 'to.have.accessible.name.array')
+      received = elements.map(e => getElementAccessibleName(e, false));
 
     if (received && options.expectedText) {
       // "To match an array" is "to contain an array" + "equal length"

packages/playwright/src/matchers/matchers.ts

@@ -189,13 +189,20 @@ export function toHaveAccessibleDescription(
 export function toHaveAccessibleName(
   this: ExpectMatcherState,
   locator: LocatorEx,
-  expected: string | RegExp,
+  expected: string | RegExp | (string | RegExp)[],
-  options?: { timeout?: number, ignoreCase?: boolean },
+  options: { timeout?: number, ignoreCase?: boolean, normalizeWhiteSpace?: boolean } = {}
 ) {
-  return toMatchText.call(this, 'toHaveAccessibleName', locator, 'Locator', async (isNot, timeout) => {
+  if (Array.isArray(expected)) {
-    const expectedText = serializeExpectedTextValues([expected], { ignoreCase: options?.ignoreCase, normalizeWhiteSpace: true });
+    return toEqual.call(this, 'toHaveAccessibleName', locator, 'Locator', async (isNot, timeout) => {
-    return await locator._expect('to.have.accessible.name', { expectedText, isNot, timeout });
+      const expectedText = serializeExpectedTextValues(expected, { ignoreCase: options?.ignoreCase, normalizeWhiteSpace: true });
-  }, expected, options);
+      return await locator._expect('to.have.accessible.name.array', { expectedText, isNot, timeout });
+    }, expected, options);
+  } else {
+    return toMatchText.call(this, 'toHaveAccessibleName', locator, 'Locator', async (isNot, timeout) => {
+      const expectedText = serializeExpectedTextValues([expected], { ignoreCase: options?.ignoreCase, normalizeWhiteSpace: true });
+      return await locator._expect('to.have.accessible.name', { expectedText, isNot, timeout });
+    }, expected, options);
+  }
 }
 
 export function toHaveAttribute(

packages/playwright/types/test.d.ts

@@ -7899,7 +7899,7 @@ interface LocatorAssertions {
    * @param name Expected accessible name.
    * @param options
    */
-  toHaveAccessibleName(name: string|RegExp, options?: {
+  toHaveAccessibleName(name: string|RegExp|ReadonlyArray<string|RegExp>, options?: {
     /**
      * Whether to perform case-insensitive match.
      * [`ignoreCase`](https://playwright.dev/docs/api/class-locatorassertions#locator-assertions-to-have-accessible-name-option-ignore-case)

tests/page/expect-misc.spec.ts

@@ -436,6 +436,43 @@ test('toHaveAccessibleName', async ({ page }) => {
   await expect(page.locator('button')).toHaveAccessibleName('foo bar baz');
 });
 
+test('toHaveAccessibleName should accept array of names for multiple elements', async ({ page }) => {
+  await page.setContent(`
+    <table>
+      <tr role="row">
+        <td role="cell">Cell A1</td>
+        <td role="cell">Cell B1</td>
+        <td role="cell">Cell C1</td>
+      </tr>
+      <tr role="row">
+        <td role="cell">Cell A2</td>
+        <td role="cell">Cell B2</td>
+        <td role="cell">Cell C2</td>
+      </tr>
+      <tr role="row">
+        <td role="cell">Cell A3</td>
+        <td role="cell">Cell B3</td>
+        <td role="cell">Cell C3</td>
+      </tr>
+    </table>
+  `);
+  await expect(page.getByRole('row')).toHaveAccessibleName([
+    'Cell A1 Cell B1 Cell C1',
+    'Cell A2 Cell B2 Cell C2',
+    'Cell A3 Cell B3 Cell C3',
+  ]);
+  await expect(page.getByRole('row')).toHaveAccessibleName(['cell a1 cell b1 cell C1',
+    'cell A2 Cell b2 Cell c2',
+    'Cell a3 Cell b3 cell C3',], { ignoreCase: true });
+
+  await expect(page.getByRole('row')).not.toHaveAccessibleName([
+    'Cel A4 Cell B4 Cell C4',
+    'Cell A5 Cell B5 Cell C5',
+    'Cell A6 Cell B6 Cell C6',
+  ]);
+});
+
+
 test('toHaveAccessibleDescription', async ({ page }) => {
   await page.setContent(`
     <div role="button" aria-description="Hello"></div>