chrome.management

Nội dung mô tả

API chrome.management cung cấp các cách quản lý danh sách tiện ích/ứng dụng đã cài đặt và đang chạy. Điều này đặc biệt hữu ích cho các tiện ích ghi đè trang Thẻ mới tích hợp sẵn.

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 mặt hàng bị vô hiệu hoá.

Liệt kê

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 chạy (chỉ hiển thị với ứng dụng).

  • availableLaunchTypes

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

    Các hình thức phát hành hiện có (chỉ áp dụng cho ứng dụng).

  • description

    string

    Mô tả của tiện ích, ứng dụng hoặc giao diện này.

  • disabledReason

    ExtensionDisabledReason không bắt buộc

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

  • đang bật

    boolean

    Xem trạng thái đang bật hay đang tắt.

  • homepageUrl

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

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

  • hostPermissions

    chuỗi[]

    Trả về danh sách quyền dựa trên máy chủ.

  • biểu tượng

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

    Danh sách thông tin về biểu tượng. 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 so với những gì đã 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 những hình ảnh này. Hãy xem tài liệu về tệp kê khai về biểu tượng để biết thêm thông tin chi tiết.

  • id

    string

    Giá trị nhận dạng duy nhấ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à ứng dụng.

  • launchType

    LaunchType không bắt buộc

    Kiểu khởi chạy ứng dụng (chỉ hiển thị với ứng dụng).

  • mayDisable

    boolean

    Liệu 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

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

  • tên

    string

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

  • offlineEnabled

    boolean

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

  • optionsUrl

    string

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

  • quyền

    chuỗi[]

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

  • shortName

    string

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

  • loại

    ExtensionType

    Loại của 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

    string

    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 tiện ích, ứng dụng hoặc giao diện này.

ExtensionInstallType

Chrome 44 trở lên

Cách cài đặt tiện ích. Một trong các admin: Tiện ích được cài đặt do chính sách quản trị, development: Tiện ích đã được giải nén ở chế độ nhà phát triển, normal: Tiện ích được cài đặt bình 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 phương thức khác.

Liệt kê

"sideload"

"other"

ExtensionType

Chrome 44 trở lên

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

Liệt kê

"packaged_app"

"legacy_packaged_app"

"login_screen_extension"

IconInfo

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

Thuộc tính

  • size

    number

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

  • url

    string

    URL cho 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 tiện ích đã bị tắt), hãy thêm ?grayscale=true vào URL.

LaunchType

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

Liệt kê

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 trở lên

Các tuỳ chọn về cách xử lý quá trình gỡ cài đặt tiện ích.

Thuộc tính

  • showConfirmDialog

    boolean không bắt buộc

    Hộp thoại xác nhận gỡ cài đặt có nhắc người dùng hay không. Giá trị mặc định là false khi tự gỡ cài đặt. Nếu một tiện ích gỡ cài đặt một tiện ích khác, tham số này sẽ bị bỏ qua và hộp thoại sẽ luôn hiển thị.

Phương thức

createAppShortcut()

Cam kết 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
)

Hiện các tuỳ 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 các lối tắt ứng dụng đóng gói.

Tham số

  • id

    string

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

  • số gọi lại

    hàm không bắt buộc

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

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

Cam kết 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
)

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

Tham số

  • url

    string

    URL của một trang web. Giao thức của URL chỉ có thể là "http" hoặc "https".

  • title

    string

    Tên của ứng dụng đã tạo.

  • số gọi lại

    hàm không bắt buộc

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

    (result: ExtensionInfo)=>void

Giá trị trả về

  • Promise<ExtensionInfo>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

get()

Cam kết 
chrome.management.get(
  id: string,
  callback?: function,
)

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 cụ thể.

Tham số

Giá trị trả về

  • Promise<ExtensionInfo>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

getAll()

Cam kết 
chrome.management.getAll(
  callback?: function,
)

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

Tham số

  • số gọi lại

    hàm không bắt buộc

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

    (result: ExtensionInfo[])=>void

Giá trị trả về

  • Promise<ExtensionInfo[]>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

getPermissionWarningsById()

Cam kết 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
)

Trả về danh sách cảnh báo quyền cho mã tiện ích nhất định.

Tham số

  • id

    string

    Mã của một tiện ích đã cài đặt.

  • số gọi lại

    hàm không bắt buộc

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

    (permissionWarnings: string[])=>void

    • permissionWarnings

      chuỗi[]

Giá trị trả về

  • Hứa hẹn<string[]>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

getPermissionWarningsByManifest()

Cam kết 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
)

Trả về danh sách cảnh báo quyền cho chuỗi tệp kê khai tiện ích đã cho. Lưu ý: Bạn có thể sử 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.

Tham số

  • manifestStr

    string

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

  • số gọi lại

    hàm không bắt buộc

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

    (permissionWarnings: string[])=>void

    • permissionWarnings

      chuỗi[]

Giá trị trả về

  • Hứa hẹn<string[]>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

getSelf()

Cam kết 
chrome.management.getSelf(
  callback?: function,
)

Trả về thông tin về tiện ích gọi, ứng dụng hoặc giao diện. Lưu ý: Bạn có thể sử 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.

Tham số

  • số gọi lại

    hàm không bắt buộc

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

    (result: ExtensionInfo)=>void

Giá trị trả về

  • Promise<ExtensionInfo>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

installReplacementWebApp()

Cam kết Chrome 77 trở lên 
chrome.management.installReplacementWebApp(
  callback?: function,
)

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

Tham số

  • số gọi lại

    hàm không bắt buộc

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

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

launchApp()

Cam kết 
chrome.management.launchApp(
  id: string,
  callback?: function,
)

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

Tham số

  • id

    string

    Mã tiện ích của ứng dụng.

  • số gọi lại

    hàm không bắt buộc

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

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setEnabled()

Cam kết 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
)

Bật hoặc tắ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 ngữ cảnh cử chỉ của người dùng (ví dụ: trình xử lý nhấp 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 như một cách ngăn chặn hành vi lạm dụng.

Tham số

  • id

    string

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

  • đang bật

    boolean

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

  • số gọi lại

    hàm không bắt buộc

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

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setLaunchType()

Cam kết 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
)

Đặt kiểu khởi chạy một ứng dụng.

Tham số

  • id

    string

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

  • launchType

    LaunchType

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

  • số gọi lại

    hàm không bắt buộc

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

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

uninstall()

Cam kết 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
)

Gỡ cài đặt ứng dụng hoặc tiện ích hiện đã 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 gỡ cài đặt không thành công (ví dụ: người dùng huỷ hộp thoại), 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 đã đặt.

Tham số

  • id

    string

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

  • tùy chọn

    UninstallOptions không bắt buộc

  • số gọi lại

    hàm không bắt buộc

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

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

uninstallSelf()

Cam kết 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
)

Gỡ cài đặt tiện ích gọi điện. Lưu ý: Bạn có thể sử 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.

Tham số

  • tùy chọn

    UninstallOptions không bắt buộc

  • số gọi lại

    hàm không bắt buộc

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

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

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ị tắt.

Tham 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.

Tham 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.

Tham số

onUninstalled

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

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

Tham số

  • số gọi lại

    hàm

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

    (id: string)=>void

    • id

      string