browser.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ư được mô tả chi tiết trong phần Truyền thông báo.

Loại

ViewType

Trình duyệt Chrome 44 trở lên .* kể từ Chrome 148

Loại chế độ xem tiện ích.

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. Điều kiện 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ỉ nền trước 
browser.extension.getBackgroundPage(): Window | undefined

Trả về đối tượng "window" JavaScript cho trang nền đang 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ề

  • Cửa sổ | chưa xác định

getViews()

Chỉ nền trước 
browser.extension.getViews(
  fetchProperties?: object,
): Window[]

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

Thông số

  • fetchProperties

    object không bắt buộc

    • tabId

      number không bắt buộc

      Chrome 54 trở lên browser.* kể từ Chrome 148

      Tìm một khung 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ả các chế độ xem.

    • loại

      ViewType không bắt buộc

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

    • windowId

      number không bắt buộc

      Cửa sổ để giới hạn phạm vi tìm kiếm. Nếu bạn bỏ qua, hàm sẽ trả về tất cả các chế độ xem.

Giá trị trả về

  • Window[]

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

isAllowedFileSchemeAccess()

browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>

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

Giá trị trả về

  • Promise<boolean>

    Chrome 99 trở lên browser.* kể từ Chrome 148

isAllowedIncognitoAccess()

browser.extension.isAllowedIncognitoAccess(): Promise<boolean>

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

Giá trị trả về

  • Promise<boolean>

    Chrome 99 trở lên browser.* kể từ Chrome 148

setUpdateUrlData()

browser.extension.setUpdateUrlData(
  data: string,
): void

Đặt giá trị của tham số CGI ap được 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 Chrome được lưu trữ trong Thư viện tiện ích của Chrome.

Thông số

  • khác

    chuỗi