chrome.management

Mô tả

API chrome.management cung cấp các cách để quản lý ứng dụng và tiện ích đã cài đặt.

Quyền

management

Bạn phải khai báo quyền "quản lý" trong tệp kê khai tiện ích để sử dụng API quản lý. Ví dụ:

{   "name": "My extension",   ...   "permissions": [     "management"   ],   ... }

management.getPermissionWarningsByManifest(), management.uninstallSelf() và management.getSelf() không yêu cầu quyền quản lý.

Loại

ExtensionDisabledReason

Chrome 44 trở lên

Lý do khiến mặt hàng bị vô hiệu hoá.

Enum

"unknown"

"permissions_increase"

ExtensionInfo

Thông tin về một tiện ích, ứng dụng hoặc giao diện đã cài đặt.

Thuộc tính

  • appLaunchUrl

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

    URL khởi chạy (chỉ có trong ứng dụng).

  • availableLaunchTypes

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

    Các loại lượt khởi chạy hiện có (chỉ có đối với ứng dụng).

  • mô tả

    chuỗi

    Nội dung mô tả về tiện ích, ứng dụng hoặc giao diện này.

  • disabledReason

    ExtensionDisabledReason không bắt buộc

    Lý do khiến mặt hàng bị vô hiệu hoá.

  • đang bật

    boolean

    Trạng thái hiện tại của tính năng này là bật hay tắt.

  • homepageUrl

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

    URL trang chủ của tiện ích, ứng dụng hoặc giao diện này.

  • hostPermissions

    string[]

    Trả về danh sách các quyền dựa trên máy chủ lưu trữ.

  • biểu tượng

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

    Danh sách thông tin về biểu tượng. Xin lưu ý rằng điều này chỉ phản ánh những gì đã được khai báo trong tệp kê khai và hình ảnh thực tế tại URL đó có thể lớn hơn hoặc nhỏ hơn những gì đã được khai báo. Vì vậy, bạn có thể cân nhắc sử dụng các thuộc tính chiều rộng và chiều cao rõ ràng trên thẻ img tham chiếu đến những hình ảnh này. Hãy xem tài liệu về tệp kê khai liên quan đến biểu tượng để biết thêm thông tin chi tiết.

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của tiện ích.

  • installType

    ExtensionInstallType

    Cách cài đặt tiện ích.

  • isApp

    boolean

    Không dùng nữa

    Vui lòng sử dụng management.ExtensionInfo.type.

    True nếu đây là một ứng dụng.

  • launchType

    LaunchType không bắt buộc

    Loại hình khởi chạy ứng dụng (chỉ có trong ứng dụng).

  • mayDisable

    boolean

    Người dùng có thể tắt hoặc gỡ cài đặt tiện ích này hay không.

  • mayEnable

    boolean không bắt buộc

    Chrome 62 trở lên

    Người dùng có thể bật tiện ích này hay không. Tham số này chỉ được trả về cho những tiện ích chưa được bật.

  • tên

    chuỗi

    Tên của tiện ích, ứng dụng hoặc giao diện này.

  • offlineEnabled

    boolean

    Cho dù tiện ích, ứng dụng hoặc giao diện đó có khai báo rằng chúng hỗ trợ chế độ ngoại tuyến hay không.

  • optionsUrl

    chuỗi

    URL của trang lựa chọn của mặt hàng (nếu có).

  • quyền

    string[]

    Trả về danh sách các quyền dựa trên API.

  • shortName

    chuỗi

    Phiên bản tên ngắn của tiện ích, ứng dụng hoặc giao diện này.

  • loại

    ExtensionType

    Loại tiện ích, ứng dụng hoặc giao diện này.

  • updateUrl

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

    URL cập nhật của tiện ích, ứng dụng hoặc giao diện này.

  • version

    chuỗi

    Phiên bản của tiện ích, ứng dụng hoặc giao diện này.

  • versionName

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

    Chrome 50 trở lên

    Tên phiên bản của tiện ích, ứng dụng hoặc giao diện này nếu tệp kê khai chỉ định một tên.

ExtensionInstallType

Chrome 44 trở lên

Cách cài đặt tiện ích. Một trong các giá trị sau admin: Tiện ích được cài đặt do chính sách quản trị, development: Tiện ích được tải ở chế độ nhà phát triển, normal: Tiện ích được cài đặt theo cách thông thường thông qua tệp .crx, sideload: Tiện ích được cài đặt bằng phần mềm khác trên máy, other: Tiện ích được cài đặt bằng các phương tiện khác.

Enum

"admin"

"development"

"normal"

"cài đặt từ bên ngoài"

"other"

ExtensionType

Chrome 44 trở lên

Loại tiện ích, ứng dụng hoặc giao diện này.

Enum

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

Thông tin về một biểu tượng thuộc một tiện ích, ứng dụng hoặc giao diện.

Thuộc tính

  • size

    số

    Một số thể hiện chiều rộng và chiều cao của biểu tượng. Các giá trị có thể có bao gồm (nhưng không giới hạn ở) 128, 48, 24 và 16.

  • url

    chuỗi

    URL của hình ảnh biểu tượng này. Để hiển thị phiên bản thang màu xám của biểu tượng (ví dụ: để cho biết rằng một tiện ích bị vô hiệu hoá), hãy thêm ?grayscale=true vào URL.

LaunchType

Đây là tất cả các loại hình khởi chạy ứng dụng có thể có.

Enum

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 trở lên

Các lựa chọn về cách xử lý việc gỡ cài đặt tiện ích.

Thuộc tính

  • showConfirmDialog

    boolean không bắt buộc

    Có nên nhắc người dùng bằng hộp thoại xác nhận gỡ cài đặt hay không. Mặc định là false đối với các hoạt động tự gỡ cài đặt. Nếu một tiện ích gỡ cài đặt một tiện ích khác, thì tham số này sẽ bị bỏ qua và hộp thoại luôn xuất hiện.

Phương thức

createAppShortcut()

chrome.management.createAppShortcut(
  id: string,
): Promise<void>

Hiện các lựa chọn để tạo lối tắt cho một ứng dụng. Trên máy Mac, bạn chỉ có thể tạo lối tắt cho ứng dụng đóng gói.

Thông số

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên 
chrome.management.generateAppForLink(
  url: string,
  title: string,
): Promise<ExtensionInfo>

Tạo một ứng dụng cho một URL. Trả về ứng dụng đánh dấu trang đã tạo.

Thông số

  • url

    chuỗi

    URL của một trang web. Lược đồ của URL chỉ có thể là "http" hoặc "https".

  • tiêu đề

    chuỗi

    Tiêu đề của ứng dụng được tạo.

Giá trị trả về

get()

chrome.management.get(
  id: string,
): Promise<ExtensionInfo>

Trả về thông tin về tiện ích, ứng dụng hoặc giao diện đã cài đặt có mã nhận dạng nhất định.

Thông số

Giá trị trả về

getAll()

chrome.management.getAll(): Promise<ExtensionInfo[]>

Trả về danh sách thông tin về các tiện ích và ứng dụng đã cài đặt.

Giá trị trả về

getPermissionWarningsById()

chrome.management.getPermissionWarningsById(
  id: string,
): Promise<string[]>

Trả về danh sách cảnh báo về quyền cho mã nhận dạng tiện ích đã cho.

Thông số

  • id

    chuỗi

    Mã nhận dạng của một tiện ích đã được cài đặt.

Giá trị trả về

  • Promise<string[]>

    Chrome 88 trở lên

getPermissionWarningsByManifest()

chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
): Promise<string[]>

Trả về danh sách cảnh báo về quyền cho chuỗi tệp kê khai tiện ích đã cho. Lưu ý: Bạn có thể dùng hàm này mà không cần yêu cầu quyền "quản lý" trong tệp kê khai.

Thông số

  • manifestStr

    chuỗi

    Chuỗi JSON tệp kê khai tiện ích.

Giá trị trả về

  • Promise<string[]>

    Chrome 88 trở lên

getSelf()

chrome.management.getSelf(): Promise<ExtensionInfo>

Trả về thông tin về tiện ích, ứng dụng hoặc giao diện gọi. Lưu ý: Bạn có thể dùng hàm này mà không cần yêu cầu quyền "quản lý" trong tệp kê khai.

Giá trị trả về

installReplacementWebApp()

Chrome 77 trở lên 
chrome.management.installReplacementWebApp(): Promise<void>

Khởi chạy replacement_web_app được chỉ định trong tệp kê khai. Nhắc người dùng cài đặt nếu họ chưa cài đặt.

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

launchApp()

chrome.management.launchApp(
  id: string,
): Promise<void>

Khởi chạy một ứng dụng.

Thông số

  • id

    chuỗi

    Mã nhận dạng phần mở rộng của ứng dụng.

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

setEnabled()

chrome.management.setEnabled(
  id: string,
  enabled: boolean,
): Promise<void>

Bật hoặc tắt một ứng dụng hoặc tiện ích. Trong hầu hết các trường hợp, hàm này phải được gọi trong bối cảnh cử chỉ của người dùng (ví dụ: trình xử lý onclick cho một nút) và có thể hiển thị cho người dùng giao diện người dùng xác nhận gốc để ngăn chặn hành vi sai trái.

Thông số

  • id

    chuỗi

    Đây phải là mã nhận dạng của một mặt hàng thuộc management.ExtensionInfo.

  • đang bật

    boolean

    Liệu bạn có nên bật hay tắt mục này.

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

setLaunchType()

chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
): Promise<void>

Đặt loại hình khởi chạy của một ứng dụng.

Thông số

  • id

    chuỗi

    Đây phải là mã nhận dạng của một mục ứng dụng thuộc management.ExtensionInfo.

  • launchType

    LaunchType

    Loại mục tiêu triển khai. Luôn kiểm tra và đảm bảo loại hoạt động khởi chạy này nằm trong ExtensionInfo.availableLaunchTypes, vì các loại hoạt động khởi chạy có sẵn sẽ khác nhau trên các nền tảng và cấu hình khác nhau.

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

uninstall()

chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
): Promise<void>

Gỡ cài đặt một ứng dụng hoặc tiện ích hiện đang được cài đặt. Lưu ý: Hàm này không hoạt động trong môi trường được quản lý khi người dùng không được phép gỡ cài đặt tiện ích/ứng dụng đã chỉ định. Nếu quá trình gỡ cài đặt không thành công (ví dụ: người dùng huỷ hộp thoại), thì lời hứa sẽ bị từ chối hoặc lệnh gọi lại sẽ được gọi với runtime.lastError được đặt.

Thông số

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

uninstallSelf()

chrome.management.uninstallSelf(
  options?: UninstallOptions,
): Promise<void>

Gỡ cài đặt tiện ích gọi. Lưu ý: Bạn có thể dùng hàm này mà không cần yêu cầu quyền "quản lý" trong tệp kê khai. Chức năng này không hoạt động trong môi trường được quản lý khi người dùng không được phép gỡ cài đặt tiện ích/ứng dụng đã chỉ định.

Thông số

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

Sự kiện

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

Được kích hoạt khi một ứng dụng hoặc tiện ích bị vô hiệu hoá.

Thông số

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

Được kích hoạt khi một ứng dụng hoặc tiện ích đã được bật.

Thông số

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

Được kích hoạt khi một ứng dụng hoặc tiện ích đã được cài đặt.

Thông số

onUninstalled

chrome.management.onUninstalled.addListener(
  callback: function,
)

Được kích hoạt khi một ứng dụng hoặc tiện ích bị gỡ cài đặt.

Thông số

  • callback

    hàm

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

    (id: string) => void

    • id

      chuỗi