browser.downloads

Deskripsi

Gunakan chrome.downloads API untuk memulai, memantau, memanipulasi, dan menelusuri download secara terprogram.

Izin

downloads

Anda harus mendeklarasikan izin "downloads" di manifes ekstensi untuk menggunakan API ini.

{
  "name": "My extension",
  ...
  "permissions": [
    "downloads"
  ],
}

Contoh

Anda dapat menemukan contoh sederhana penggunaan browser.downloads API di direktori examples/api/downloads. Untuk contoh lain dan bantuan dalam melihat kode sumber, lihat Contoh.

Jenis

BooleanDelta

Properti

• saat ini

  boolean opsional

• sebelumnya

  boolean opsional

DangerType

Enum

"file"
Nama file yang didownload mencurigakan.

"url"
URL download diketahui berbahaya.

"content"
File yang didownload diketahui berbahaya.

"uncommon"
URL download tidak biasa didownload dan dapat berbahaya.

"host"
Download berasal dari host yang diketahui mendistribusikan biner berbahaya dan kemungkinan berbahaya.

"unwanted"
File yang didownload mungkin tidak diinginkan atau tidak aman. Misalnya, software tersebut dapat membuat perubahan pada setelan browser atau komputer.

"safe"
Download tidak menimbulkan bahaya yang diketahui bagi komputer pengguna.

"accepted"
Pengguna telah menerima download berbahaya.

"allowlistedByPolicy"
Nilai terkait perusahaan.

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

"forceSaveToGdrive"
Untuk digunakan oleh ekstensi Secure Enterprise Browser. Jika diperlukan, Chrome akan memblokir download ke disk dan mendownload file langsung ke Google Drive.

"forceSaveToOnedrive"
Untuk digunakan oleh ekstensi Secure Enterprise Browser. Jika diperlukan, Chrome akan memblokir download ke disk dan mendownload file langsung ke OneDrive.

DoubleDelta

Properti

• saat ini

  number opsional

• sebelumnya

  number opsional

DownloadDelta

Properti

• canResume

  BooleanDelta opsional

  Perubahan pada canResume, jika ada.

• bahaya

  StringDelta opsional

  Perubahan pada danger, jika ada.

• endTime

  StringDelta opsional

  Perubahan pada endTime, jika ada.

• error

  StringDelta opsional

  Perubahan pada error, jika ada.

• ada

  BooleanDelta opsional

  Perubahan pada exists, jika ada.

• fileSize

  DoubleDelta opsional

  Perubahan pada fileSize, jika ada.

• filename

  StringDelta opsional

  Perubahan pada filename, jika ada.

• finalUrl

  StringDelta opsional

  Chrome 54+ browser.* sejak Chrome 148

  Perubahan pada finalUrl, jika ada.

• id

  angka

  id dari DownloadItem yang berubah.

• pantomim

  StringDelta opsional

  Perubahan pada mime, jika ada.

• dijeda

  BooleanDelta opsional

  Perubahan pada paused, jika ada.

• startTime

  StringDelta opsional

  Perubahan pada startTime, jika ada.

• dengan status tersembunyi akhir

  StringDelta opsional

  Perubahan pada state, jika ada.

• totalBytes

  DoubleDelta opsional

  Perubahan pada totalBytes, jika ada.

• url

  StringDelta opsional

  Perubahan pada url, jika ada.

DownloadItem

Properti

• byExtensionId

  string opsional

  ID untuk ekstensi yang memulai download ini jika download ini dimulai oleh ekstensi. Tidak berubah setelah ditetapkan.

• byExtensionName

  string opsional

  Nama yang dilokalkan dari ekstensi yang memulai download ini jika download ini dimulai oleh ekstensi. Dapat berubah jika ekstensi mengubah namanya atau jika pengguna mengubah lokalitasnya.

• bytesReceived

  angka

  Jumlah byte yang diterima sejauh ini dari host, tanpa mempertimbangkan kompresi file.

• canResume

  boolean

  True jika download sedang berlangsung dan dijeda, atau jika download terhenti dan dapat dilanjutkan mulai dari posisi terakhirnya.

• bahaya

  DangerType

  Indikasi apakah download ini dianggap aman atau diketahui mencurigakan.

• endTime

  string opsional

  Waktu saat download berakhir dalam format ISO 8601. Dapat diteruskan langsung ke konstruktor Date: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

• error

  InterruptReason opsional

  Alasan download terganggu. Beberapa jenis error HTTP dapat dikelompokkan dalam salah satu error yang diawali dengan SERVER_. Error yang terkait dengan jaringan dimulai dengan NETWORK_, error yang terkait dengan proses penulisan file ke sistem file dimulai dengan FILE_, dan gangguan yang dimulai oleh pengguna dimulai dengan USER_.

• estimatedEndTime

  string opsional

  Perkiraan waktu saat download akan selesai dalam format ISO 8601. Dapat diteruskan langsung ke konstruktor Date: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

• ada

  boolean

  Apakah file yang didownload masih ada. Informasi ini mungkin sudah tidak berlaku karena Chrome tidak otomatis memantau penghapusan file. Panggil search() untuk memicu pemeriksaan keberadaan file. Setelah pemeriksaan keberadaan selesai, jika file telah dihapus, peristiwa onChanged akan diaktifkan. Perhatikan bahwa search() tidak menunggu pemeriksaan keberadaan selesai sebelum menampilkan hasil, sehingga hasil dari search() mungkin tidak mencerminkan sistem file secara akurat. Selain itu, search() dapat dipanggil sesering yang diperlukan, tetapi tidak akan memeriksa keberadaan file lebih sering daripada sekali setiap 10 detik.

• fileSize

  angka

  Jumlah byte di seluruh file setelah dekompresi, atau -1 jika tidak diketahui.

• filename

  string

  Jalur lokal absolut.

• finalUrl

  string

  Chrome 54+ browser.* sejak Chrome 148

  URL absolut tempat download ini dilakukan, setelah semua pengalihan.

• id

  angka

  ID yang persisten di seluruh sesi browser.

• incognito

  boolean

  False jika download ini dicatat dalam histori, true jika tidak dicatat.

• pantomim

  string

  Jenis MIME file.

• dijeda

  boolean

  Benar jika download telah berhenti membaca data dari host, tetapi koneksi tetap terbuka.

• perujuk

  string

  URL absolut.

• startTime

  string

  Waktu saat download dimulai dalam format ISO 8601. Dapat diteruskan langsung ke konstruktor Date: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

• dengan status tersembunyi akhir

  Status

  Menunjukkan apakah download sedang berlangsung, terganggu, atau selesai.

• totalBytes

  angka

  Jumlah byte di seluruh file, tanpa mempertimbangkan kompresi file, atau -1 jika tidak diketahui.

• url

  string

  URL absolut tempat download ini dimulai, sebelum pengalihan apa pun.

DownloadOptions

Properti

• body

  string opsional

  Isi postingan.

• conflictAction

  FilenameConflictAction opsional

  Tindakan yang harus diambil jika filename sudah ada.

• filename

  string opsional

  Jalur file yang relatif terhadap direktori Download untuk berisi file yang didownload, yang mungkin berisi subdirektori. Jalur absolut, jalur kosong, dan jalur yang berisi referensi balik ".." akan menyebabkan error. onDeterminingFilename memungkinkan saran nama file setelah jenis MIME file dan nama file tentatif ditentukan.

• headers

  HeaderNameValuePair[] opsional

  Header HTTP tambahan yang akan dikirim bersama permintaan jika URL menggunakan protokol HTTP[s]. Setiap header direpresentasikan sebagai kamus yang berisi kunci name dan value atau binaryValue, yang dibatasi untuk kunci yang diizinkan oleh XMLHttpRequest.

• metode

  HttpMethod opsional

  Metode HTTP yang akan digunakan jika URL menggunakan protokol HTTP[S].

• saveAs

  boolean opsional

  Gunakan pemilih file untuk mengizinkan pengguna memilih nama file, terlepas dari apakah filename ditetapkan atau sudah ada.

• url

  string

  URL yang akan didownload.

DownloadQuery

Properti

• bytesReceived

  number opsional

  Jumlah byte yang diterima sejauh ini dari host, tanpa mempertimbangkan kompresi file.

• bahaya

  DangerType opsional

  Indikasi apakah download ini dianggap aman atau diketahui mencurigakan.

• endTime

  string opsional

  Waktu saat download berakhir dalam format ISO 8601.

• endedAfter

  string opsional

  Membatasi hasil ke DownloadItem yang berakhir setelah milidetik yang ditentukan dalam format ISO 8601

• endedBefore

  string opsional

  Membatasi hasil ke DownloadItem yang berakhir sebelum milidetik yang ditentukan dalam format ISO 8601.

• error

  InterruptReason opsional

  Alasan download terganggu.

• ada

  boolean opsional

  Apakah file yang didownload ada;

• fileSize

  number opsional

  Jumlah byte di seluruh file setelah dekompresi, atau -1 jika tidak diketahui.

• filename

  string opsional

  Jalur lokal absolut.

• filenameRegex

  string opsional

  Membatasi hasil ke DownloadItem yang filename-nya cocok dengan ekspresi reguler yang diberikan.

• finalUrl

  string opsional

  Chrome 54+ browser.* sejak Chrome 148

  URL absolut tempat download ini dilakukan, setelah semua pengalihan.

• finalUrlRegex

  string opsional

  Chrome 54+ browser.* sejak Chrome 148

  Membatasi hasil ke DownloadItem yang finalUrl-nya cocok dengan ekspresi reguler yang diberikan.

• id

  number opsional

  id dari DownloadItem yang akan dikueri.

• batas

  number opsional

  Jumlah maksimum DownloadItem yang cocok yang ditampilkan. Setelan defaultnya adalah 1.000. Tetapkan ke 0 untuk menampilkan semua DownloadItem yang cocok. Lihat search untuk mengetahui cara melihat hasil halaman demi halaman.

• pantomim

  string opsional

  Jenis MIME file.

• orderBy

  string[] opsional

  Tetapkan elemen array ini ke properti DownloadItem untuk mengurutkan hasil penelusuran. Misalnya, menyetel orderBy=['startTime'] akan mengurutkan DownloadItem berdasarkan waktu mulainya dalam urutan menaik. Untuk menentukan urutan menurun, beri awalan tanda hubung: '-startTime'.

• dijeda

  boolean opsional

  Benar jika download telah berhenti membaca data dari host, tetapi koneksi tetap terbuka.

• kueri

  string[] opsional

  Array istilah penelusuran ini membatasi hasil untuk DownloadItem yang filename atau url atau finalUrl-nya berisi semua istilah penelusuran yang tidak diawali dengan tanda hubung '-' dan tidak ada istilah penelusuran yang diawali dengan tanda hubung.

• startTime

  string opsional

  Waktu saat download dimulai dalam format ISO 8601.

• startedAfter

  string opsional

  Membatasi hasil ke DownloadItem yang dimulai setelah milidetik yang ditentukan dalam format ISO 8601.

• startedBefore

  string opsional

  Membatasi hasil ke DownloadItem yang dimulai sebelum milidetik yang ditentukan dalam format ISO 8601.

• dengan status tersembunyi akhir

  State opsional

  Menunjukkan apakah download sedang berlangsung, terganggu, atau selesai.

• totalBytes

  number opsional

  Jumlah byte di seluruh file, tanpa mempertimbangkan kompresi file, atau -1 jika tidak diketahui.

• totalBytesGreater

  number opsional

  Membatasi hasil ke DownloadItem yang totalBytes-nya lebih besar dari bilangan bulat yang diberikan.

• totalBytesLess

  number opsional

  Membatasi hasil ke DownloadItem yang totalBytes-nya kurang dari bilangan bulat yang diberikan.

• url

  string opsional

  URL absolut tempat download ini dimulai, sebelum pengalihan apa pun.

• urlRegex

  string opsional

  Membatasi hasil ke DownloadItem yang url-nya cocok dengan ekspresi reguler yang diberikan.

FilenameConflictAction

uniquify

Untuk menghindari duplikasi, filename diubah untuk menyertakan penghitung sebelum ekstensi nama file.

timpa

File yang ada akan ditimpa dengan file baru.

perintah

Pengguna akan diminta dengan dialog pemilih file.

Enum

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

Properti

• conflictAction

  FilenameConflictAction opsional

  Tindakan yang harus diambil jika filename sudah ada.

• filename

  string

  Target baru DownloadItem DownloadItem.filename, sebagai jalur yang terkait dengan direktori Download default pengguna, yang mungkin berisi subdirektori. Jalur absolut, jalur kosong, dan jalur yang berisi referensi balik ".." akan diabaikan. filename akan diabaikan jika ada pemroses onDeterminingFilename yang didaftarkan oleh ekstensi mana pun.

GetFileIconOptions

Properti

• ukuran

  number opsional

  Ukuran ikon yang ditampilkan dalam piksel kepadatan mandiri (DIP). Harus berupa 16 atau 32 (defaultnya adalah 32). Pada layar DPI tinggi, gambar yang ditampilkan diskalakan dengan faktor skala perangkat (misalnya, 64x64 px untuk ukuran 32 pada layar 2x). Panggilan dari service worker latar belakang ditetapkan ke skala 1x secara default.

HeaderNameValuePair

Properti

• nama

  string

  Nama header HTTP.

• nilai

  string

  Nilai header HTTP.

HttpMethod

Enum

"GET"

"POST"

InterruptReason

Enum

"FILE_FAILED"

"FILE_ACCESS_DENIED"

"FILE_NO_SPACE"

"FILE_NAME_TOO_LONG"

"FILE_TOO_LARGE"

"FILE_VIRUS_INFECTED"

"FILE_TRANSIENT_ERROR"

"FILE_BLOCKED"

"FILE_SECURITY_CHECK_FAILED"

"FILE_TOO_SHORT"

"FILE_HASH_MISMATCH"

"FILE_SAME_AS_SOURCE"

"NETWORK_FAILED"

"NETWORK_TIMEOUT"

"NETWORK_DISCONNECTED"

"NETWORK_SERVER_DOWN"

"NETWORK_INVALID_REQUEST"

"SERVER_FAILED"

"SERVER_NO_RANGE"

"SERVER_BAD_CONTENT"

"SERVER_UNAUTHORIZED"

"SERVER_CERT_PROBLEM"

"SERVER_FORBIDDEN"

"SERVER_UNREACHABLE"

"SERVER_CONTENT_LENGTH_MISMATCH"

"SERVER_CROSS_ORIGIN_REDIRECT"

"USER_CANCELED"

"USER_SHUTDOWN"

"CRASH"

State

in_progress

Download saat ini menerima data dari server.

terganggu

Terjadi error yang memutuskan koneksi dengan host file.

selesai

Download berhasil diselesaikan.

Enum

"in_progress"

"interrupted"

"complete"

StringDelta

Properti

• saat ini

  string opsional

• sebelumnya

  string opsional

UiOptions

Chrome 105+ browser.* sejak Chrome 148

Properti

• aktif

  boolean

  Mengaktifkan atau menonaktifkan UI download.

Metode

acceptDanger()

browser.downloads.acceptDanger(
  downloadId: number,
): Promise<void>

Meminta pengguna untuk menerima download berbahaya. Hanya dapat dipanggil dari konteks yang terlihat (tab, jendela, atau pop-up tindakan halaman/browser). Tidak otomatis menerima download berbahaya. Jika download diterima, peristiwa onChanged akan diaktifkan. Jika tidak, tidak akan terjadi apa-apa. Setelah semua data diambil ke dalam file sementara dan download tidak berbahaya atau bahaya telah diterima, file sementara akan diganti namanya menjadi nama file target, state berubah menjadi 'complete', dan onChanged diaktifkan.

Parameter

• downloadId

  angka

  ID untuk DownloadItem.

Hasil

• Promise<void>

  Chrome 96+ browser.* sejak Chrome 148

  Menampilkan Promise yang di-resolve saat dialog perintah bahaya ditutup.

cancel()

browser.downloads.cancel(
  downloadId: number,
): Promise<void>

Membatalkan download. Saat callback dijalankan, download akan dibatalkan, diselesaikan, dihentikan, atau tidak ada lagi.

Parameter

• downloadId

  angka

  ID download yang akan dibatalkan.

Hasil

• Promise<void>

  Chrome 96+ browser.* sejak Chrome 148

  Menampilkan Promise yang di-resolve saat permintaan pembatalan selesai.

download()

browser.downloads.download(
  options: DownloadOptions,
): Promise<number>

Mendownload URL. Jika URL menggunakan protokol HTTP[S], permintaan akan menyertakan semua cookie yang saat ini ditetapkan untuk nama host-nya. Jika filename dan saveAs ditentukan, dialog Simpan Sebagai akan ditampilkan, yang diisi otomatis dengan filename yang ditentukan. Jika download berhasil dimulai, callback akan dipanggil dengan downloadId DownloadItem baru. Jika terjadi error saat memulai download, callback akan dipanggil dengan downloadId=undefined dan runtime.lastError akan berisi string deskriptif. String error tidak dijamin akan tetap kompatibel dengan versi lama di antara rilis. Ekstensi tidak boleh mengurainya.

Parameter

• opsi

  DownloadOptions

  Apa yang harus didownload dan caranya.

Hasil

• Promise<number>

  Chrome 96+ browser.* sejak Chrome 148

  Menampilkan Promise yang di-resolve dengan ID DownloadItem baru.

erase()

browser.downloads.erase(
  query: DownloadQuery,
): Promise<number[]>

Hapus DownloadItem yang cocok dari histori tanpa menghapus file yang didownload. Peristiwa onErased akan diaktifkan untuk setiap DownloadItem yang cocok dengan query, lalu callback akan dipanggil.

Parameter

• kueri

  DownloadQuery

Hasil

• Promise<number[]>

  Chrome 96+ browser.* sejak Chrome 148

getFileIcon()

browser.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
): Promise<string | undefined>

Mengambil ikon untuk download yang ditentukan. Untuk download baru, ikon file tersedia setelah nama file target download ditentukan (misalnya, saat onChanged diaktifkan dengan perubahan filename). Upaya mengambil ikon sebelum nama file ditentukan akan menghasilkan error melalui runtime.lastError. Gambar yang ditampilkan oleh fungsi ini saat download sedang berlangsung mungkin berbeda dengan gambar yang ditampilkan setelah download selesai. Pengambilan ikon dilakukan dengan mengkueri sistem operasi atau toolkit yang mendasarinya, bergantung pada platform. Oleh karena itu, ikon yang ditampilkan akan bergantung pada sejumlah faktor, termasuk status download, platform, jenis file terdaftar, dan tema visual. Jika ikon file tidak dapat ditentukan, runtime.lastError akan berisi pesan error.

Parameter

• downloadId

  angka

  ID untuk download.

• opsi

  GetFileIconOptions opsional

Hasil

• Promise<string | undefined>

  Chrome 96+ browser.* sejak Chrome 148

  Menampilkan Promise yang di-resolve dengan URL ke gambar yang mewakili download.

open()

browser.downloads.open(
  downloadId: number,
): Promise<void>

Membuka file yang didownload sekarang jika DownloadItem selesai; jika tidak, menampilkan error melalui runtime.lastError. Metode ini memerlukan izin "downloads.open" selain izin "downloads". Peristiwa onChanged diaktifkan saat item dibuka untuk pertama kalinya. Metode ini hanya dapat dipanggil sebagai respons terhadap gestur pengguna.

Parameter

• downloadId

  angka

  ID untuk file yang didownload.

Hasil

• Promise<void>

  Chrome 123+ browser.* sejak Chrome 148

pause()

browser.downloads.pause(
  downloadId: number,
): Promise<void>

Jeda download. Jika permintaan berhasil, download akan berada dalam status dijeda. Jika tidak, runtime.lastError akan berisi pesan error. Permintaan akan gagal jika download tidak aktif.

Parameter

• downloadId

  angka

  ID download yang akan dijeda.

Hasil

• Promise<void>

  Chrome 96+ browser.* sejak Chrome 148

  Menampilkan Promise yang di-resolve saat permintaan jeda selesai.

removeFile()

browser.downloads.removeFile(
  downloadId: number,
): Promise<void>

Hapus file yang didownload jika ada dan DownloadItem selesai; jika tidak, tampilkan error melalui runtime.lastError.

Parameter

• downloadId

  angka

Hasil

• Promise<void>

  Chrome 96+ browser.* sejak Chrome 148

resume()

browser.downloads.resume(
  downloadId: number,
): Promise<void>

Melanjutkan download yang dijeda. Jika permintaan berhasil, download akan berlangsung dan dilanjutkan. Jika tidak, runtime.lastError akan berisi pesan error. Permintaan akan gagal jika download tidak aktif.

Parameter

• downloadId

  angka

  ID download yang akan dilanjutkan.

Hasil

• Promise<void>

  Chrome 96+ browser.* sejak Chrome 148

  Menampilkan Promise yang di-resolve saat permintaan melanjutkan selesai.

search()

browser.downloads.search(
  query: DownloadQuery,
): Promise<DownloadItem[]>

Temukan DownloadItem. Tetapkan query ke objek kosong untuk mendapatkan semua DownloadItem. Untuk mendapatkan DownloadItem tertentu, tetapkan kolom id saja. Untuk melihat sejumlah besar item, tetapkan orderBy: ['-startTime'], tetapkan limit ke jumlah item per halaman, dan tetapkan startedAfter ke startTime item terakhir dari halaman terakhir.

Parameter

• kueri

  DownloadQuery

Hasil

• Promise<DownloadItem[]>

  Chrome 96+ browser.* sejak Chrome 148

setShelfEnabled()

Tidak digunakan lagi sejak Chrome 117

browser.downloads.setShelfEnabled(
  enabled: boolean,
): void

Sebagai gantinya, gunakan setUiOptions.

Mengaktifkan atau menonaktifkan panel abu-abu di bagian bawah setiap jendela yang terkait dengan profil browser saat ini. Galeri akan dinonaktifkan selama setidaknya satu ekstensi telah menonaktifkannya. Mengaktifkan panel samping saat setidaknya satu ekstensi lain telah menonaktifkannya akan menampilkan error melalui runtime.lastError. Memerlukan izin "downloads.shelf" selain izin "downloads".

Parameter

• aktif

  boolean

setUiOptions()

Chrome 105+ browser.* sejak Chrome 148

browser.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

Mengubah UI download setiap jendela yang terkait dengan profil browser saat ini. Selama setidaknya satu ekstensi telah menetapkan UiOptions.enabled ke salah, UI download akan disembunyikan. Menetapkan UiOptions.enabled ke true saat setidaknya satu ekstensi lain telah menonaktifkannya akan menampilkan error melalui runtime.lastError. Memerlukan izin "downloads.ui" selain izin "downloads".

Parameter

• opsi

  UiOptions

  Mengenkapsulasi perubahan pada UI download.

Hasil

• Promise<void>

  Menampilkan Promise yang di-resolve saat update UI selesai.

show()

browser.downloads.show(
  downloadId: number,
): void

Menampilkan file yang didownload di foldernya dalam pengelola file.

Parameter

• downloadId

  angka

  ID untuk file yang didownload.

showDefaultFolder()

browser.downloads.showDefaultFolder(): void

Menampilkan folder Download default di pengelola file.

Acara

onChanged

browser.downloads.onChanged.addListener(
  callback: function,
)

Saat salah satu properti DownloadItem kecuali bytesReceived dan estimatedEndTime berubah, peristiwa ini akan diaktifkan dengan downloadId dan objek yang berisi properti yang berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (downloadDelta: DownloadDelta) => void

  • downloadDelta

    DownloadDelta

onCreated

browser.downloads.onCreated.addListener(
  callback: function,
)

Peristiwa ini dipicu dengan objek DownloadItem saat download dimulai.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (downloadItem: DownloadItem) => void

  • downloadItem

    DownloadItem

onDeterminingFilename

browser.downloads.onDeterminingFilename.addListener(
  callback: function,
)

Selama proses penentuan nama file, ekstensi akan diberi kesempatan untuk mengganti DownloadItem.filename target. Setiap ekstensi tidak boleh mendaftarkan lebih dari satu pemroses untuk peristiwa ini. Setiap pemroses harus memanggil suggest tepat satu kali, baik secara sinkron maupun asinkron. Jika pemroses memanggil suggest secara asinkron, pemroses harus menampilkan true. Jika pemroses tidak memanggil suggest secara sinkron atau menampilkan true, suggest akan dipanggil secara otomatis. DownloadItem tidak akan selesai hingga semua pemroses memanggil suggest. Pemroses dapat memanggil suggest tanpa argumen apa pun agar download dapat menggunakan downloadItem.filename untuk nama filenya, atau meneruskan objek suggestion ke suggest untuk mengganti nama file target. Jika lebih dari satu ekstensi mengganti nama file, ekstensi terakhir yang diinstal yang pemrosesnya meneruskan objek suggestion ke suggest akan menang. Untuk menghindari kebingungan terkait ekstensi mana yang akan menang, pengguna tidak boleh menginstal ekstensi yang mungkin bertentangan. Jika download dimulai oleh download dan nama file target diketahui sebelum jenis MIME dan nama file tentatif ditentukan, teruskan filename ke download.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (downloadItem: DownloadItem, suggest: function) => void

  • downloadItem

    DownloadItem

  • saran

    fungsi

    Parameter suggest terlihat seperti:

    (suggestion?: FilenameSuggestion) => void

    • saran

      FilenameSuggestion opsional

onErased

browser.downloads.onErased.addListener(
  callback: function,
)

Diaktifkan dengan downloadId saat download dihapus dari histori.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (downloadId: number) => void

  • downloadId

    angka