chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan chrome.mimeHandler API untuk menangani streaming jenis MIME di ekstensi pihak ketiga.

Ketersediaan

Chrome 151+

Jenis

MimeHandlerOptions

Properti

  • canEmbed

    boolean opsional

    Chrome 157+

    Apakah pengendali ini dapat digunakan untuk pemuatan tersemat (iframe, sematan, objek). Setelan default-nya adalah nilai can_embed entri manifes. Tidak berpengaruh jika enabled bernilai salah (false).

  • aktif

    boolean opsional

    Apakah pengendali ini diaktifkan. Setelan default-nya adalah nilai enabled entri manifes.

StreamInfo

Properti

  • tersemat

    boolean

    Benar jika dimuat dalam konteks tersemat (iframe/embed/object).

  • mimeType

    string

    Jenis MIME dari konten yang dicegat.

  • originalUrl

    string

    URL asli yang dibuka pengguna.

  • responseHeaders

    objek

    Header respons HTTP sebagai key-value pair.

  • streamUrl

    string

    URL untuk mengambil data streaming.

  • tabId

    angka

    ID tab yang berisi dokumen.

Metode

abortAndFallbackToNativeHandler()

Promise 
chrome.mimeHandler.abortAndFallbackToNativeHandler(
  callback?: function,
): Promise<void>

Membatalkan penanganan streaming saat ini dan menyerahkan konten ke pengendali native agen pengguna. Setelah panggilan ini, frame ekstensi akan dihentikan; pemanggil tidak boleh mengharapkan eksekusi lebih lanjut.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getMimeHandlerOptions()

Promise 
chrome.mimeHandler.getMimeHandlerOptions(
  mimeType: string,
  callback?: function,
): Promise<MimeHandlerOptions>

Membaca opsi untuk jenis MIME. Setiap anggota adalah nilai yang ditetapkan ekstensi, atau nilai entri manifes jika ekstensi belum menetapkannya.

Parameter

  • mimeType

    string

    Jenis MIME yang opsinya akan dibaca. Jenis MIME harus ditangani ekstensi melalui mime_types_handler.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (options: MimeHandlerOptions) => void

Hasil

  • Promise diselesaikan dengan opsi untuk jenis MIME.

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getStreamInfo()

Promise 
chrome.mimeHandler.getStreamInfo(
  callback?: function,
): Promise<StreamInfo>

Mengambil informasi streaming untuk konteks pengendali MIME saat ini. Harus dipanggil dari dalam halaman ekstensi pengendali MIME.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (info: StreamInfo) => void

Hasil

  • Promise<StreamInfo>

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

setMimeHandlerOptions()

Promise 
chrome.mimeHandler.setMimeHandlerOptions(
  mimeType: string,
  options: MimeHandlerOptions,
  callback?: function,
): Promise<void>

Menetapkan opsi konfigurasi untuk jenis MIME yang ditentukan. Jika ekstensi berjalan dalam mode samaran terpisah, opsi yang ditetapkan dari mode samaran hanya berlaku untuk mode samaran dan berlangsung hingga sesi samaran berakhir. Opsi yang tidak ditetapkan dari mode samaran akan mengikuti nilai yang ditetapkan di luar mode samaran.

Parameter

  • mimeType

    string

    Jenis MIME yang akan dikonfigurasi. Jenis MIME harus ditangani ekstensi melalui mime_types_handler.

  • Opsi yang dapat diubah.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Promise diselesaikan saat konfigurasi telah ditetapkan.

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.