chrome.app.runtime

Описание

Используйте chrome.app.runtime API для управления жизненным циклом приложения. Среда выполнения управляет установкой приложения, контролирует страницу событий и может в любой момент закрыть приложение.

Типы

EmbedRequest

Свойства

  • делал.

    any optional

    Необязательные данные, указанные разработчиком, которые встраиваемое приложение может использовать при принятии решения о встраивании.

  • embedderId

    string

  • allow

    void

    Разрешает embedderId встраивать это приложение в элемент <appview>. url указывает на контент, который нужно встроить.

    Функция allow выглядит следующим образом: 

    (url: string) => {...}

    • url

      string

  • deny

    void

    Запрещает embedderId встраивать это приложение в элемент <appview>.

    Функция deny выглядит следующим образом: 

    () => {...}

LaunchData

Свойства

  • id

    Строка (необязательно)

    Идентификатор обработчика файла или URL, с которым вызывается приложение. Идентификаторы обработчиков – это ключи верхнего уровня в словарях file_handlers и/или url_handlers в манифесте.

  • isKioskSession

    Логическое значение (необязательно)

    Запускается ли приложение в режиме киоска ChromeOS.

  • isPublicSession

    Логическое значение (необязательно)

    Chrome 47 и более поздних версий;

    Запускается ли приложение в общедоступном сеансе Chrome OS.

  • items

    LaunchItem[] необязательный

    Записи файлов для события onLaunched, активированного соответствующим обработчиком файлов в ключе манифеста file_handlers.

  • referrerUrl

    Строка (необязательно)

    URL перехода для события onLaunched, активированного соответствующим обработчиком URL в ключе манифеста url_handlers.

  • source

    LaunchSource необязательный

    Откуда запускается приложение.

  • url

    Строка (необязательно)

    URL для события onLaunched, активированного соответствующим обработчиком URL в ключе манифеста url_handlers.

LaunchItem

Свойства

  • запись

    Запись

    Запись для объекта.

  • тип

    Строка (необязательно)

    MIME-тип файла.

LaunchSource

Перечисление источников запуска приложения. Требует постоянной синхронизации с AppLaunchSource в components/services/app_service/public/mojom/types.mojom и GetLaunchSourceEnum() в extensions/browser/api/app_runtime/app_runtime_api.cc. Обратите внимание, что перечисление используется в гистограмме UMA, поэтому записи не следует переупорядочивать или удалять.

Перечисление

"untracked"

"app_launcher"

"new_tab_page"

"reload"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

"sparky"

События

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

Срабатывает, когда приложение запрашивает встраивание этого приложения. Это событие доступно только в канале для разработчиков с флагом --enable-app-view.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (request: EmbedRequest) => void

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

Активируется, когда приложение запускается с панели запуска.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (launchData?: LaunchData) => void

    • launchData

      LaunchData необязательный

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

Срабатывает при запуске Chrome для приложений, которые работали во время последнего завершения работы Chrome, или когда приложениям было предложено перезапуститься из предыдущего состояния по другим причинам (например, когда пользователь отзывает доступ к сохраненным файлам приложения, среда выполнения перезапускает приложение). В таких случаях, если у приложений нет обработчика onRestarted, им будет отправлено событие onLaunched.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    () => void