chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Deskripsi

chrome.extensionTypes API berisi deklarasi jenis untuk ekstensi Chrome.

Jenis

ColorArray

Chrome 139+

Jenis

[number, number, number, number]

CSSOrigin

Chrome 66+

Asal CSS yang dimasukkan.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87+

Detail CSS yang akan dihapus. Properti kode atau file harus ditetapkan, tetapi keduanya tidak boleh ditetapkan secara bersamaan.

Properti

  • allFrames

    boolean opsional

    Jika allFrames adalah true, berarti CSS harus dihapus dari semua frame halaman saat ini. Secara default, nilainya adalah false dan hanya dihapus dari frame atas. Jika true dan frameId ditetapkan, kode akan dihapus dari frame yang dipilih dan semua frame turunannya.

  • kode

    string opsional

    Kode CSS yang akan dihapus.

  • cssOrigin

    CSSOrigin opsional

    Asal CSS yang akan dihapus. Nilai defaultnya adalah "author".

  • file

    string opsional

    File CSS yang akan dihapus.

  • frameId

    number opsional

    Frame tempat CSS harus dihapus. Default-nya adalah 0 (frame tingkat teratas).

  • matchAboutBlank

    boolean opsional

    Jika matchAboutBlank bernilai benar (true), kode juga akan dihapus dari frame about:blank dan about:srcdoc jika ekstensi Anda memiliki akses ke dokumen induknya. Secara default, nilainya adalah false.

DocumentLifecycle

Chrome 106+

Siklus proses dokumen frame.

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111+

Lingkungan JavaScript tempat skrip akan dieksekusi. Dapat berupa dunia terisolasi yang unik untuk ekstensi ini, dunia utama DOM yang dibagikan dengan JavaScript halaman, atau dunia skrip pengguna yang hanya tersedia untuk skrip yang terdaftar di User Scripts API.

Enum

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106+

Jenis frame.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139+

Data piksel untuk gambar. Harus berupa objek ImageData; misalnya, dari elemen canvas.

Jenis

ImageData

ImageDetails

Detail tentang format, kualitas, dan area gambar.

Properti

  • format

    ImageFormat opsional

    Format gambar yang dihasilkan. Default-nya adalah "jpeg".

  • kualitas

    number opsional

    Jika formatnya adalah "jpeg", kontrol kualitas gambar yang dihasilkan. Nilai ini diabaikan untuk gambar PNG. Seiring penurunan kualitas, gambar yang dihasilkan akan memiliki lebih banyak artefak visual, dan jumlah byte yang diperlukan untuk menyimpannya akan berkurang.

ImageFormat

Chrome 44+

Format gambar.

Enum

"jpeg"

"png"

InjectDetails

Detail skrip atau CSS yang akan dimasukkan. Properti kode atau file harus ditetapkan, tetapi keduanya tidak boleh ditetapkan secara bersamaan.

Properti

  • allFrames

    boolean opsional

    Jika allFrames adalah true, berarti JavaScript atau CSS harus dimasukkan ke dalam semua frame halaman saat ini. Secara default, nilainya adalah false dan hanya dimasukkan ke dalam frame atas. Jika true dan frameId ditetapkan, kode akan disisipkan dalam frame yang dipilih dan semua frame turunannya.

  • kode

    string opsional

    Kode JavaScript atau CSS yang akan dimasukkan.

    Peringatan: Berhati-hatilah saat menggunakan parameter code. Penggunaan yang salah dapat membuat ekstensi Anda rentan terhadap serangan pembuatan skrip lintas situs

  • cssOrigin

    CSSOrigin opsional

    Chrome 66+

    Origin CSS yang akan dimasukkan. Ini hanya dapat ditentukan untuk CSS, bukan JavaScript. Nilai defaultnya adalah "author".

  • file

    string opsional

    File JavaScript atau CSS yang akan dimasukkan.

  • frameId

    number opsional

    Chrome 50+

    Frame tempat skrip atau CSS harus dimasukkan. Default-nya adalah 0 (frame tingkat teratas).

  • matchAboutBlank

    boolean opsional

    Jika matchAboutBlank bernilai benar (true), kode juga akan dimasukkan ke dalam frame about:blank dan about:srcdoc jika ekstensi Anda memiliki akses ke dokumen induknya. Kode tidak dapat disisipkan di about:-frame tingkat teratas. Secara default, nilainya adalah false.

  • runAt

    RunAt opsional

    Waktu paling awal JavaScript atau CSS akan dimasukkan ke dalam tab. Default-nya adalah "document_idle".

RunAt

Chrome 44+

Waktu paling awal JavaScript atau CSS akan dimasukkan ke dalam tab.

Enum

"document_start"
Skrip dimasukkan setelah file apa pun dari css, tetapi sebelum DOM lain dibuat atau skrip lain dijalankan.

"document_end"
Skrip dimasukkan segera setelah DOM selesai, tetapi sebelum subresource seperti gambar dan frame dimuat.

"document_idle"
Browser memilih waktu untuk memasukkan skrip antara "document_end" dan tepat setelah peristiwa window.onload diaktifkan. Momen penyisipan yang tepat bergantung pada seberapa kompleks dokumen dan berapa lama waktu yang diperlukan untuk memuat, serta dioptimalkan untuk kecepatan pemuatan halaman. Skrip konten yang berjalan di "document_idle" tidak perlu memproses peristiwa window.onload; skrip tersebut dijamin akan berjalan setelah DOM selesai. Jika skrip benar-benar perlu dijalankan setelah window.onload, ekstensi dapat memeriksa apakah onload telah diaktifkan menggunakan properti document.readyState.