chrome.extension

Mô tả

API chrome.extension có các tiện ích mà mọi trang tiện ích đều có thể sử dụng. API này hỗ trợ việc trao đổi thông báo giữa một tiện ích và tập lệnh nội dung của tiện ích đó hoặc giữa các tiện ích, như mô tả chi tiết trong phần Chuyển thông báo.

Loại

ViewType

Chrome 44 trở lên

Loại thành phần hiển thị phần mở rộng.

Enum

"tab"

"popup"

Thuộc tính

inIncognitoContext

Đúng đối với các tập lệnh nội dung chạy bên trong thẻ ẩn danh và đối với các trang tiện ích chạy bên trong một quy trình ẩn danh. Trường hợp sau chỉ áp dụng cho các tiện ích có incognito_behavior "phân tách".

Loại

boolean

Phương thức

getBackgroundPage()

Chỉ ở chế độ nền trước 
chrome.extension.getBackgroundPage()

Trả về đối tượng "cửa sổ" JavaScript cho trang nền chạy bên trong tiện ích hiện tại. Trả về giá trị rỗng nếu tiện ích không có trang nền.

Giá trị trả về

  • Window | undefined

getViews()

Chỉ ở chế độ nền trước 
chrome.extension.getViews(
  fetchProperties?: object,
)

Trả về một mảng các đối tượng "cửa sổ" JavaScript cho mỗi trang chạy bên trong tiện ích hiện tại.

Tham số

  • fetchProperties

    đối tượng không bắt buộc

    • tabId

      số không bắt buộc

      Chrome 54 trở lên

      Tìm một thành phần hiển thị theo mã thẻ. Nếu bạn bỏ qua trường này, hệ thống sẽ trả về tất cả thành phần hiển thị.

    • loại

      ViewType không bắt buộc

      Loại chế độ xem cần lấy. Nếu bị bỏ qua, sẽ trả về tất cả thành phần hiển thị (bao gồm cả các trang và thẻ ở chế độ nền).

    • windowId

      số không bắt buộc

      Cửa sổ để giới hạn phạm vi tìm kiếm. Nếu bị bỏ qua, sẽ trả về tất cả thành phần hiển thị.

Giá trị trả về

  • Window[]

    Mảng đối tượng toàn cục

isAllowedFileSchemeAccess()

Promise 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

Truy xuất trạng thái truy cập của tiện ích vào giao thức "file://". Điều này tương ứng với chế độ cài đặt "Cho phép truy cập vào URL của tệp" theo từng tiện ích do người dùng kiểm soát, có thể truy cập thông qua trang chrome://extensions.

Tham số

  • lệnh gọi lại

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

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boolean

      Đúng nếu tiện ích có thể truy cập vào giao thức "file://", nếu không thì là sai.

Giá trị trả về

  • Promise<boolean>

    Chrome 99 trở lên

    Lời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo 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ẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

isAllowedIncognitoAccess()

Promise 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

Truy xuất trạng thái truy cập của tiện ích vào Chế độ ẩn danh. Điều này tương ứng với chế độ cài đặt "Được phép ở chế độ ẩn danh" theo từng tiện ích do người dùng kiểm soát, có thể truy cập thông qua trang chrome://extensions.

Tham số

  • lệnh gọi lại

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

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boolean

      Đúng nếu tiện ích có quyền truy cập vào Chế độ ẩn danh, nếu không thì sai.

Giá trị trả về

  • Promise<boolean>

    Chrome 99 trở lên

    Lời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo 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ẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

Đặt giá trị của tham số CGI ap dùng trong URL cập nhật của tiện ích. Giá trị này bị bỏ qua đối với các tiện ích được lưu trữ trong Thư viện tiện ích Chrome.

Tham số

  • dữ liệu

    chuỗi

Sự kiện