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

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

    void

    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

    void

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

    La funzione deny ha questo 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 uno specifico intent di azione.

  • ID

    stringa facoltativo

    L'ID del file o del gestore di 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 avviata in una sessione pubblica di ChromeOS.

  • items

    LaunchItem[] facoltativo

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

  • referrerUrl

    stringa facoltativo

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

  • source

    LaunchSource facoltativo

    Punto di avvio dell'app.

  • url

    stringa facoltativo

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

LaunchItem

Proprietà

  • voce

    Voce

    Voce relativa all'elemento.

  • Tipo

    stringa facoltativo

    Il tipo MIME del file.

LaunchSource

Enumerazione delle origini di avvio delle app. Dovrebbe essere mantenuto sincronizzato con AppLaunchSource inComponent/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"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"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 soltanto sul canale Dev con il flag --enable-app-view.

Parametri

  • callback

    funzione

    Il parametro callback ha un aspetto simile al seguente: 

    (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 un aspetto simile al seguente: 

    (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 un aspetto simile al seguente: 

    () => void