Skip to content

How to detect dark mode using JavaScript

New Course Coming Soon:

Get Really Good at Git

Detecting dark mode, and detecting mode change using JavaScript

Using CSS we can detect dark mode using the prefers-color-scheme media query.

But.. what if we have to use JavaScript? I recently stumbled on this problem, because I had some JavaScript code that added an image to the page, but I wanted to show a different image based on the light/dark mode.

Here’s how we can do it.

First, detect if the matchMedia object exists (otherwise the browser does not support dark mode, and you can fall back to light mode).

Then, check if it’s dark mode using

window.matchMedia('(prefers-color-scheme: dark)').matches

This will return true if dark mode is enabled.

Here’s a full example, where I invert the colors of an image if it’s dark mode:

const img = document.querySelector('#myimage')
if (window.matchMedia && 
    window.matchMedia('(prefers-color-scheme: dark)').matches) {"invert(100%)";

There is a problem though: what if the user changes mode while using our website?

We can detect the mode change using an event listener, like this:

window.matchMedia('(prefers-color-scheme: dark)')
      .addEventListener('change', event => {
  if (event.matches) {
    //dark mode
  } else {
    //light mode
Are you intimidated by Git? Can’t figure out merge vs rebase? Are you afraid of screwing up something any time you have to do something in Git? Do you rely on ChatGPT or random people’s answer on StackOverflow to fix your problems? Your coworkers are tired of explaining Git to you all the time? Git is something we all need to use, but few of us really master it. I created this course to improve your Git (and GitHub) knowledge at a radical level. A course that helps you feel less frustrated with Git. Launching May 21, 2024. Join the waiting list!
→ Get my JavaScript Beginner's Handbook
→ Read my JavaScript Tutorials on The Valley of Code
→ Read my TypeScript Tutorial on The Valley of Code

Here is how can I help you: