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 moment afsluiten.

Typen

EmbedRequest

Eigenschappen

  • gegevens

    alleen optioneel

    Optionele door de ontwikkelaar gespecificeerde gegevens die de in te sluiten app kan gebruiken bij het nemen van een beslissing over insluiten.

  • embedderId

    tekenreeks

  • toestaan

    ongeldig

    Hiermee kan embedderId deze app insluiten in een <appview>-element. De url geeft aan welke content moet worden ingesloten.

    De functie allow ziet er zo uit: 

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

    • url

      tekenreeks

  • deny

    ongeldig

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

    De functie deny ziet er zo uit: 

    () => {...}

LaunchData

Eigenschappen

  • id

    tekenreeks optioneel

    De ID van de bestands- of 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.

  • isKioskSession

    booleaans optioneel

    Of de app wordt gestart in een ChromeOS-kiosksessie.

  • isPublicSession

    booleaans optioneel

    Chrome 47+

    Of de app wordt gestart in een openbare ChromeOS-sessie.

  • items

    LaunchItem[] optioneel

    De bestandsitems voor de gebeurtenis onLaunched die is geactiveerd door een overeenkomende bestandshandler in de manifestsleutel file_handlers.

  • referrerUrl

    tekenreeks optioneel

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

  • source

    LaunchSource optioneel

    Waar de app wordt gestart.

  • url

    tekenreeks optioneel

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

LaunchItem

Eigenschappen

  • vermelding

    Toegang

    Invoer voor het item.

  • type

    tekenreeks optioneel

    Het MIME-type van het bestand.

LaunchSource

Opsomming van bronnen voor app-lancering. Dit moet worden gesynchroniseerd met AppLaunchSource in components/services/app_service/public/mojom/types.mojom en GetLaunchSourceEnum() in extensions/browser/api/app_runtime/app_runtime_api.cc. De opsomming wordt gebruikt in het UMA-histogram, dus de items mogen niet opnieuw worden geordend of verwijderd.

Enum

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

Evenementen

onEmbedRequested

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

Wordt geactiveerd wanneer een insluitende app een verzoek indient om deze app in te sluiten. Deze gebeurtenis is alleen beschikbaar op het Dev-kanaal met de markering --enable-app-view.

Parameters

onLaunched

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

Wordt geactiveerd als een app wordt gestart vanuit de Launcher.

Parameters

  • callback

    functie

    De parameter callback ziet er zo 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 de vorige status (bijvoorbeeld wanneer de gebruiker de toegang tot de bewaarde bestanden van een app intrekt, start de runtime de app opnieuw op). In deze situaties krijgen apps zonder onRestarted-handler een onLaunched-gebeurtenis.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    () => void