chrome.app.runtime

Beschrijving

Gebruik de chrome.app.runtime API om de levenscyclus van de app te beheren. De app-runtime beheert de app-installatie, beheert de gebeurtenispagina en kan de app op elk gewenst moment afsluiten.

Soorten

ActionData

Chroom 54+

Eigenschappen

  • actietype

    "nieuwe_noot"

ActionType

Chroom 54+

Een app kan worden gestart met een specifieke actie in gedachten, bijvoorbeeld om een ​​nieuwe notitie te maken. Het type actie waarmee de app is gestart, is beschikbaar in het actionData veld van de LaunchData-instantie.

Waarde

"nieuwe_noot"

EmbedRequest

Eigenschappen

  • gegevens

    eventueel optioneel

    Optionele door de ontwikkelaar opgegeven gegevens die de in te sluiten app kan gebruiken bij het nemen van een insluitingsbeslissing.

  • embedderId

    snaar

  • toestaan

    leegte

    Hiermee kan embedderId deze app insluiten in een <appview>-element. De url specificeert de inhoud die moet worden ingesloten.

    De allow functie ziet er als volgt uit: 

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

    • URL

      snaar

  • ontkennen

    leegte

    Voorkomt dat embedderId deze app in een <appview>-element insluit.

    De deny functie ziet er als volgt uit: 

    () => {...}

LaunchData

Eigenschappen

  • actiegegevens

    ActionData optioneel

    Chroom 54+

    Bevat gegevens die het ActionType specificeren waarmee deze app is gestart. Dit is nul als de app niet is gestart met een specifieke actie-intentie.

  • Identiteitskaart

    tekenreeks optioneel

    De ID van het bestand of de URL-handler waarmee de app wordt aangeroepen. Handler-ID's zijn de sleutels op het hoogste niveau in de woordenboeken file_handlers en/of url_handlers in het manifest.

  • isKioskSessie

    Booleaans optioneel

    Of de app wordt gestart in een Chrome OS-kiosksessie .

  • isPublicSession

    Booleaans optioneel

    Chroom 47+

    Of de app wordt gestart in een openbare Chrome OS-sessie .

  • artikelen

    LaunchItem [] optioneel

    De bestandsvermeldingen voor de onLaunched gebeurtenis die wordt geactiveerd door een overeenkomende bestandshandler in de manifestsleutel file_handlers .

  • referrerUrl

    tekenreeks optioneel

    De verwijzende URL voor de onLaunched gebeurtenis die wordt geactiveerd door een overeenkomende URL-handler in de manifestsleutel url_handlers .

  • bron

    LaunchSource optioneel

    Waar de app wordt gestart.

  • URL

    tekenreeks optioneel

    De URL voor de onLaunched gebeurtenis die wordt geactiveerd door een overeenkomende URL-handler in de manifestsleutel url_handlers .

LaunchItem

Eigenschappen

  • binnenkomst

    Binnenkomst

    Invoer voor het artikel.

  • type

    tekenreeks optioneel

    Het MIME-type van het bestand.

LaunchSource

Opsomming van bronnen voor het starten van apps. Dit moet gesynchroniseerd worden gehouden met AppLaunchSource in componenten/services/app_service/public/mojom/types.mojom, en GetLaunchSourceEnum() in extensions/browser/api/app_runtime/app_runtime_api.cc. Let op: de opsomming wordt gebruikt in het UMA-histogram, dus vermeldingen mogen niet opnieuw worden geordend of verwijderd.

Enum

"niet gevolgd"

"app_launcher"

"nieuwe_tab_pagina"

"herladen"

"opnieuw opstarten"

"laden_en_lanceren"

"opdrachtregel"

"bestand_handler"

"url_handler"

"systeem_tray"

"over_pagina"

"toetsenbord"

"extensies_pagina"

"management_api"

"efemere_app"

"achtergrond"

"kiosk"

"chrome_intern"

"test"

"geïnstalleerde_melding"

"contextmenu"

"boog"

"intent_url"

"app_home_pagina"

"focus_modus"

"sprankelend"

Evenementen

onEmbedRequested

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

Wordt geactiveerd wanneer een insluitende app vraagt ​​om deze app in te sluiten. Dit evenement is alleen beschikbaar op het ontwikkelaarskanaal met de vlag --enable-app-view.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (request: EmbedRequest) => void

onLaunched

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

Wordt geactiveerd wanneer een app wordt gestart vanuit het opstartprogramma.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (launchData?: LaunchData) => void

onRestarted

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

Wordt geactiveerd bij het opstarten van Chrome voor apps die actief waren toen Chrome voor het laatst werd afgesloten, of wanneer apps om andere redenen zijn gevraagd opnieuw op te starten vanuit hun vorige status (bijvoorbeeld wanneer de gebruiker de toegang tot de bewaarde bestanden van een app intrekt, wordt de app tijdens de runtime opnieuw opgestart). Als apps in deze situaties geen onRestarted handler hebben, ontvangen ze in plaats daarvan een onLaunched gebeurtenis.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    () => void