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 dell'evento e può arrestare l'app in qualsiasi momento.

Tipi

EmbedRequest

Proprietà

  • dati

    qualsiasi facoltativo

    Dati facoltativi specificati dallo sviluppatore che l'app da incorporare può utilizzare per prendere una decisione in merito all'incorporazione.

  • embedderId

    stringa

  • allow

    nullo

    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

    nullo

    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 file manifest.

  • isKioskSession

    booleano facoltativo

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

  • isPublicSession

    booleano facoltativo

    Chrome 47 e versioni successive

    Indica se l'app viene lanciata in una sessione pubblica di ChromeOS.

  • elementi

    LaunchItem[] facoltativo

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

  • referrerUrl

    stringa facoltativa

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

  • origine

    LaunchSource facoltativo

    Da dove viene lanciata l'app.

  • url

    stringa facoltativa

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

LaunchItem

Proprietà

  • voce

    Voce

    Voce per l'articolo.

  • tipo

    stringa facoltativa

    Il tipo MIME del file.

LaunchSource

Enumerazione delle origini di avvio dell'app. Questo valore deve essere mantenuto in sincronia con AppLaunchSource in components/services/app_service/public/mojom/types.mojom e 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,
)

Viene attivato quando un'app di incorporamento richiede di incorporare questa app. Questo evento è disponibile solo sul canale di sviluppo 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,
)

Viene attivato quando un'app viene lanciata dal programma di avvio.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (launchData?: LaunchData) => void

onRestarted

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

Viene attivato all'avvio di Chrome per le app in esecuzione al momento dell'ultimo arresto di Chrome o quando è stato richiesto di riavviare le app dal loro stato precedente per altri motivi (ad esempio, quando l'utente revoca l'accesso ai file trattenuti di un'app, il runtime riavvia l'app). In queste situazioni, se le app non hanno un gestore onRestarted, verrà inviato un evento onLaunched.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void