chrome.app.runtime

Descrizione

Utilizza l'API chrome.app.runtime per gestire il ciclo di vita dell'app. Il runtime dell'app gestisce l'installazione dell'app, controlla la pagina degli eventi e può arrestare l'app in qualsiasi momento.

Tipi

EmbedRequest

Proprietà

  • dati

    any optional

    Dati facoltativi specificati dallo sviluppatore che l'app da incorporare può utilizzare per prendere una decisione sull'incorporamento.

  • embedderId

    stringa

  • allow

    void

    Consente a embedderId di incorporare questa app in un elemento <appview>. url specifica i contenuti da incorporare.

    La funzione allow ha il seguente aspetto: 

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

    • url

      stringa

  • deny

    void

    Impedisce a embedderId di incorporare questa app in un elemento <appview>.

    La funzione deny ha il seguente aspetto: 

    () => {...}

LaunchData

Proprietà

  • id

    stringa facoltativa

    L'ID del gestore di file o URL con cui viene richiamata l'app. Gli ID gestore sono le chiavi di primo livello nei dizionari file_handlers e/o url_handlers nel manifest.

  • isKioskSession

    boolean facoltativo

    Se l'app viene avviata in una sessione kiosk di ChromeOS.

  • isPublicSession

    boolean facoltativo

    Chrome 47 e versioni successive

    Se l'app viene avviata in una sessione pubblica di ChromeOS.

  • elementi

    LaunchItem[] facoltativo

    Le voci del file per l'evento onLaunched attivato da un gestore di file corrispondente nella chiave manifest file_handlers.

  • referrerUrl

    stringa facoltativa

    L'URL referrer per l'evento onLaunched attivato da un gestore di URL corrispondente nella chiave manifest url_handlers.

  • origine

    LaunchSource facoltativo

    Da dove viene avviata l'app.

  • url

    stringa facoltativa

    L'URL dell'evento onLaunched attivato da un gestore di URL corrispondente nella chiave manifest url_handlers.

LaunchItem

Proprietà

  • entry

    Voce

    Voce per l'elemento.

  • tipo

    stringa facoltativa

    Il tipo MIME del file.

LaunchSource

Enumerazione delle origini di avvio delle app. This should be kept in sync with AppLaunchSource in components/services/app_service/public/mojom/types.mojom, and GetLaunchSourceEnum() in extensions/browser/api/app_runtime/app_runtime_api.cc. Tieni presente che l'enumerazione viene utilizzata nell'istogramma UMA, pertanto le voci non devono essere riordinate o rimosse.

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"

Eventi

onEmbedRequested

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

Attivato quando un'app di incorporamento richiede di incorporare questa app. Questo evento è disponibile solo sul canale Dev con il flag --enable-app-view.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (request: EmbedRequest) => void

onLaunched

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

Attivato quando un'app viene avviata da Avvio app.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (launchData?: LaunchData) => void

onRestarted

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

Attivato all'avvio di Chrome per le app in esecuzione all'ultimo arresto di Chrome o quando è stato richiesto il riavvio delle app dallo stato precedente per altri motivi (ad es. quando l'utente revoca l'accesso ai file conservati di un'app, il runtime riavvierà l'app). In queste situazioni, se le app non hanno un gestore onRestarted, riceveranno un evento onLaunched.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void