chrome.app.runtime

Açıklama

Uygulama yaşam döngüsünü yönetmek için chrome.app.runtime API'yi kullanın. Uygulama çalışma zamanı, uygulama yüklemeyi yönetir, etkinlik sayfasını kontrol eder ve uygulamayı herhangi bir zamanda kapatabilir.

Türler

ActionData

Chrome 54 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • actionType

ActionType

Chrome 54 ve sonraki sürümler

Bir uygulama, belirli bir işlem (ör. yeni bir not oluşturmak için) düşünülerek başlatılabilir. Uygulamanın başlatıldığı işlem türü, LaunchData örneğindeki actionData alanında bulunur.

Değer

EmbedRequest

Özellikler

  • veri

    isteğe bağlı herhangi bir

    İsteğe bağlı geliştirici, yerleştirilecek uygulamanın yerleştirme kararı alırken kullanabileceği verileri belirtti.

  • embedderId

    dize

  • izin ver

    geçersiz

    embedderId'ün bu uygulamayı bir <appview> öğesine yerleştirmesine izin verir. url, yerleştirilecek içeriği belirtir.

    allow işlevi şu şekilde görünür: 

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

    • url

      dize

  • deny

    geçersiz

    embedderId uygulamasının bu uygulamayı bir <appview> içine yerleştirmesini engeller öğesine dokunun.

    deny işlevi aşağıdaki gibi görünür: 

    () => {...}

LaunchData

Özellikler

  • actionData

    ActionData isteğe bağlı

    Chrome 54 ve sonraki sürümler 'nı inceleyin.

    Bu uygulamanın başlatıldığı ActionType değerini belirten verileri içerir. Uygulama belirli bir işlem amacıyla başlatılmamışsa bu değer boştur.

  • id

    dize isteğe bağlı

    Uygulamanın çağrıldığı dosya veya URL işleyicisinin kimliği. İşleyici kimlikleri, manifest'teki file_handlers ve/veya url_handlers sözlüklerindeki üst düzey anahtarlardır.

  • isKioskSession

    boole isteğe bağlı

    Uygulamanın Chrome OS kiosk oturumunda başlatılıp başlatılmadığını belirtir.

  • isPublicSession

    boole isteğe bağlı

    Chrome 47 ve sonraki sürümler 'nı inceleyin.

    Uygulamanın Chrome OS herkese açık oturumda kullanıma sunulup sunulmadığı.

  • items

    LaunchItem[] isteğe bağlı

    file_handlers manifest anahtarında eşleşen bir dosya işleyici tarafından tetiklenen onLaunched etkinliği için dosya girişleri.

  • referrerUrl

    dize isteğe bağlı

    url_handlers manifest anahtarında eşleşen bir URL işleyici tarafından tetiklenen onLaunched etkinliği için yönlendiren URL.

  • source

    LaunchSource isteğe bağlı

    Uygulamanın kullanıma sunulduğu yer.

  • url

    dize isteğe bağlı

    url_handlers manifest anahtarında eşleşen bir URL işleyici tarafından tetiklenen onLaunched etkinliğinin URL'si.

LaunchItem

Özellikler

  • giriş

    Giriş

    Öğe girişi.

  • tür

    dize isteğe bağlı

    Dosyanın MIME türü.

LaunchSource

Uygulama başlatma kaynaklarının listesi. Bu, components/services/app_service/public/mojom/types.mojom içindeki AppLaunchSource ve extensions/browser/api/app_runtime/app_runtime_api.cc içindeki GetLaunchSourceEnum() ile senkronize tutulmalıdır. UMA histogramında numaralandırmanın kullanıldığını, bu nedenle girişlerin yeniden sıralanmaması veya kaldırılmaması gerektiğini unutmayın.

Enum

"untracked"

"app_launcher"

"restart"

"command_line"

"file_handler"

"url_handler"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"test"

"installed_notification"

"arc"

"focus_mode"

"sparky"

Etkinlikler

onEmbedRequested

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

Bir yerleştirme uygulaması bu uygulamayı yerleştirmeyi istediğinde tetiklenir. Bu etkinlik yalnızca --enable-app-view işaretiyle birlikte geliştirme kanalında kullanılabilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (request: EmbedRequest) => void

onLaunched

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

Başlatıcıdan bir uygulama başlatıldığında tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (launchData?: LaunchData) => void

onRestarted

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

Chrome başlatılırken Chrome son kapatıldığında çalışan uygulamalar için tetiklenir veya uygulamaların başka nedenlerle (ör. kullanıcı bir uygulamanın saklanan dosyalarına erişimi iptal ettiğinde) önceki durumundan yeniden başlatılması istendiğinde çalışma zamanı uygulamayı yeniden başlatır. Bu durumlarda, uygulamalarda onRestarted işleyici yoksa bunun yerine onLaunched etkinliği gönderilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    () => void