chrome.extension

Deskripsi

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

Jenis

ViewType

Chrome 44+

Jenis tampilan ekstensi.

Enum

"tab"

"popup"

Properti

inIncognitoContext

Benar untuk skrip konten yang berjalan di dalam tab samaran, dan untuk halaman ekstensi yang berjalan di dalam proses samaran. Yang terakhir hanya berlaku untuk ekstensi dengan incognito_behavior 'split'.

Jenis

boolean

Metode

getBackgroundPage()

Khusus latar depan 
chrome.extension.getBackgroundPage()

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

  • Periode | tidak ditentukan

getViews()

Khusus latar depan 
chrome.extension.getViews(
  fetchProperties?: object,
)

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

Parameter

  • fetchProperties

    objek opsional

    • tabId

      number opsional

      Chrome 54+

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

    • jenis

      ViewType opsional

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

    • windowId

      number opsional

      Jendela yang akan dibatasi penelusurannya. Jika dihilangkan, menampilkan semua tampilan.

Hasil

  • Window[]

    Array objek global

isAllowedFileSchemeAccess()

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

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

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boolean

      Benar jika ekstensi dapat mengakses skema 'file://', salah jika tidak.

Hasil

  • Promise<boolean>

    Chrome 99+

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

isAllowedIncognitoAccess()

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

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

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boolean

      Benar jika ekstensi memiliki akses ke mode Samaran, salah jika tidak.

Hasil

  • Promise<boolean>

    Chrome 99+

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

Acara