browser.extension

Deskripsi

chrome.extension API memiliki utilitas yang dapat digunakan oleh halaman ekstensi mana pun. API ini mencakup dukungan untuk bertukar pesan antara ekstensi dan skrip kontennya atau antar-ekstensi, seperti yang dijelaskan secara mendetail dalam Penerusan Pesan.

Jenis

ViewType

Chrome 44+ browser.* sejak Chrome 148

Jenis tampilan ekstensi.

Enum

"tab"

"popup"

Properti

inIncognitoContext

True untuk skrip konten yang berjalan di dalam tab samaran, dan untuk halaman ekstensi yang berjalan di dalam proses samaran. Opsi kedua hanya berlaku untuk ekstensi dengan incognito_behavior 'split'.

Jenis

boolean

Metode

getBackgroundPage()

Hanya latar depan 
browser.extension.getBackgroundPage(): Window | undefined

Menampilkan objek 'window' JavaScript untuk halaman latar belakang yang berjalan di dalam ekstensi saat ini. Menampilkan null jika ekstensi tidak memiliki halaman latar belakang.

Hasil

  • Window | undefined

getViews()

Hanya latar depan 
browser.extension.getViews(
  fetchProperties?: object,
): Window[]

Menampilkan array objek 'window' JavaScript untuk setiap halaman yang berjalan di dalam ekstensi saat ini.

Parameter

  • fetchProperties

    objek opsional

    • tabId

      number opsional

      Chrome 54+ browser.* sejak Chrome 148

      Menemukan tampilan sesuai dengan ID tab. Jika kolom ini dihilangkan, semua tampilan akan ditampilkan.

    • jenis

      ViewType opsional

      Jenis tampilan yang akan didapatkan. Jika dihilangkan, akan menampilkan semua tampilan (termasuk halaman dan tab latar belakang).

    • windowId

      number opsional

      Jendela untuk membatasi penelusuran. Jika dihilangkan, semua tampilan akan ditampilkan.

Hasil

  • Window[]

    Array objek global

isAllowedFileSchemeAccess()

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

Mengambil status akses ekstensi ke skema 'file://'. Kebijakan ini sesuai dengan setelan 'Izinkan akses ke URL File' per ekstensi yang dikontrol pengguna dan dapat diakses melalui halaman chrome://extensions.

Hasil

  • Promise<boolean>

    Chrome 99+ browser.* sejak Chrome 148

isAllowedIncognitoAccess()

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

Mengambil status akses ekstensi ke mode Samaran. Kebijakan ini sesuai dengan setelan 'Diizinkan dalam mode Samaran' per ekstensi yang dikontrol pengguna dan dapat diakses melalui halaman chrome://extensions.

Hasil

  • Promise<boolean>

    Chrome 99+ browser.* sejak Chrome 148

setUpdateUrlData()

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

Menetapkan nilai parameter CGI ap yang digunakan di URL update ekstensi. Nilai ini diabaikan untuk ekstensi yang dihosting di Galeri Ekstensi Chrome.

Parameter

  • data

    string