jeeyyy commented 5 years ago

no-autoplay-audio

Description: This rule checks thatautoplayaudio does not last for more than 3 seconds, or it has a control mechanism
Help: <video> or <audio> elements does not autoplay audio

Matches

"selector": "audio[autoplay], video[autoplay]"
"excludeHidden": false, because some user agents hide media elements when controls attribute is missing.
exclude nodes that are either paused or muted.

Checks

Check 1:

name: no-autoplay-audio-below-allowed-duration
- impact: serious
- messages:
  - pass: <video> or <audio> does not output audio for more than allowed duration
  - fail: <video> or <audio> outputs audio for more than allowed duration
  - incomplete: Check that the <video> or <audio> does not output audio for more than allowed duration

Check 2:

name: no-autoplay-audio-has-controls
- impact: serious
- messages:
  - pass: <video> or <audio> has controls mechanism
  - fail: <video> or <audio> does not have controls mechanism
  - incomplete: Check that the <video> or <audio> has controls mechanism

ACT Rule Reference:

Video or audio has no auto-play audio

jeeyyy commented 5 years ago

Test Cases

Pass Examples

Uses the params t on an audio to specify start play time
```
<audio src="abc.mp3#t=25" autoplay="true"></audio>
```

Uses the params t on a video to specify start and end time

<video autoplay="true">
<source src="video.mp4#t=8,10" type="video/mp4" />
</video>

Fail Examples

Duration of the audio is longer than 3 seconds

<audio src="moon-speech.mp3" autoplay="true" controls></audio>

Duration of the video is > 3 seconds

<video autoplay="true">
<source src="video.mp4" type="video/mp4" />
</video>

No controls

<video autoplay="true">
    <source src="../test-assets/rabbit-video/video.mp4" type="video/mp4" />
    <source src="../test-assets/rabbit-video/video.webm" type="video/webm" />
</video>

Inapplicable Examples

No autoplay attribute

<audio src="moon-speech.mp3" controls></audio>

Muted

<video autoplay="true" muted="true">
<source src="video.mp4" type="video/mp4" />
</video>

Paused

<video autoplay="true" paused="true">
<source src="video.mp4" type="video/mp4" />
</video>

Questions:

what should be returned if controls are provided via scripts?
how to handle loop attribute?
should we await till media assets is loaded? we can do this by embracing preload

jeankaplansky commented 4 years ago

rule help infrastructure created 1/27/2020

jeankaplansky commented 4 years ago

New rule help created, captured in release notes 2/03/2020

padmavemulapati commented 4 years ago

Verified with 'no-autoplay-audio.html' test file, getting 'needs review' issues.