PreferenceObject: value property
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
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.
js
if (navigator.preferences.reducedMotion.value === "reduce") {
// The user prefers reduced motion.
} else {
// The user has stated no preference regarding motion.
}
Specifications
| Specification |
|---|
| Media Queries Level 5 # preference-value-attribute |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
value
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.