W3cubDocs

/Web APIs

MediaQueryList: media property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

The media read-only property of the MediaQueryList interface is a string representing a serialized media query.

Value

A string representing a serialized media query.

Examples

This example runs the media query (width <= 600px) and displays the value of the resulting MediaQueryList's media property in a <span>.

JavaScript

let mql = window.matchMedia("(width <= 600px)");

document.querySelector(".mq-value").innerText = mql.media;

The JavaScript code passes the media query to match into matchMedia() to compile it, then sets the <span>'s innerText to the value of the result's media property.

HTML

<span class="mq-value"></span>

A <span> to receive the output.

Result

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
media 9 12 6 12.1 5.1 18 6 12.1 5 1.0 4.4 5

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaQueryList/media