# Test that a video really plays, and what the page says when it cannot

> A player on the page is not a video that plays. One plain-language test presses play, checks the time moves, checks captions, plays audio and finds a broken video.

By Jason Nguyen, Founder, Testsy. Published 2026-11-20. https://testsy.dev/blog/test-that-a-video-really-plays/

## A player is not a playing video

A product video on a landing page, a lesson in a course, a clip in a help article. The test for it is usually "the video element is on the page". That is true when the file is missing, when the format is wrong for the browser, when the link expired last week, and when the player loads and sits at 0:00 for ever.

Whether media plays is not something a screenshot shows. A paused video and a playing video look the same in one frame. The honest test is the one a person does without thinking: press play, and see whether the time moves.

Scripts can do it, by reaching into the media element and reading its clock twice. Few suites bother, so broken videos are found by visitors.

## The test

Written as plain text and run in Chrome on a desktop-sized screen:

```text
Open Video & audio. Play the product video and verify that it really
plays (its time advances) and that English captions are available.
Pause it and verify it is paused. Then play the podcast clip and verify
that it plays. Then check the Archived video section and verify that
the page tells the user the video is unavailable when the video cannot
be played.
```

The site is Web Lab, our practice site. Its Video & audio page has a 30-second product video with captions, a 20-second audio clip, and an archived video whose file is broken on purpose.

## What happened

The picture at the top of this page shows two screens from the run: the product video playing with the caption "Welcome to the QA product video.", and further down the page, the podcast clip playing at 0:08 and the archived video with "This video is unavailable."

The tester measured each claim instead of looking once:

- **Playing.** After pressing play, the video's time went from 3.13 to 4.34 seconds between two readings, and English captions were showing.
- **Paused.** After pressing pause, the time stood at 7.71 seconds on both readings, and the page said "Paused at 0:07".
- **Audio.** The podcast clip's time went from 7.78 to 8.98 seconds.
- **Broken.** The archived video's player was in its error state, and the page said "This video is unavailable."

![The result: all 8 checks passed in 49 seconds.](https://testsy.dev/blog/img/web-media-result.webp)

Two details from the checks are worth reading. The first click on the podcast's play button did not start it, so the tester pressed the space bar, and the check says so. And "Paused at 0:07" on the page is a rounded figure: the measured time was 7.71 seconds, and the check explains that the difference does not contradict the paused state.

![The checks, with the two time readings for each player.](https://testsy.dev/blog/img/web-media-checks.webp)

[Recording: The review video of the run, 30 seconds. It is a video of a video being tested.](https://testsy.dev/blog/video/web-media.mp4)

Open [the run](https://app.testsy.dev/share/gNkwVktiJAbRGLxGaQZOjhao3vVx34K4) to step through it. The link is read-only and stays live until 18 February 2027.

## Write it for your app

```text
Open the pricing page and play the product video.
Check that it really plays and that it has English captions.
Open the course "Getting started" with the stored account "student",
play lesson 2 and check that it plays.
Skip to the end and check that lesson 2 is marked as watched.
```

What to check around media:

- **It plays.** Say "really plays" or "its time advances", so the check is a measurement.
- **Captions exist.** A missing captions track is an accessibility bug that no screenshot shows.
- **The broken case has words.** When a file is gone, the page should say so. A black rectangle is not an error message.
- **What happens after.** Progress saved, the next lesson unlocked, the watched mark set.

This test covers playback in Chrome on a desktop-sized screen. It does not judge picture quality or measure buffering on a slow connection.

## Run it

Paste your site's address into **New test**, say which video to play and what should follow, and run it. [Write a test](https://testsy.dev/docs/write-a-test/) covers wording steps and checks.

This post is one of a series: [The hardest parts of web testing, each one run for real](https://testsy.dev/blog/the-hardest-parts-of-web-testing/).
