From 0990095aed863ce5edfb55417ab9e5cabe1296d0 Mon Sep 17 00:00:00 2001
From: Rich Harris <rich.harris@vercel.com>
Date: Fri, 5 Dec 2025 14:59:46 -0800
Subject: [PATCH] fix: don't issue a11y warning for video without captions if
 it has no `src` (#17311)

---
 .changeset/dark-buckets-hang.md                       |  5 +++++
 .../phases/2-analyze/visitors/shared/a11y/index.js    |  8 ++++++++
 .../samples/a11y-media-has-caption/input.svelte       | 11 ++++++-----
 .../samples/a11y-media-has-caption/warnings.json      |  6 +++---
 4 files changed, 22 insertions(+), 8 deletions(-)
 create mode 100644 .changeset/dark-buckets-hang.md

diff --git a/.changeset/dark-buckets-hang.md b/.changeset/dark-buckets-hang.md
new file mode 100644
index 0000000000..92ee103e3d
--- /dev/null
+++ b/.changeset/dark-buckets-hang.md
@@ -0,0 +1,5 @@
+---
+'svelte': patch
+---
+
+fix: don't issue a11y warning for `<video>` without captions if it has no `src`
diff --git a/packages/svelte/src/compiler/phases/2-analyze/visitors/shared/a11y/index.js b/packages/svelte/src/compiler/phases/2-analyze/visitors/shared/a11y/index.js
index 8c5bf55e5f..717ee4bf50 100644
--- a/packages/svelte/src/compiler/phases/2-analyze/visitors/shared/a11y/index.js
+++ b/packages/svelte/src/compiler/phases/2-analyze/visitors/shared/a11y/index.js
@@ -486,9 +486,17 @@ export function check_element(node, context) {
 		case 'video': {
 			const aria_hidden_attribute = attribute_map.get('aria-hidden');
 			const aria_hidden_exist = aria_hidden_attribute && get_static_value(aria_hidden_attribute);
+
 			if (attribute_map.has('muted') || aria_hidden_exist === 'true' || has_spread) {
 				return;
 			}
+
+			if (!attribute_map.has('src')) {
+				// don't warn about missing captions if `<video>` has no `src` —
+				// could e.g. be playing a MediaStream
+				return;
+			}
+
 			let has_caption = false;
 			const track = /** @type {AST.RegularElement | undefined} */ (
 				node.fragment.nodes.find((i) => i.type === 'RegularElement' && i.name === 'track')
diff --git a/packages/svelte/tests/validator/samples/a11y-media-has-caption/input.svelte b/packages/svelte/tests/validator/samples/a11y-media-has-caption/input.svelte
index 2e479d97da..9d83ca8771 100644
--- a/packages/svelte/tests/validator/samples/a11y-media-has-caption/input.svelte
+++ b/packages/svelte/tests/validator/samples/a11y-media-has-caption/input.svelte
@@ -1,6 +1,7 @@
-<video><track kind="captions"/></video>
-<video></video>
-<video><track /></video>
+<video src="x"><track kind="captions"/></video>
+<video src="x"></video>
+<video src="x"><track /></video>
 <audio></audio>
-<video aria-hidden="true"></video>
-<video aria-hidden="false"></video>
+<video src="x" aria-hidden="true"></video>
+<video src="x" aria-hidden="false"></video>
+<video></video> <!-- no src -->
diff --git a/packages/svelte/tests/validator/samples/a11y-media-has-caption/warnings.json b/packages/svelte/tests/validator/samples/a11y-media-has-caption/warnings.json
index 2a7de1f730..c596f23806 100644
--- a/packages/svelte/tests/validator/samples/a11y-media-has-caption/warnings.json
+++ b/packages/svelte/tests/validator/samples/a11y-media-has-caption/warnings.json
@@ -2,7 +2,7 @@
 	{
 		"code": "a11y_media_has_caption",
 		"end": {
-			"column": 15,
+			"column": 23,
 			"line": 2
 		},
 		"message": "`<video>` elements must have a `<track kind=\"captions\">`",
@@ -14,7 +14,7 @@
 	{
 		"code": "a11y_media_has_caption",
 		"end": {
-			"column": 24,
+			"column": 32,
 			"line": 3
 		},
 		"message": "`<video>` elements must have a `<track kind=\"captions\">`",
@@ -26,7 +26,7 @@
 	{
 		"code": "a11y_media_has_caption",
 		"end": {
-			"column": 35,
+			"column": 43,
 			"line": 6
 		},
 		"message": "`<video>` elements must have a `<track kind=\"captions\">`",