HTMLMediaElement: controlsList property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The controlsList property of the HTMLMediaElement interface returns a DOMTokenList that helps the user agent select what controls to show on the media element whenever the user agent shows its own set of controls. The DOMTokenList takes one or more of three possible values: nodownload, nofullscreen, and noremoteplayback.

Value

A DOMTokenList.

The value of controlsList can be set by passing a string representing the DOMTokenList's value property.

Examples

Getting the controlsList property

The controlsList property returns a DOMTokenList object containing the current set value.

js
const video = document.createElement("video");
console.log(video.controlsList.value); // ""

video.controlsList.add("noremoteplayback");
console.log(video.controlsList.value); // "noremoteplayback"

Setting the controlsList property

You can also modify controlsList by directly setting it to a string containing the new value.

js
const audio = document.createElement("audio");
audio.controlsList = "nodownload";

Specifications

Specification

Unknown specification
# solution-outline

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Feb 25, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content