Firefox Tomorrow

web api instance property

PreferenceObject: value property

View on MDN ↗

Limited availabilitySecure context

The value read-only property of the PreferenceManager interface returns the override value of a preference if one is set, or the UA-defined value if an override value is not set.

Value

The override of the PreferenceObject interface if one is set, or the UA-defined value otherwise.

Examples

Basic usage

This example demonstrates how to query the user’s reduced motion preference.

if (navigator.preferences.reducedMotion.value === "reduce") {
  // The user prefers reduced motion.
} else {
  // The user has stated no preference regarding motion.
}

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.