chrome.management

refresh date: 2026-09-25 robots: noindex

Mô tả

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

Quyền

management

Tệp kê khai

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ục bị vô hiệu hoá.

Enum

"unknown"

"permissions_increase"

ExtensionInfo

Thông tin về 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ó cho ứng dụng).

  • availableLaunchTypes

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

    Các loại khởi chạy hiện có (chỉ dành cho ứ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ục bị vô hiệu hoá.

  • đang bật

    boolean

    Trạng thái hiện tại là bật hay 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

    string[]

    Trả về danh sách các 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. 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 so với những gì được khai báo. Vì vậy, bạn nên 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 trê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ó cho ứ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

    Người dùng có thể bật tiện ích này hay không. Thông tin 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

    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

    chuỗi

    URL của trang tuỳ chọn của mục, nếu có.

  • quyền

    string[]

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

  • shortName

    chuỗi

    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.

  • phiên bản

    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 có chỉ định tên phiên bả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 theo chính sách quản trị, development: Tiện ích được tải ở dạng chưa đóng gói trong chế độ nhà phát triển, normal: Tiện ích được cài đặt bình 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 phương thức khác.

Enum

"admin"

"development"

"normal"

"cài đặt không qua cửa hàng ứng dụng"

"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ề 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ố đạ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

    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ị tắt), 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ó nhắc người dùng bằng hộp thoại xác nhận gỡ cài đặt hay không. Giá trị mặc định là false đối với trường hợp 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()

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

Hiển thị 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ố

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Promise 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

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

Thông số

  • url

    chuỗi

    URL của một trang web. Giao thứ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.

  • callback

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

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

    (result: ExtensionInfo) => void

Giá trị trả về

  • Promise<ExtensionInfo>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

get()

Promise 
chrome.management.get(
  id: string,
  callback?: function,
): 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 đã cho.

Thông số

Giá trị trả về

  • Promise<ExtensionInfo>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getAll()

Promise 
chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

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

Thông số

  • callback

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

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

    (result: ExtensionInfo[]) => void

Giá trị trả về

  • <ExtensionInfo[]> hứa hẹn

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getPermissionWarningsById()

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

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

Thông số

  • id

    chuỗi

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

  • callback

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

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

Giá trị trả về

  • Promise<string[]>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getPermissionWarningsByManifest()

Promise 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): 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ể 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.

Thông số

  • manifestStr

    chuỗi

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

  • callback

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

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

Giá trị trả về

  • Promise<string[]>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getSelf()

Promise 
chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

Trả về thông tin về tiện ích, ứng dụng hoặc giao diện đang gọi. 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.

Thông số

  • callback

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

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

    (result: ExtensionInfo) => void

Giá trị trả về

  • Promise<ExtensionInfo>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

installReplacementWebApp()

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

Chạy replacement_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.

Thông số

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

launchApp()

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

Chạy một ứng dụng.

Thông số

  • id

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setEnabled()

Promise 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): 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ục trong management.ExtensionInfo.

  • đang bật

    boolean

    Cho biết mục này nên được bật hay tắt.

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setLaunchType()

Promise 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): 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 khởi chạy mục tiêu. Luôn kiểm tra và đảm bảo loại khởi chạy này nằm trong ExtensionInfo.availableLaunchTypes, vì các loại khởi chạy có sẵn sẽ khác nhau tuỳ theo nền tảng và cấu hình.

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

uninstall()

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

Gỡ cài đặt mộ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 được chỉ định. Nếu không gỡ cài đặt được (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 khi bạn đặt runtime.lastError.

Thông số

  • id

    chuỗi

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

  • tùy chọn

    UninstallOptions không bắt buộc

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

uninstallSelf()

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

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. 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 được chỉ định.

Thông số

  • tùy chọn

    UninstallOptions không bắt buộc

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 88 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng 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ị 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 đã được gỡ cài đặt.

Thông số

  • callback

    hàm

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

    (id: string) => void

    • id

      chuỗi