Document the user preferences API

[remcohaszing]

Description

This adds content for the navigator.preferences property and related objects.

Motivation

I want to raise more awareness for this awesome upcoming feature.

Additional details

• https://drafts.csswg.org/mediaqueries-5/#preferences-attribute
• https://github.com/WICG/web-preferences-api

Related issues and pull requests

Relates to mdn/browser-compat-data#29142

[remcohaszing]

The side navigation for the User Preferences API is missing. I couldn’t figure out what’s needed to make it work.

[github-actions]

Preview URLs (16 pages)

• /en-US/docs/Web/API/Navigator/preferences
• /en-US/docs/Web/API/Navigator
• /en-US/docs/Web/API/PreferenceObject/change_event
• /en-US/docs/Web/API/PreferenceObject/clearOverride
• /en-US/docs/Web/API/PreferenceObject/override
• /en-US/docs/Web/API/PreferenceObject/requestOverride
• /en-US/docs/Web/API/PreferenceObject/validValues
• /en-US/docs/Web/API/PreferenceObject/value
• /en-US/docs/Web/API/PreferenceObject
• /en-US/docs/Web/API/PreferencesManager/colorScheme
• /en-US/docs/Web/API/PreferencesManager/contrast
• /en-US/docs/Web/API/PreferencesManager/reducedData
• /en-US/docs/Web/API/PreferencesManager/reducedMotion
• /en-US/docs/Web/API/PreferencesManager/reducedTransparency
• /en-US/docs/Web/API/PreferencesManager
• /en-US/docs/Web/API/User_Preferences_API

Flaws (29)

Note! 3 documents with no flaws that don't need to be listed. 🎉

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/API/Navigator
Title: Navigator
Flaw count: 1

• macros:
  • Macro domxref produces link /en-US/docs/Web/API/Navigator/standalone which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferenceObject/change_event
Title: PreferenceObject: change event
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferenceObject/clearOverride
Title: PreferenceObject: clearOverride() method
Flaw count: 4

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve
• unknown:
  • must be provided
  • must be provided

---

URL: /en-US/docs/Web/API/PreferenceObject/override
Title: PreferenceObject: override property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferenceObject/requestOverride
Title: PreferenceObject: requestOverride() method
Flaw count: 4

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve
• unknown:
  • must be provided
  • must be provided

---

URL: /en-US/docs/Web/API/PreferenceObject/validValues
Title: PreferenceObject: validValues property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferenceObject/value
Title: PreferenceObject: value property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferencesManager/colorScheme
Title: PreferencesManager: colorScheme property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferencesManager/contrast
Title: PreferencesManager: contrast property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferencesManager/reducedData
Title: PreferencesManager: reducedData property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferencesManager/reducedMotion
Title: PreferencesManager: reducedMotion property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/PreferencesManager/reducedTransparency
Title: PreferencesManager: reducedTransparency property
Flaw count: 2

• macros:
  • Macro apiref produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro apiref produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve

---

URL: /en-US/docs/Web/API/User_Preferences_API
Title: User Preferences API
Flaw count: 2

• macros:
  • Macro defaultapisidebar produces link /en-US/docs/Web/API/PreferenceManager which doesn't resolve
  • Macro defaultapisidebar produces link /en-US/docs/Web/API/PreferencesObject which doesn't resolve