chrome.app.runtime

Beschreibung

Verwenden Sie die chrome.app.runtime API, um den App-Lebenszyklus zu verwalten. Die App-Laufzeit verwaltet die App-Installation, steuert die Ereignisseite und kann die App jederzeit beenden.

Typen

ActionData

Chrome 54 und höher

Attribute

  • actionType

    "new_note"

ActionType

Chrome 54 und höher

Eine App kann mit einer bestimmten Aktion gestartet werden, z. B. um eine neue Notiz zu erstellen. Der Aktionstyp, mit dem die App gestartet wurde, ist im Feld actionData der LaunchData-Instanz verfügbar.

Wert

"new_note"

EmbedRequest

Attribute

  • daten

    Beliebig optional

    Optionale, vom Entwickler angegebene Daten, die die einzubettende App für eine Entscheidung über die Einbettung verwenden kann.

  • embedderId

    String

  • allow

    void

    Ermöglicht embedderId, diese App in ein <appview>-Element einzubetten. Der url gibt den einzubettenden Inhalt an.

    Die Funktion allow sieht so aus: 

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

    • url

      String

  • deny

    void

    Verhindert, dass embedderId diese App in ein <appview>-Element einbettet.

    Die Funktion deny sieht so aus: 

    ()=> {...}

LaunchData

Attribute

  • actionData

    ActionData optional

    Chrome 54 und höher

    Enthält Daten zur Angabe der ActionType, mit der diese App gestartet wurde. Dieser Wert ist null, wenn die App nicht mit einem bestimmten Aktionsabsicht gestartet wurde.

  • id

    String optional

    Die ID der Datei oder des URL-Handlers, mit der bzw. dem die App aufgerufen wird. Handler-IDs sind die Schlüssel der obersten Ebene in den Wörterbüchern file_handlers und/oder url_handlers im Manifest.

  • isKioskSession

    Boolescher Wert optional

    Gibt an, ob die App in einer ChromeOS-Kiosksitzung gestartet wird.

  • isPublicSession

    Boolescher Wert optional

    Chrome 47 und höher

    Gibt an, ob die App in einer öffentlichen Chrome OS-Sitzung gestartet wird.

  • items

    LaunchItem[] optional

    Die Dateieinträge für das Ereignis onLaunched, die von einem übereinstimmenden Datei-Handler im Manifestschlüssel file_handlers ausgelöst wurden.

  • referrerUrl

    String optional

    Die Verweis-URL für das Ereignis onLaunched, die von einem übereinstimmenden URL-Handler im Manifestschlüssel url_handlers ausgelöst wurde.

  • source

    LaunchSource optional

    Der Ort, von dem aus die App gestartet wird.

  • url

    String optional

    Die URL für das onLaunched-Ereignis, die von einem übereinstimmenden URL-Handler im Manifestschlüssel url_handlers ausgelöst wurde.

LaunchItem

Attribute

  • Eintrag

    Eintrag

    Eintrag für das Element.

  • Typ

    String optional

    Der MIME-Typ der Datei.

LaunchSource

Aufzählung der Quellen für App-Starts. Dies sollte mit AppLaunchSource in Components/services/app_service/public/mojom/types.mojom und GetLaunchSourceEnum() in extensions/browser/api/app_runtime/app_runtime_api.cc synchronisiert bleiben. Beachten Sie, dass die Aufzählung im UMA-Histogramm verwendet wird, sodass Einträge nicht neu angeordnet oder entfernt werden sollten.

Enum

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"chrome_internal"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

Veranstaltungen

onEmbedRequested

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

Wird ausgelöst, wenn eine einbettende App das Einbetten dieser App anfordert. Dieses Ereignis ist nur im Entwicklerkanal mit der Markierung „--enable-app-view“ verfügbar.

Parameter

onLaunched

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

Wird ausgelöst, wenn eine App über den Launcher gestartet wird

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (launchData?: LaunchData)=>void

onRestarted

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

Wird beim Chrome-Start für Apps ausgelöst, die beim letzten Herunterfahren von Chrome ausgeführt wurden, oder wenn Apps aus anderen Gründen aus ihrem vorherigen Status neu gestartet wurden, z.B. wenn der Nutzer den Zugriff auf die beibehaltenen Dateien einer App widerruft und die Laufzeit die App neu startet. Wenn Apps keinen onRestarted-Handler haben, wird in diesen Situationen stattdessen ein onLaunched-Ereignis gesendet.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    ()=>void