MDN self-hosted library · e01.org

PreferenceObject

User Preferences API

no runnable cells web-api-interface upstream source

User Preferences API

The PreferenceObject interface of the User Preferences API provides attributes and methods for reading and overriding user preferences.

Use the document's PreferenceManager (accessed via Navigator.preferences) to get access to the PreferenceObject objects representing each available preference.

The PreferenceManager interface inherits from EventTarget.

Instance properties

  • PreferenceObject.override
  • : The override value if set, null otherwise.
  • PreferenceObject.value
  • : The override value if set, the UA default otherwise.
  • PreferenceObject.validValues
  • : The valid values for the override.

Instance methods

  • PreferenceObject.clearOverride()
  • : Resets any previously set override to null and fires the change event.
  • PreferenceObject.requestOverride()
  • : Requests an override of the preference and fires the change event on success.

Events

  • change
  • : Fired when the override is set or reset.

Specifications

Browser compatibility