react-doctor/media-has-caption

Add a `<track kind="captions">` child to every `<audio>` / `<video>`.

• Category: Accessibility
• Severity: warn
• Source: oxlint-plugin-react-doctor
• Framework: global
• Enabled when: always
• Documentation: https://oxc.rs/docs/guide/usage/linter/rules/jsx_a11y/media-has-caption

Validation prompt

Use this to decide whether a fired diagnostic is real or a false positive.

Fires on any <audio> or <video> element (plus names mapped to them via the jsx-a11y audio/video/components settings) that lacks a direct child <track> whose kind is a static string literal equal to "captions" (case-insensitive); a kind="subtitles" track, a bare <track>, or a media element with no children all still fire. Statically truthy muted — bare muted, muted={true}, or muted="true" — suppresses it, but muted={false} does not. False positive: a <track kind={captionsKind} /> whose kind comes from a variable or any non-literal expression is invisible to the static check and reported even when it resolves to "captions" at runtime.

Fix prompt

Use this once validation confirms the diagnostic is real.

Add a captions track as a direct child of the media element: <video><track kind="captions" src="captions.vtt" srcLang="en" label="English" /></video>. The kind must be a literal string "captions" (subtitles do not satisfy the rule); if the value must be dynamic, the static check can't verify it, so keep a literal kind="captions" or guard with a justified eslint-disable on that line. For media that is genuinely silent, mark it muted to opt out. See https://oxc.rs/docs/guide/usage/linter/rules/jsx_a11y/media-has-caption