coderef

matchMediaBaseline · Widely available

The window.matchMedia() method checks whether a media query applies to the document.

Supported in all major browsers for at least 30 months — safe to use without fallbacks. Baseline since Jul 29, 2015. Widely available since Jan 29, 2018.

How to use ↓Compare browsers

Browser support

DesktopChrome
1–8Not supported
9+Supportedsince Feb 3, 2011
Current: 155
Edge
12+Supportedsince Jul 29, 2015
Current: 154
Firefox
1–5Not supported
6+Supportedsince Aug 16, 2011
Current: 157
Safari
1–5Not supported
5.1+Supportedsince Jul 20, 2011
Current: 27
MobileChrome Android
18+Supportedsince Jun 27, 2012
Current: 155
Firefox Android
4–5Not supported
6+Supportedsince Aug 16, 2011
Current: 157
Safari iOS
1–4.2Not supported
5+Supportedsince Oct 12, 2011
Current: 27

How to use

This feature is Baseline widely available — use it freely, no fallback needed.

Example

Full syntax and examples are on MDN: MediaQueryList.

Feature detection

JS · check before using
if ("Window" in globalThis && "matchMedia" in Window.prototype) {
  // Window.matchMedia is available
}

Documentation (MDN)

Specification

Usage share

Sub-features

Support for each part of the feature (10). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
MediaQueryList91265.11865
MediaQueryList.EventTarget_inheritance39165514395514
MediaQueryList.change_event39795514395514
MediaQueryList.matches91265.11865
MediaQueryList.media91265.11865
MediaQueryListEvent39795514395514
MediaQueryListEvent.MediaQueryListEvent39795514395514
MediaQueryListEvent.matches39795514395514
MediaQueryListEvent.media39795514395514
Window.matchMedia91265.11865