WebAPI/SettingsAPI

Status

The proposed specification doesn't have a fully working implementation yet. Patches will appear in bug 678695.

Proposed API

There is a readonly mozSettings attribute in window.navigator that would return an object implementing the SettingsManager interface.

 interface SettingsManager : EventTarget
 {
   // List of known settings.
   const DOMString FOOBAR = "foobar";
 
   // SettingsRequest.result contains the new value of the setting.
   SettingsRequest set(DOMString name, DOMString value);
 
   // SettingsRequest.result contains the value of the setting.
   SettingsRequest get(DOMString name);
 
   attribute Function? onchange;
 }

 /* Similar to SmsRequest. */
 interface SettingsRequest
 {
   readonly attribute DOMString     readyState; // "processing" or "done"
   readonly attribute DOMError?     error;
            attribute EventListener onsuccess;
            attribute EventListener onerror;
            attribute readonly any? result;
 };

 [Constructor(DOMString type, optional SettingsEventInit settingsEventInitDict)]
 interface SettingsEvent : Event
 {
   readonly attribute DOMString settingName;
   readonly attribute DOMString settingValue;
 };

 dictionary SettingsEventInit : EventInit {
   DOMString settingName;
   DOMString settingValue;
 }

SettingsEvent is used for the followings events: - change which is dispatched to the SettingsManager object when a setting value changes

Notes

• SettingsRequest will be similar to SMSRequest described in WebSMS specification.
• If a setting is unknown by the platform, it should fail.
• But some platforms might not know some settings. Do we want to add a method that checks if the platform knows a specific setting?