chrome.app.runtime

Description

Utilisez l'API chrome.app.runtime pour gérer le cycle de vie de l'application. L'environnement d'exécution de l'application gère l'installation de l'application, contrôle la page d'événements et peut arrêter l'application à tout moment.

Types

EmbedRequest

Propriétés

  • données

    facultatif

    Données facultatives spécifiées par le développeur que l'application à intégrer peut utiliser pour prendre une décision d'intégration.

  • embedderId

    chaîne

  • allow

    vide

    Permet à embedderId d'intégrer cette application dans un élément <appview>. url spécifie le contenu à intégrer.

    La fonction allow se présente comme suit : 

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

    • url

      chaîne

  • deny

    vide

    Empêche embedderId d'intégrer cette application dans un élément <appview>.

    La fonction deny se présente comme suit : 

    () => {...}

LaunchData

Propriétés

  • id

    chaîne facultatif

    ID du gestionnaire de fichiers ou d'URL avec lequel l'application est appelée. Les ID de gestionnaire sont les clés de premier niveau des dictionnaires file_handlers et/ou url_handlers du fichier manifeste.

  • isKioskSession

    boolean facultatif

    Indique si l'application est lancée dans une session kiosque ChromeOS.

  • isPublicSession

    boolean facultatif

    Chrome 47 ou version ultérieure

    Indique si l'application est lancée dans une session publique ChromeOS.

  • éléments

    LaunchItem[] facultatif

    Entrées de fichier pour l'événement onLaunched déclenché par un gestionnaire de fichiers correspondant dans la clé de fichier manifeste file_handlers.

  • referrerUrl

    chaîne facultatif

    URL de provenance de l'événement onLaunched déclenché par un gestionnaire d'URL correspondant dans la clé de fichier manifeste url_handlers.

  • source

    LaunchSource facultatif

    Emplacement à partir duquel l'application est lancée.

  • url

    chaîne facultatif

    URL de l'événement onLaunched déclenché par un gestionnaire d'URL correspondant dans la clé de fichier manifeste url_handlers.

LaunchItem

Propriétés

  • entry

    Entrée

    Entrée de l'élément.

  • type

    chaîne facultatif

    Type MIME du fichier.

LaunchSource

Énumération des sources de lancement de l'application. Ce paramètre doit être synchronisé avec AppLaunchSource dans components/services/app_service/public/mojom/types.mojom et GetLaunchSourceEnum() dans extensions/browser/api/app_runtime/app_runtime_api.cc. Notez que l'énumération est utilisée dans l'histogramme UMA. Les entrées ne doivent donc pas être réorganisées ni supprimées.

Énumération

"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"

Événements

onEmbedRequested

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

Se déclenche lorsqu'une application d'intégration demande à intégrer cette application. Cet événement n'est disponible que sur la version en développement avec l'option --enable-app-view.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (request: EmbedRequest) => void

onLaunched

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

Déclenché lorsqu'une application est lancée depuis le lanceur d'applications.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (launchData?: LaunchData) => void

onRestarted

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

Déclenché au démarrage de Chrome pour les applications qui étaient en cours d'exécution lors du dernier arrêt de Chrome, ou lorsque les applications ont été invitées à redémarrer à partir de leur état précédent pour d'autres raisons (par exemple, lorsque l'utilisateur révoque l'accès aux fichiers conservés d'une application, l'environnement d'exécution redémarre l'application). Dans ce cas, si les applications ne disposent pas d'un gestionnaire onRestarted, elles recevront un événement onLaunched à la place.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    () => void