chrome.app.runtime

Nội dung mô tả

Sử dụng API chrome.app.runtime để quản lý vòng đời của ứng dụng. Môi trườ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

ActionData

Chrome 54 trở lên

Thuộc tính

  • actionType

    "new_note"

ActionType

Chrome 54 trở lên

Có thể khởi chạy ứng dụng khi có ý định thực hiện một hành động cụ thể, ví dụ: để tạo một ghi chú mới. Loại thao tác dùng để chạy ứng dụng có sẵn bên trong trường actionData của thực thể LaunchData.

Giá trị

"new_note"

EmbedRequest

Thuộc tính

  • data

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

    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 về việc nhúng.

  • embedderId

    string

  • allow

    void

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

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

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

    • url

      string

  • từ chối

    void

    Không cho embedderId nhúng ứng dụng này vào một phần tử <appview>.

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

    () => {...}

LaunchData

Thuộc tính

  • actionData

    ActionData không bắt buộc

    Chrome 54 trở lên

    Chứa dữ liệu chỉ định ActionType dùng để phát hành ứng dụng này. Giá trị này là rỗng nếu ứng dụng không được khởi chạy với một ý định hành động cụ thể.

  • id

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

    Mã của tệp hoặc trình xử lý URL mà ứng dụng đang được gọi. Mã 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 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 chạy trong một phiên công khai trên Chrome OS hay không.

  • items

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

    Các mục nhập tệp cho sự kiện onLaunched được kích hoạt bởi một trình xử lý tệp phù hợp trong khoá tệp kê khai file_handlers.

  • referrerUrl

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

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

  • nguồn

    LaunchSource không bắt buộc

    Nơi khởi chạy ứng dụng.

  • url

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

    URL cho sự kiện onLaunched do một trình xử lý URL phù hợp trong khoá tệp kê khai url_handlers kích hoạt.

LaunchItem

Thuộc tính

  • mục nhập

    Vé vào cửa

    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

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

Liệt kê

"app_launcher"

"new_tab_page"

"load_and_launch"

"command_line",

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"background"

"kiosk"

"chrome_internal"

"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 đang nhúng yêu cầu nhúng ứng dụng này. Sự kiện này chỉ có trên kênh 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 người dùng chạy một ứng dụng qua trình chạy.

Thông số

  • số gọi lại

    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 Chrome khởi động đối với các ứng dụng đang chạy khi Chrome tắt lần gần đây nhất hoặc khi ứng dụng được yêu cầu khởi động lại từ trạng thái trước đó vì 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 ứng dụng không có trình xử lý onRestarted, ứng dụng sẽ được gửi một sự kiện onLaunched.

Thông số

  • số gọi lại

    hàm

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

    () => void