From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../archive/b2g_os/api/settingslock/index.html | 55 ++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 files/zh-cn/archive/b2g_os/api/settingslock/index.html (limited to 'files/zh-cn/archive/b2g_os/api/settingslock/index.html') diff --git a/files/zh-cn/archive/b2g_os/api/settingslock/index.html b/files/zh-cn/archive/b2g_os/api/settingslock/index.html new file mode 100644 index 0000000000..50f05a7966 --- /dev/null +++ b/files/zh-cn/archive/b2g_os/api/settingslock/index.html @@ -0,0 +1,55 @@ +--- +title: SettingsLock +slug: Archive/B2G_OS/API/SettingsLock +tags: + - API + - B2G + - Firefox OS + - NeedsTranslation + - Non-standard + - Settings + - TopicStub +translation_of: Archive/B2G_OS/API/SettingsLock +--- + + +
+

This API is available on Firefox OS for internal applications only.

+
+ +

The SettingsLock interface represents a lock on settings. it allows a script to modify settings asynchronously, but in a safe way: ordering is guaranteed and the no other script will modify the settings until the modification are done (the next lock objects will start processing after it has been closed).

+ +

Each call to SettingsManager.createLock() create a new SettingsLock object.

+ +

All SettingsLock objects are kept in a queue of active locks. When a SettingsLock object 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  the success/error event against it has been fired, the lock is removed from the queue and the next lock start to be processed.

+ +

Properties

+ +
+
SettingsLock.closed
+
Indicates if the lock is no longer the active lock (true) or if it's still the active lock (false)
+
+ +

Methods

+ +
+
SettingsLock.set()
+
Allows to change the values of a set of settings. This method is asychronous and return a DOMRequest object.
+
SettingsLock.get()
+
Allows to retrieve the value of a given setting. This method is asychronous and return a DOMRequest object.
+
SettingsLock.clear()
+
Clears any action that have not been done yet (remember that get and set are asynchronous). This method is added for testing and it deletes the whole settings DB!
+
+ +

Specification

+ +

Not part of any specification yet; however, this API will be discuss at W3C as part of the System Applications Working Group.

+ +

See also

+ + -- cgit v1.2.3-54-g00ecf