WebAPI/SystemUpdateAPI: Difference between revisions
< WebAPI
Jump to navigation
Jump to search
JamesCheng (talk | contribs) (Created page with "= Goals = == Contributors == Shih-Chiang Chien, James Cheng == Status == * {{bug|1037329}} == Features == * . * . * . == Proposed API == === Basic WebIDL Interface ===...") |
JamesCheng (talk | contribs) (→Basic WebIDL Interface: Ident) |
||
Line 14: | Line 14: | ||
== Proposed API == | == Proposed API == | ||
=== Basic WebIDL Interface === | === Basic WebIDL Interface === | ||
[JSImplementation="@mozilla.org/system-update-provider;1", | |||
CheckPermissions="system-update", | CheckPermissions="system-update", | ||
Pref="dom.system_update.enabled"] | Pref="dom.system_update.enabled"] |
Revision as of 08:25, 3 August 2015
Goals
Contributors
Shih-Chiang Chien, James Cheng
Status
Features
- .
- .
- .
Proposed API
Basic WebIDL Interface
[JSImplementation="@mozilla.org/system-update-provider;1", CheckPermissions="system-update", Pref="dom.system_update.enabled"] interface SystemUpdateProvider : EventTarget { readonly attribute DOMString name; readonly attribute DOMString uuid; attribute EventHandler onupdateavailable; attribute EventHandler onprogress; attribute EventHandler onupdateready; attribute EventHandler onerror; void checkForUpdate(); void startDownload(); void stopDownload(); void applyUpdate(); boolean setParameter(DOMString name, DOMString value); DOMString getParameter(DOMString name); }; [NavigatorProperty="updateManager", JSImplementation="@mozilla.org/system-update-manager;1", CheckPermissions="system-update", Pref="dom.system_update.enabled"] interface SystemUpdateManager { Promise<sequence<SystemUpdateProviderInfo>> getProviders(); Promise<SystemUpdateProvider> setActiveProvider(DOMString uuid); Promise<SystemUpdateProvider> getActiveProvider(); };
Examples
navigator.udpateManager.getProviders().then(function(providerInfos) {
var providerInfo = providerInfos[0]; return navigator.updateManager.setActiveProvider(providerInfo.uuid);
}).then(function(provider) {
// notify available update checkButton.onclick = function(event) { provider.checkForUpdate(); }; provider.onupdateavailable = function(evt) { showUpdateAvailable(event.detail.packageInfo); downloadButton.onclick = function(event) { provider.startDownload(); }; };
});
// display download progress
provider.onprogress = function(event) { showDownloadProgress(event); };
// prompt when update package is ready to apply provider.onupdateready = function(event) { showUpdateReady(); applyButton.onclick = function() { provider.applyUpdate(); }; };
});
// scheduled update var myDate = new Date("May 15, 2012 16:20:00"); var req = navigator.mozAlarms.add(myDate, "ignoreTimezone", provider.info); req.onsuccess = function(event) {
var info = event.alarm.data; navigator.updateManager.setActiveProvider(info.uuid) .then(function(provider) { provider.checkForUpdate(); });
};