ThecontrolsList property of theHTMLMediaElement interface returns a DOMTokenList that helps the useragent select what controls to show on the media element whenever the user agent showsits own set of controls. The DOMTokenList takes one or more of three possible values:nodownload,nofullscreen, andnoremoteplayback.

Value

ADOMTokenList.

The value ofcontrolsList can be set by passing a string representing theDOMTokenList'svalue property.

Examples

Getting the controlsList property

ThecontrolsList property returns aDOMTokenList object containing the current set value.

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 modifycontrolsList by directly setting it to a string containing the new value.

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

Specifications

Browser compatibility

See also

• Chrome HTMLMediaElement controlsList Sample