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 des applications, contrôle la page de l'événement et peut arrêter l'application à tout moment.

Types

ActionData

Chrome 54 ou version ultérieure

Propriétés

  • actionType

    "new_note"

ActionType

Chrome 54 ou version ultérieure

Une application peut être lancée en pensant à une action spécifique, par exemple créer une note. Le type d'action avec lequel l'application a été lancée est disponible dans le champ actionData de l'instance LaunchData.

Valeur

"new_note"

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 lorsqu'il prend une décision concernant l'intégration.

  • embedderId

    chaîne

  • allow

    void

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

    La fonction allow ressemble à ceci : 

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

    • url

      chaîne

  • deny

    void

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

    La fonction deny ressemble à ceci : 

    () => {...}

LaunchData

Propriétés

  • actionData

    ActionData facultatif

    Chrome 54 ou version ultérieure

    Contient des données qui spécifient le ActionType avec lequel cette application a été lancée. Cette valeur est nulle si l'application n'a pas été lancée avec un intent d'action spécifique.

  • id

    chaîne facultatif

    ID du fichier ou du gestionnaire d'URL avec lequel l'application est appelée. Les ID de gestionnaire sont les clés de niveau supérieur dans les 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 ou version ultérieure

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

  • items

    LaunchItem[] facultatif

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

  • referrerUrl

    chaîne facultatif

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

  • source

    LaunchSource facultatif

    Il s'agit de l'endroit depuis lequel 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é du 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. Il 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. Par conséquent, les entrées ne doivent pas être réorganisées ni supprimées.

Enum

"app_launcher"

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"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 la version en développement avec l'indicateur --enable-app-view.

Paramètres

onLaunched

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

Déclenché lorsqu'une application est lancée à partir du lanceur d'applications.

Paramètres

  • rappel

    function

    Le paramètre callback ressemble à ceci : 

    (launchData?: LaunchData) => void

onRestarted

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

Déclenché au démarrage de Chrome pour les applications en cours d'exécution lors de la dernière fermeture de Chrome, ou lorsque des applications ont été invitées à redémarrer depuis 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 n'ont pas de gestionnaire onRestarted, elles recevront un événement onLaunched à la place.

Paramètres

  • rappel

    function

    Le paramètre callback ressemble à ceci : 

    () => void