chrome.app.runtime

Descrizione

Usa l'API chrome.app.runtime per gestire il ciclo di vita dell'app. Il runtime app gestisce l'installazione delle 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 avviata pensando a un'azione specifica, ad esempio per creare una nuova nota. Il tipo di azione con cui è stata avviata l'app è disponibile nel campo actionData dell'istanza LaunchData.

Valore

"new_note"

EmbedRequest

Proprietà

  • data

    qualsiasi facoltativo

    Uno sviluppatore facoltativo ha specificato dei dati che l'app da incorporare può utilizzare al momento di prendere una decisione di 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 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à

  • actionData

    Facoltativo ActionData

    Chrome 54 e versioni successive

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

  • 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

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

  • isPublicSession

    booleano facoltativo

    Chrome 47 e versioni successive

    Indica se l'app viene avviata durante una sessione pubblica di ChromeOS.

  • items

    LaunchItem[] facoltativo

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

  • referrerUrl

    stringa facoltativo

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

  • origine

    (Facoltativo) LaunchSource

    Da dove viene avviata l'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 dell'articolo.

  • Tipo

    stringa facoltativo

    Il tipo MIME del file.

LaunchSource

Enumerazione delle origini di avvio delle app. Questo deve essere sincronizzato con AppLaunchSource nei componenti/services/app_service/public/mojom/types.mojom e con 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

"load_and_launch"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"kiosk"

"chrome_internal"

"test"

"context_menu"

"arc"

"intent_url"

Eventi

onEmbedRequested

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

Viene 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

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 che erano in esecuzione all'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 riavvia l'app). In queste situazioni, se le app non hanno un gestore onRestarted, riceverà un evento onLaunched.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    ()=>void