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

ActionData

Chrome 54 e versioni successive

Proprietà

  • actionType

    "new_note"

ActionType

Chrome 54 e versioni successive

Un'app può essere lanciata pensando a un'azione specifica, ad esempio la creazione di una nuova nota. Il tipo di azione con cui è stata lanciata l'app è disponibile nel campo actionData dell'istanza LaunchData.

Valore

"new_note"

EmbedRequest

Proprietà

  • dati

    qualsiasi opzione facoltativa

    Lo sviluppatore facoltativo ha specificato dati che l'app da incorporare può utilizzare quando prende una decisione relativa all'incorporamento.

  • embedderId

    stringa

  • allow

    nullo

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

    La funzione allow ha questo 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à

  • actionData

    ActionData facoltativo

    Chrome 54 e versioni successive

    Contiene i dati che specificano il ActionType con cui è stata lanciata questa app. Questo valore è nullo se l'app non è stata avviata con un'intenzione di azione specifica.

  • id

    stringa facoltativo

    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 del referrer per l'evento onLaunched attivato da un gestore di URL corrispondente nella chiave manifest url_handlers.

  • origine

    LaunchSource facoltativo

    Da dove viene lanciata l'app.

  • url

    stringa facoltativo

    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. Dovrebbe essere mantenuto sincronizzato con AppLaunchSource in componente/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

"new_tab_page"

"restart"

"load_and_launch"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"test"

"installed_notification"

"intent_url"

"app_home_page"

"focus_mode"

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 viene avviata un'app 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 su app in esecuzione al momento dell'ultimo arresto di Chrome o quando è stato richiesto il riavvio delle app dallo stato precedente per altri motivi (ad esempio, se 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, verrà inviato un evento onLaunched.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void