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 предоставляет функции для синхронизации приложений, что позволяет панели запуска отображать статус пользователя (залогинен ли он) и разрешают пользователю создавать аккаунт для синхронизации приложений между устройствами.

Объекты

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

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

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

Если вы используете старую версию API, обратите внимание, что она является устаревшей с . Далее сравниваются старая и новая версия 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.

Метки документа и участники

 Внесли вклад в эту страницу: Aleksej, SiMBa, gimlet
 Обновлялась последний раз: Aleksej,