From c119be016295b45a005e2a36367ea7d133b4f385 Mon Sep 17 00:00:00 2001
From: Vladimir <sleuths.slews0s@icloud.com>
Date: Wed, 9 Sep 2026 13:37:09 +0200
Subject: [PATCH] fix(expect): correct return value in `toMatchAriaSnapshot`
 (#11208)

---
 packages/browser/jest-dom.d.ts     |  4 ++--
 test/browser/test/expect.test-d.ts | 13 +++++++++++++
 2 files changed, 15 insertions(+), 2 deletions(-)
 create mode 100644 test/browser/test/expect.test-d.ts

diff --git a/packages/browser/jest-dom.d.ts b/packages/browser/jest-dom.d.ts
index 24d1751a7..5a2826469 100644
--- a/packages/browser/jest-dom.d.ts
+++ b/packages/browser/jest-dom.d.ts
@@ -771,7 +771,7 @@ export interface TestingLibraryMatchers<R extends void | Promise<void>, T = unkn
    * @see https://vitest.dev/guide/browser/aria-snapshots
    * @see https://vitest.dev/api/expect#tomatchariasnapshot
    */
-  toMatchAriaSnapshot: () => void
+  toMatchAriaSnapshot: () => R
   /**
    * @experimental
    * @description
@@ -802,5 +802,5 @@ export interface TestingLibraryMatchers<R extends void | Promise<void>, T = unkn
    * @see https://vitest.dev/guide/browser/aria-snapshots
    * @see https://vitest.dev/api/expect#tomatchariaInlinesnapshot
    */
-  toMatchAriaInlineSnapshot: (inlineSnapshot?: string) => void
+  toMatchAriaInlineSnapshot: (inlineSnapshot?: string) => R
 }
diff --git a/test/browser/test/expect.test-d.ts b/test/browser/test/expect.test-d.ts
new file mode 100644
index 000000000..0e1a93128
--- /dev/null
+++ b/test/browser/test/expect.test-d.ts
@@ -0,0 +1,13 @@
+import { expect, expectTypeOf, test } from 'vitest'
+import { page } from 'vitest/browser'
+
+test('aria snapshot matchers return the assertion result', () => {
+  expectTypeOf(expect(document.body).toMatchAriaSnapshot()).toEqualTypeOf<void>()
+  expectTypeOf(expect(document.body).toMatchAriaInlineSnapshot('- heading')).toEqualTypeOf<void>()
+
+  expectTypeOf(expect.element(page.getByRole('main')).toMatchAriaSnapshot()).toEqualTypeOf<Promise<void>>()
+  expectTypeOf(expect.element(page.getByRole('main')).toMatchAriaInlineSnapshot('- heading')).toEqualTypeOf<Promise<void>>()
+
+  expectTypeOf(expect.poll(() => document.body).toMatchAriaSnapshot()).toEqualTypeOf<Promise<void>>()
+  expectTypeOf(expect.poll(() => document.body).toMatchAriaInlineSnapshot('- heading')).toEqualTypeOf<Promise<void>>()
+})
-- 
2.51.2