chrome.extensionTypes

Deskripsi

chrome.extensionTypes API berisi deklarasi jenis untuk ekstensi Chrome.

Jenis

CSSOrigin

Chrome 66 dan yang lebih baru

Asal CSS yang dimasukkan.

Enum

DeleteInjectionDetails

Chrome 87 dan yang lebih baru

Detail CSS yang akan dihapus. Kode atau properti file harus ditetapkan, tetapi keduanya tidak boleh ditetapkan bersamaan.

Properti

  • allFrames

    boolean opsional

    Jika allFrame bernilai true, menyiratkan bahwa CSS harus dihapus dari semua frame halaman saat ini. Secara default, nilainya adalah false dan hanya dihapus dari frame atas. Jika true dan frameId disetel, kode akan dihapus dari frame yang dipilih dan semua frame turunannya.

  • kode

    string opsional

    Kode CSS yang akan dihapus.

  • cssOrigin

    CSSOrigin opsional

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

  • file

    string opsional

    file CSS yang akan dihapus.

  • frameId

    nomor opsional

    Bingkai tempat CSS harus dihapus. Default-nya adalah 0 (frame tingkat atas).

  • matchAboutBlank

    boolean opsional

    Jika matchAboutBlank bernilai 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

ExecutionWorld

Chrome 111 dan yang lebih baru

Dunia JavaScript untuk eksekusi skrip. 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 didaftarkan dengan User Scripts API.

Enum

FrameType

Chrome 106+

Jenis bingkai.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

Detail tentang format dan kualitas gambar.

Properti

  • format

    ImageFormat opsional

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

  • kualitas

    nomor opsional

    Jika formatnya "jpeg", mengontrol kualitas gambar yang dihasilkan. Nilai ini diabaikan untuk gambar PNG. Seiring dengan 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. Kode atau properti file harus ditetapkan, tetapi keduanya tidak boleh ditetapkan bersamaan.

Properti

  • allFrames

    boolean opsional

    Jika allFrames adalah true, menyiratkan bahwa JavaScript atau CSS harus dimasukkan ke dalam semua frame halaman saat ini. Secara default, atribut ini adalah false dan hanya dimasukkan ke dalam frame atas. Jika true dan frameId disetel, kode akan disisipkan ke 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 skrip yang salah dapat membuka ekstensi Anda terhadap serangan pembuatan skrip lintas situs

  • cssOrigin

    CSSOrigin opsional

    Chrome 66 dan yang lebih baru

    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

    nomor opsional

    Chrome 50 dan yang lebih baru

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

  • matchAboutBlank

    boolean opsional

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

  • runAt

    RunAt opsional

    Secepatnya JavaScript atau CSS akan dimasukkan ke dalam tab. Default-nya adalah "document_idle".

RunAt

Chrome 44+

Secepatnya 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 segera setelah peristiwa window.onload diaktifkan. Momen persis dari injeksi bergantung pada seberapa rumit dokumen dan berapa lama waktu yang diperlukan untuk dimuat, serta dioptimalkan untuk kecepatan pemuatan halaman. Skrip konten yang berjalan di "document_idle" tidak perlu memproses peristiwa window.onload; skrip konten 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.