chrome.extensionTypes

Deskripsi

API chrome.extensionTypes berisi deklarasi jenis untuk ekstensi Chrome.

Jenis

ColorArray

Chrome 139+

Jenis

[number, number, number, number]

CSSOrigin

Chrome 66+

Asal CSS yang disisipkan.

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 teratas. 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

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

  • file

    string opsional

    File CSS yang akan dihapus.

  • frameId

    nomor opsional

    Frame dari tempat CSS harus dihapus. Nilai defaultnya 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+

Dunia JavaScript untuk skrip yang akan dieksekusi di dalamnya. 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

"TERISOLASI"

"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

    nomor opsional

    Jika formatnya adalah "jpeg", mengontrol 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 disisipkan. 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 disisipkan ke semua frame halaman saat ini. Secara default, nilainya adalah false dan hanya disisipkan ke dalam frame teratas. 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 disisipkan.

    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+

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

  • file

    string opsional

    File JavaScript atau CSS yang akan disisipkan.

  • frameId

    nomor opsional

    Chrome 50+

    Frame tempat skrip atau CSS harus dimasukkan. Nilai defaultnya adalah 0 (frame tingkat teratas).

  • matchAboutBlank

    boolean opsional

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

  • runAt

    RunAt opsional

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

RunAt

Chrome 44+

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

Enum

"document_start"
Skrip disisipkan setelah file dari CSS, tetapi sebelum DOM lain dibuat atau skrip lain dijalankan.

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

"document_idle"
Browser memilih waktu untuk menyisipkan skrip antara "document_end" dan segera setelah peristiwa window.onload diaktifkan. Waktu persis penyisipan bergantung pada seberapa kompleks dokumen dan berapa lama waktu yang diperlukan untuk memuatnya, serta dioptimalkan untuk kecepatan pemuatan halaman. Skrip konten yang berjalan di "document_idle" tidak perlu memproses peristiwa window.onload; skrip tersebut dijamin berjalan setelah DOM selesai. Jika skrip pasti perlu dijalankan setelah window.onload, ekstensi dapat memeriksa apakah onload telah diaktifkan dengan menggunakan properti document.readyState.