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

    tout 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 fichier 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

    booléen facultatif

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

  • isPublicSession

    booléen facultatif

    Chrome 47 et versions ultérieures

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

  • éléments

    LaunchItem[] facultatif

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

  • referrerUrl

    chaîne facultatif

    URL du référent pour 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

    Enregistrement de l'article.

  • type

    chaîne facultatif

    Type MIME du fichier.

LaunchSource

Énumération des sources de lancement de l'application. Cette valeur doit être synchronisée 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. Par conséquent, les entrées ne doivent 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,
)

Déclenché lorsqu'une application d'intégration demande à intégrer cette application. Cet événement n'est disponible que sur le canal de développement avec l'indicateur --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 à partir du lanceur.

Paramètres

  • callback

    fonction

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

    (launchData?: LaunchData) => void

onRestarted

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

Appelé au démarrage de Chrome pour les applications qui étaient en cours d'exécution lors de la dernière fermeture 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 ces situations, si les applications ne disposent pas d'un gestionnaire onRestarted, un événement onLaunched leur est envoyé à la place.

Paramètres

  • callback

    fonction

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

    () => void