WebAPI/SettingsAPI: Difference between revisions

← Older edit

WebAPI/SettingsAPI (view source)

Revision as of 23:56, 1 October 2014

498 bytes added , 1 October 2014

no edit summary

Chaasof

Confirmed users

1,340

edits

@@ Line 1: / Line 1: @@
 == Status ==
-The proposed specification doesn't have a fully working implementation yet. Patches will appear in {{bug|678695}}.
+This was implemented for B2G in {{bug|678695}}.
 == Proposed API ==
@@ Line 7: / Line 7: @@
 There is a readonly mozSettings attribute in ''window.navigator'' that would return an object implementing the ''SettingsManager'' interface.
-  interface SettingsManager : EventTarget
+The implementation keeps a queue of active locks. When a lock is created it's placed at the end of the queue. Calls to get/set places a request against the lock on which it's called. Requests run asynchronously and in the order they are placed against a lock. When the last request for a lock is run, and we've fired the success/error event against it, the lock is removed from the queue and we start processing the next lock.
-  {
-    // 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);
-  }
-   /* Similar to SmsRequest. */
+ interface SettingsManager : EventTarget
-   interface SettingsRequest
+ {
-   {
+   SettingsLock getLock();
-    readonly attribute DOMString     readyState; // "processing" or "done"
-    readonly attribute DOMError?     error;
+  void addObserver(DOMString name, Function observer);
-             attribute EventListener onsuccess;
+ }
-             attribute EventListener onerror;
-             attribute readonly any? result;
+ interface SettingsLock
-  };
+ {
+  // Contains a JSON object with name/value pairs to be set.
+   DOMRequest set(any settings);
+   // result contains the value of the setting.
+  DOMRequest get(DOMString name);
+  // XXX not implemented
+  // result contains JSON object with name/value pairs.
+  DOMRequest get(DOMString[] names);
+ }
-  [Constructor(DOMString type, optional SettingsEventInit settingsEventInitDict)]
+ /* Same as used in other specs. */
-  interface SettingsEvent : Event
+ interface DOMRequest
-  {
+ {
-    readonly attribute DOMString settingName;
+   readonly attribute DOMString     readyState; // "processing" or "done"
-    readonly attribute DOMString settingValue;
+   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 any       settingValue;
+ };
-  dictionary SettingsEventInit : EventInit {
+ dictionary SettingsEventInit : EventInit {
-    DOMString settingName;
+   DOMString settingName;
-    DOMString settingValue;
+   any       settingValue;
-  }
+ }
 ''SettingsEvent'' is used for the followings events:
@@ Line 49: / Line 59: @@
 * 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?
+* get('*') returns all settings.
+[[Category:Web APIs]]