JavaScript API для приложений

The Open Web Apps JavaScript API это программный интерфейс для установки веб-приложений и для управления коллекцией установленных веб-приложений на стороне клиента. Такие коллекции называются репозиториями приложений.

Доступные возможности

Описанный здесь JavaScript API доступен в Firefox, Firefox for Android, и Firefox OS.

Методы API

Все методы, относящиеся к приложениям, доступны через объект navigator.mozApps. В API доступны два типа функций:

Функции Установки: функции, относящиеся к установке приложений и управлению ими. Они представляют интерес для хранилищ, самораспространяемых приложений и для каталогов приложений.
Функции Управления: функции, относящиеся к отображению, запуску, или синхронизации приложений. Приимущественно, используются панелями запуска.

API Установки (`navigator.mozApps.*`)

API установки приложени представленно методами объекта window.navigator.mozApps.

API Управления (`navigator.mozApps.mgmt.*`)

API управления является привилегированым. Он предназначен для получения доступа к довереным страницам, называемым «панелями запуска». API управления предоставляет функции, которые позволяют панелям запуска управлять приложениями и запускать их от имени пользователя. Также, API предоставляет функции для синхронизации приложений, что позволяет панели запуска отображать статус пользователя (залогинен ли он) и разрешают пользователю создавать аккаунт для синхронизации приложений между устройствами.

navigator.mozApps.mgmt.getAll()

Объекты

Следующие типы объектов JavaScript используются API приложений:

App objects представляет приложение.
DOMRequest объекты, возвращаемые несколькими методами.
DOMError objects представляет ошибки, возвращаемые методом.

Старая и новая версия API

Если вы используете старую версию API, обратите внимание, что она является устаревшей с марта 2012 года. Далее сравниваются старая и новая версия API.

navigator.mozApps.install(): У этой функции изменилась сигнатура.
navigator.mozApps.amInstalled(): Заменено на navigator.mozApps.getSelf().
navigator.mozApps.getInstalledBy(): Заменено на navigator.mozApps.getInstalled().
navigator.mozApps.mgmt.list(): Заменено на navigator.mozApps.mgmt.getAll().
navigator.mozApps.mgmt.watchUpdates(onupdate) navigator.mozApps.mgmt.clearWatch(watchId): Обе заменены на navigator.mozApps.oninstall и navigator.mozApps.onuninstall.
navigator.mozApps.mgmt.uninstall(origin, [onsuccess], [onerror]): Заменено на navigator.mozApps.mgmt.uninstall(app), где app — объект, возвращаемый getAll() или любой другой функцией handing app objects.