MDN self-hosted library · e01.org

PreferenceManager: colorScheme property

User Preferences API

Open notebook · 1 cells web-api-instance-property upstream source

User Preferences API

The colorScheme read-only property of the PreferenceManager interface returns a PreferenceObject used to override the user's preference for the color scheme of the site.

Valid colorScheme PreferenceObject.value settings are dark and light.

Value

A PreferenceObject used to override the user's preference for the color scheme of the site.

Examples

Basic usage

This example demonstrates how to query the user's preferred color scheme.

if (navigator.preferences.colorScheme.value === "dark") {
  // The user prefers a dark color scheme.
} else {
  // The user prefers a light color scheme.
}

Specifications

Browser compatibility