chrome.app.runtime

Описание

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

Типы

ActionData

Хром 54+

Характеристики

  • Тип действия

    "новая_нота"

ActionType

Хром 54+

Приложение может быть запущено с учетом определенного действия, например, для создания новой заметки. Тип действия, с которым было запущено приложение, доступен внутри поля actionData экземпляра LaunchData.

Ценить

"новая_нота"

EmbedRequest

Характеристики

  • данные

    любые дополнительные

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

  • идентификатор встраивания

    нить

  • позволять

    пустота

    Позволяет embedderId встроить это приложение в элемент <appview>. url указывает контент для встраивания.

    Функция allow выглядит так: 

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

    • URL

      нить

  • отрицать

    пустота

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

    Функция deny выглядит так: 

    () => {...}

LaunchData

Характеристики

  • данные действия

    ActionData необязательно

    Хром 54+

    Содержит данные, указывающие ActionType с которым было запущено это приложение. Это значение равно нулю, если приложение не было запущено с конкретным намерением действия.

  • идентификатор

    строка необязательна

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

  • isKioskSession

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

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

  • isPublicSession

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

    Хром 47+

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

  • предметы

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

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

  • URL-адрес реферера

    строка необязательна

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

  • источник

    Источник запуска необязательно

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

  • URL

    строка необязательна

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

LaunchItem

Характеристики

  • вход

    Вход

    Вход по товару.

  • тип

    строка необязательна

    MIME-тип файла.

LaunchSource

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

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

"неотслеживаемый"

"app_launcher"

"новая_вкладка_страница"

"перезагрузить"

"перезапуск"

"load_and_launch"

"командная_строка"

"обработчик_файла"

"url_handler"

"system_tray"

"о_странице"

"клавиатура"

"страница_расширений"

"management_api"

"эфемерное_приложение"

"фон"

"киоск"

"chrome_internal"

"тест"

"установленное_уведомление"

"контекст_меню"

"дуга"

"intent_url"

"app_home_page"

"режим_фокуса"

"искристый"

События

onEmbedRequested

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

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

Параметры

onLaunched

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

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

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (launchData?: LaunchData) => void

    • данные запуска

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

onRestarted

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

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

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    () => void