MediaList

The MediaList interface represents the media queries of a stylesheet, e.g. those set using a <link> element's media attribute.

Note: MediaList is a live list; updating the list using properties or methods listed below will immediately update the behavior of the document.

Properties

MediaList.mediaText
A stringifier that returns a DOMString representing the MediaList as text, and also allows you to set a new MediaList.
MediaList.length Read only
Returns the number of media queries in the MediaList.

Methods

MediaList.appendMedium()
Adds a media query to the MediaList.
MediaList.deleteMedium()
Removes a media query from the MediaList.
MediaList.item()
A getter that returns a CSSOMString representing a media query as text, given the media query's index value inside the MediaList.

Examples

The following would log to the console a textual representation of the MediaList of the first stylesheet applied to the current document.

const stylesheets = document.styleSheets;
let stylesheet = stylesheets[0];
console.log(stylesheet.media.mediaText);

Specifications

Specification Status Comment
CSS Object Model (CSSOM)
The definition of 'MediaList' in that specification.
Working Draft

Browser compatibility

No compatibility data found. Please contribute data for "api.MediaList" (depth: 1) to the MDN compatibility data repository.