chrome.app.runtime

Mô tả

Sử dụng API chrome.app.runtime để quản lý vòng đời của ứng dụng. Thời gian chạy ứng dụng quản lý việc cài đặt ứng dụng, kiểm soát trang sự kiện và có thể tắt ứng dụng bất cứ lúc nào.

Loại

EmbedRequest

Thuộc tính

  • dữ liệu

    bất kỳ không bắt buộc nào

    Dữ liệu do nhà phát triển chỉ định (không bắt buộc) mà ứng dụng được nhúng có thể sử dụng khi đưa ra quyết định nhúng.

  • embedderId

    chuỗi

  • allow

    void

    Cho phép embedderId nhúng ứng dụng này vào phần tử <appview>. url chỉ định nội dung cần nhúng.

    Hàm allow có dạng như sau: 

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

    • url

      chuỗi

  • từ chối

    void

    Ngăn embedderId nhúng ứng dụng này vào phần tử <appview>.

    Hàm deny có dạng như sau: 

    () => {...}

LaunchData

Thuộc tính

  • id

    chuỗi không bắt buộc

    Mã của trình xử lý tệp hoặc URL mà ứng dụng đang được gọi. Mã nhận dạng trình xử lý là các khoá cấp cao nhất trong từ điển file_handlers và/hoặc url_handlers trong tệp kê khai.

  • isKioskSession

    boolean không bắt buộc

    Liệu ứng dụng có đang được khởi chạy trong một phiên kiosk Chrome OS hay không.

  • isPublicSession

    boolean không bắt buộc

    Chrome 47 trở lên

    Liệu ứng dụng có đang được khởi chạy trong một phiên công khai trên Chrome OS hay không.

  • mục

    LaunchItem[] không bắt buộc

    Các mục nhập tệp cho sự kiện onLaunched do trình xử lý tệp trùng khớp kích hoạt trong khoá tệp kê khai file_handlers.

  • referrerUrl

    chuỗi không bắt buộc

    URL của trình giới thiệu cho sự kiện onLaunched do trình xử lý URL phù hợp kích hoạt trong khoá tệp kê khai url_handlers.

  • nguồn

    LaunchSource không bắt buộc

    Vị trí khởi chạy ứng dụng.

  • url

    chuỗi không bắt buộc

    URL cho sự kiện onLaunched do trình xử lý URL trùng khớp kích hoạt trong khoá tệp kê khai url_handlers.

LaunchItem

Thuộc tính

  • mục nhập

    Mục nhập

    Mục nhập cho mặt hàng.

  • loại

    chuỗi không bắt buộc

    Loại MIME của tệp.

LaunchSource

Liệt kê các nguồn khởi chạy ứng dụng. Bạn phải đồng bộ hoá giá trị này với AppLaunchSource trong components/services/app_service/public/mojom/types.mojom và GetLaunchSourceEnum() trong extensions/browser/api/app_runtime/app_runtime_api.cc. Xin lưu ý rằng việc liệt kê được sử dụng trong biểu đồ UMA, vì vậy, bạn không nên sắp xếp lại hoặc xoá các mục nhập.

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"

Sự kiện

onEmbedRequested

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

Được kích hoạt khi một ứng dụng nhúng yêu cầu nhúng ứng dụng này. Sự kiện này chỉ có trên kênh dành cho nhà phát triển có cờ --enable-app-view.

Thông số

onLaunched

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

Được kích hoạt khi một ứng dụng được khởi chạy từ trình chạy.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (launchData?: LaunchData) => void

onRestarted

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

Được kích hoạt khi khởi động Chrome cho các ứng dụng đang chạy khi Chrome tắt lần gần nhất hoặc khi các ứng dụng được yêu cầu khởi động lại từ trạng thái trước đó vì các lý do khác (ví dụ: khi người dùng thu hồi quyền truy cập vào các tệp được giữ lại của ứng dụng, thời gian chạy sẽ khởi động lại ứng dụng). Trong những trường hợp này, nếu không có trình xử lý onRestarted, ứng dụng sẽ được gửi một sự kiện onLaunched.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    () => void