browser.downloads

Açıklama

İndirme işlemlerini programatik olarak başlatmak, izlemek, değiştirmek ve aramak için chrome.downloads API'yi kullanın.

İzinler

downloads

Bu API'yi kullanmak için uzantı manifest dosyasında "downloads" iznini beyan etmeniz gerekir.

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

Örnekler

browser.downloads API'sinin kullanımına ilişkin basit örnekleri examples/api/downloads dizininde bulabilirsiniz. Diğer örnekler ve kaynak kodunu görüntüleme konusunda yardım için Örnekler'e bakın.

Türler

BooleanDelta

Özellikler

• akım

  boole isteğe bağlı

• önceki

  boole isteğe bağlı

DangerType

Enum

"file"
İndirilen dosyanın adı şüpheli.

"url"
İndirme URL'sinin kötü amaçlı olduğu biliniyor.

"content"
İndirilen dosyanın kötü amaçlı olduğu biliniyor.

"uncommon"
İndirme URL'si yaygın olarak indirilen bir URL değil ve tehlikeli olabilir.

"host"
İndirme işlemi, kötü amaçlı ikili programlar dağıttığı bilinen bir barındırıcıdan yapıldı ve muhtemelen tehlikeli.

"unwanted"
İndirme işlemi istenmeyen veya güvenli olmayan bir durum olabilir. Örneğin, tarayıcı veya bilgisayar ayarlarında değişiklik yapabilir.

"safe"
İndirilen dosya, kullanıcının bilgisayarı için bilinen bir tehlike oluşturmuyor.

"accepted"
Kullanıcı, tehlikeli indirme işlemini kabul etti.

"allowlistedByPolicy"
Kurumsal ile ilgili değerler.

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

"forceSaveToGdrive"
Secure Enterprise Browser uzantısı tarafından kullanılır. Chrome, gerektiğinde diske indirme işlemini engeller ve dosyayı doğrudan Google Drive'a indirir.

"forceSaveToOnedrive"
Secure Enterprise Browser uzantısı tarafından kullanılır. Chrome, gerektiğinde diske indirme işlemini engeller ve dosyayı doğrudan OneDrive'a indirir.

DoubleDelta

Özellikler

• akım

  number isteğe bağlı

• önceki

  number isteğe bağlı

DownloadDelta

Özellikler

• canResume

  BooleanDelta isteğe bağlı

  canResume değerindeki değişiklik (varsa).

• danger

  StringDelta isteğe bağlı

  danger değerindeki değişiklik (varsa).

• endTime

  StringDelta isteğe bağlı

  endTime değerindeki değişiklik (varsa).

• hata

  StringDelta isteğe bağlı

  error değerindeki değişiklik (varsa).

• vardır

  BooleanDelta isteğe bağlı

  exists değerindeki değişiklik (varsa).

• fileSize

  DoubleDelta isteğe bağlı

  fileSize değerindeki değişiklik (varsa).

• filename

  StringDelta isteğe bağlı

  filename değerindeki değişiklik (varsa).

• finalUrl

  StringDelta isteğe bağlı

  Chrome 54 ve sonraki sürümler Chrome 148'den itibaren browser.*

  finalUrl değerindeki değişiklik (varsa).

• id

  sayı

  Değişen DownloadItem öğesinin id değeri.

• mime

  StringDelta isteğe bağlı

  mime değerindeki değişiklik (varsa).

• duraklatıldı

  BooleanDelta isteğe bağlı

  paused değerindeki değişiklik (varsa).

• startTime

  StringDelta isteğe bağlı

  startTime değerindeki değişiklik (varsa).

• durum

  StringDelta isteğe bağlı

  state değerindeki değişiklik (varsa).

• totalBytes

  DoubleDelta isteğe bağlı

  totalBytes değerindeki değişiklik (varsa).

• url

  StringDelta isteğe bağlı

  url değerindeki değişiklik (varsa).

DownloadItem

Özellikler

• byExtensionId

  string isteğe bağlı

  Bu indirme işlemi bir uzantı tarafından başlatıldıysa indirme işlemini başlatan uzantının tanımlayıcısı. Ayarladıktan sonra değiştirilemez.

• byExtensionName

  string isteğe bağlı

  Bu indirme işlemi bir uzantı tarafından başlatıldıysa indirme işlemini başlatan uzantının yerelleştirilmiş adı. Uzantı adını değiştirirse veya kullanıcı yerel ayarını değiştirirse değişebilir.

• bytesReceived

  sayı

  Dosya sıkıştırma dikkate alınmadan, ana makineden şu ana kadar alınan bayt sayısı.

• canResume

  boole

  İndirme işlemi devam ediyor ve duraklatılmışsa veya kesintiye uğramışsa ve kesintiye uğradığı yerden devam ettirilebiliyorsa doğru değerini döndürür.

• danger

  DangerType

  Bu indirmenin güvenli olduğu mu yoksa şüpheli olduğu mu düşünüldüğünü gösterir.

• endTime

  string isteğe bağlı

  İndirme işleminin sona erdiği zaman (ISO 8601 biçiminde). Doğrudan Date oluşturucusuna iletilebilir: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

• hata

  InterruptReason isteğe bağlı

  İndirme işleminin kesintiye uğrama nedeni. Birkaç tür HTTP hatası, SERVER_ ile başlayan hatalardan birinin altında gruplandırılabilir. Ağla ilgili hatalar NETWORK_ ile, dosyanın dosya sistemine yazılmasıyla ilgili hatalar FILE_ ile ve kullanıcı tarafından başlatılan kesintiler USER_ ile başlar.

• estimatedEndTime

  string isteğe bağlı

  İndirme işleminin tamamlanacağı tahmini zaman (ISO 8601 biçiminde). Doğrudan Date oluşturucusuna iletilebilir: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

• vardır

  boole

  İndirilen dosyanın hâlâ mevcut olup olmadığı Chrome, dosya kaldırma işlemlerini otomatik olarak izlemediğinden bu bilgiler güncel olmayabilir. Dosya varlığını kontrol etmeyi tetiklemek için search() yöntemini çağırın. Varlık kontrolü tamamlandığında, dosya silinmişse bir onChanged etkinliği tetiklenir. search() işlevinin, döndürmeden önce varlık kontrolünün tamamlanmasını beklemediğini, bu nedenle search() işlevinden elde edilen sonuçların dosya sistemini doğru şekilde yansıtmayabileceğini unutmayın. Ayrıca, search() gerektiği sıklıkta çağrılabilir ancak dosya varlığını 10 saniyede bir kereden daha sık kontrol etmez.

• fileSize

  sayı

  Sıkıştırma açıldıktan sonra tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.

• filename

  dize

  Mutlak yerel yol.

• finalUrl

  dize

  Chrome 54 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Tüm yönlendirmelerden sonra bu indirmenin yapıldığı mutlak URL.

• id

  sayı

  Tarayıcı oturumları arasında kalıcı olan bir tanımlayıcı.

• gizli mod

  boole

  Bu indirme işlemi geçmişe kaydedildiyse yanlış, kaydedilmediyse doğru.

• mime

  dize

  Dosyanın MIME türü.

• duraklatıldı

  boole

  İndirme işlemi, ana makineden veri okumayı durdurduysa ancak bağlantıyı açık tuttuysa "Doğru" değerini alır.

• yönlendiren

  dize

  Mutlak URL.

• startTime

  dize

  İndirme işleminin başladığı zaman (ISO 8601 biçiminde). Doğrudan Date oluşturucusuna iletilebilir: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

• durum

  Durum

  İndirme işleminin devam ettiğini, kesintiye uğradığını veya tamamlandığını gösterir.

• totalBytes

  sayı

  Dosya sıkıştırma dikkate alınmadan tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.

• url

  dize

  Herhangi bir yönlendirmeden önce bu indirme işleminin başlatıldığı mutlak URL.

DownloadOptions

Özellikler

• gövde

  string isteğe bağlı

  Yayın gövdesi.

• conflictAction

  FilenameConflictAction isteğe bağlı

  filename zaten mevcutsa yapılacak işlem.

• filename

  string isteğe bağlı

  İndirilen dosyayı içerecek, İndirilenler dizinine göre bir dosya yolu. Alt dizinler içerebilir. Mutlak yollar, boş yollar ve geri referanslar ".." içeren yollar hataya neden olur. onDeterminingFilename, dosyanın MIME türü ve geçici bir dosya adı belirlendikten sonra dosya adı önerilmesine olanak tanır.

• üstbilgiler

  HeaderNameValuePair[] isteğe bağlı

  URL, HTTP[s] protokolünü kullanıyorsa istekle birlikte gönderilecek ek HTTP üstbilgileri. Her üstbilgi, name anahtarlarını ve value veya binaryValue anahtarlarını içeren bir sözlük olarak temsil edilir ve XMLHttpRequest tarafından izin verilenlerle sınırlıdır.

• method

  HttpMethod isteğe bağlı

  URL, HTTP[S] protokolünü kullanıyorsa kullanılacak HTTP yöntemi.

• saveAs

  boole isteğe bağlı

  filename ayarlanmış veya zaten mevcut olsa bile kullanıcının bir dosya adı seçmesine izin vermek için dosya seçici kullanın.

• url

  dize

  İndirilecek URL.

DownloadQuery

Özellikler

• bytesReceived

  number isteğe bağlı

  Dosya sıkıştırma dikkate alınmadan, ana makineden şu ana kadar alınan bayt sayısı.

• danger

  DangerType isteğe bağlı

  Bu indirmenin güvenli olduğu mu yoksa şüpheli olduğu mu düşünüldüğünü gösterir.

• endTime

  string isteğe bağlı

  İndirme işleminin sona erdiği zaman (ISO 8601 biçiminde).

• endedAfter

  string isteğe bağlı

  Sonuçları, ISO 8601 biçiminde belirtilen milisaniyeden sonra sona eren DownloadItem ile sınırlandırır.

• endedBefore

  string isteğe bağlı

  Sonuçları, ISO 8601 biçiminde belirtilen milisaniyeden önce sona eren DownloadItem ile sınırlandırır.

• hata

  InterruptReason isteğe bağlı

  İndirme işleminin kesintiye uğrama nedeni.

• vardır

  boole isteğe bağlı

  İndirilen dosyanın mevcut olup olmadığı

• fileSize

  number isteğe bağlı

  Sıkıştırma açıldıktan sonra tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.

• filename

  string isteğe bağlı

  Mutlak yerel yol.

• filenameRegex

  string isteğe bağlı

  Sonuçları, filename değeri belirtilen normal ifadeyle eşleşen DownloadItem ile sınırlandırır.

• finalUrl

  string isteğe bağlı

  Chrome 54 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Tüm yönlendirmelerden sonra bu indirmenin yapıldığı mutlak URL.

• finalUrlRegex

  string isteğe bağlı

  Chrome 54 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Sonuçları, finalUrl değeri belirtilen normal ifadeyle eşleşen DownloadItem ile sınırlandırır.

• id

  number isteğe bağlı

  Sorgulanacak DownloadItem'nin id.

• sınır

  number isteğe bağlı

  Eşleşen maksimum DownloadItem sayısı döndürüldü. Varsayılan değer 1.000'dir. Eşleşen tüm DownloadItem değerlerini döndürmek için 0 olarak ayarlayın. Sonuçlar arasında nasıl gezineceğinizi öğrenmek için search bölümüne bakın.

• mime

  string isteğe bağlı

  Dosyanın MIME türü.

• orderBy

  string[] isteğe bağlı

  Arama sonuçlarını sıralamak için bu dizinin öğelerini DownloadItem özelliklerine ayarlayın. Örneğin, orderBy=['startTime'] ayarı, DownloadItem öğelerini başlangıç zamanlarına göre artan düzende sıralar. Azalan düzende sıralamak için başına kısa çizgi ekleyin: "-startTime".

• duraklatıldı

  boole isteğe bağlı

  İndirme işlemi, ana makineden veri okumayı durdurduysa ancak bağlantıyı açık tuttuysa "Doğru" değerini alır.

• sorgu

  string[] isteğe bağlı

  Bu arama terimleri dizisi, sonuçları filename, url veya finalUrl alanları tire "-" ile başlamayan tüm arama terimlerini içeren ve tire ile başlayan arama terimlerini içermeyen DownloadItem ile sınırlandırır.

• startTime

  string isteğe bağlı

  İndirme işleminin başladığı zaman (ISO 8601 biçiminde).

• startedAfter

  string isteğe bağlı

  Sonuçları, ISO 8601 biçiminde belirtilen milisaniyeden sonra başlayan DownloadItem ile sınırlar.

• startedBefore

  string isteğe bağlı

  Sonuçları, ISO 8601 biçiminde belirtilen milisaniyeden önce başlayan DownloadItem ile sınırlandırır.

• durum

  Eyalet isteğe bağlı

  İndirme işleminin devam ettiğini, kesintiye uğradığını veya tamamlandığını gösterir.

• totalBytes

  number isteğe bağlı

  Dosya sıkıştırma dikkate alınmadan tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.

• totalBytesGreater

  number isteğe bağlı

  Sonuçları, totalBytes değeri belirtilen tam sayıdan büyük olan DownloadItem ile sınırlandırır.

• totalBytesLess

  number isteğe bağlı

  Sonuçları, totalBytes değeri belirtilen tam sayıdan küçük olan DownloadItem ile sınırlandırır.

• url

  string isteğe bağlı

  Herhangi bir yönlendirmeden önce bu indirme işleminin başlatıldığı mutlak URL.

• urlRegex

  string isteğe bağlı

  Sonuçları, url değeri belirtilen normal ifadeyle eşleşen DownloadItem ile sınırlandırır.

FilenameConflictAction

benzersizleştirme

Kopyalanmayı önlemek için filename, dosya adı uzantısından önce bir sayaç içerecek şekilde değiştirilir.

üzerine yazmak

Mevcut dosyanın üzerine yeni dosya yazılır.

istem

Kullanıcıya bir dosya seçici iletişim kutusu gösterilir.

Enum

"uniquify"

"üzerine yaz"

"prompt"

FilenameSuggestion

Özellikler

• conflictAction

  FilenameConflictAction isteğe bağlı

  filename zaten mevcutsa yapılacak işlem.

• filename

  dize

  DownloadItem için yeni hedef DownloadItem.filename. Kullanıcının varsayılan İndirilenler dizinine göre bir yol olarak belirtilir ve alt dizinler içerebilir. Mutlak yollar, boş yollar ve geri referanslar ".." içeren yollar yoksayılır. Herhangi bir uzantı tarafından kaydedilmiş onDeterminingFilename dinleyici varsa filename yoksayılır.

GetFileIconOptions

Özellikler

• beden

  number isteğe bağlı

  Döndürülen simgenin yoğunluktan bağımsız piksel (DIP) cinsinden boyutu. 16 veya 32 olmalıdır (varsayılan değer 32'dir). Yüksek DPI ekranlarda, döndürülen resim cihaz ölçeklendirme faktörüne göre ölçeklendirilir (ör. 2x ekranda 32 boyut için 64x64 piksel). Arka plan hizmet çalışanlarından gelen çağrılar varsayılan olarak 1 kat ölçeklidir.

HeaderNameValuePair

Özellikler

• ad

  dize

  HTTP üstbilgisinin adı.

• value

  dize

  HTTP üstbilgisinin değeri.

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

İndirme işlemi şu anda sunucudan veri alıyor.

kesintiye uğradı

Bir hata nedeniyle dosya ana makinesiyle bağlantı kesildi.

complete

İndirme işlemi başarıyla tamamlandı.

Enum

"in_progress"

"interrupted"

"tamamlandı"

StringDelta

Özellikler

• akım

  string isteğe bağlı

• önceki

  string isteğe bağlı

UiOptions

Chrome 105 ve sonraki sürümler Chrome 148'den itibaren browser.*

Özellikler

• etkin

  boole

  İndirme kullanıcı arayüzünü etkinleştirir veya devre dışı bırakır.

Yöntemler

acceptDanger()

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

Kullanıcıdan tehlikeli bir indirme işlemini kabul etmesini isteme Yalnızca görünür bir bağlamdan (sekme, pencere veya sayfa/tarayıcı işlemi pop-up'ı) çağrılabilir. Tehlikeli indirmeleri otomatik olarak kabul etmez. İndirme işlemi kabul edilirse onChanged etkinliği tetiklenir, aksi takdirde hiçbir şey olmaz. Tüm veriler geçici bir dosyaya getirildiğinde ve indirme işlemi tehlikeli olmadığında veya tehlike kabul edildiğinde geçici dosya, hedef dosya adı olarak yeniden adlandırılır, state "tamamlandı" olarak değişir ve onChanged tetiklenir.

Parametreler

• downloadId

  sayı

  DownloadItem tanımlayıcısı.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Tehlike istemi iletişim kutusu kapandığında çözümlenen bir Promise döndürür.

cancel()

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

İndirme işlemini iptal etme callback çalıştırıldığında indirme işlemi iptal edilir, tamamlanır, kesintiye uğrar veya artık mevcut olmaz.

Parametreler

• downloadId

  sayı

  İptal edilecek indirme işleminin kimliği.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  İptal isteği tamamlandığında çözümlenen bir Promise döndürür.

download()

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

URL indirin. URL, HTTP[S] protokolünü kullanıyorsa istek, ana makine adı için ayarlanmış tüm çerezleri içerir. Hem filename hem de saveAs belirtilirse Farklı Kaydet iletişim kutusu, belirtilen filename ile önceden doldurulmuş olarak gösterilir. İndirme işlemi başarıyla başladıysa callback, yeni DownloadItem'nin downloadId değeriyle çağrılır. İndirme işlemi başlatılırken bir hata oluşursa callback, downloadId=undefined ile çağrılır ve runtime.lastError açıklayıcı bir dize içerir. Hata dizelerinin sürümler arasında geriye dönük uyumlu kalacağı garanti edilmez. Uzantılar bu bilgileri ayrıştırmamalıdır.

Parametreler

• seçenekler

  DownloadOptions

  Neleri ve nasıl indireceğinizi öğrenin.

İadeler

• Promise<number>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Yeni DownloadItem kimliğiyle çözümlenen bir Promise döndürür.

erase()

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

İndirilen dosyayı silmeden eşleşen DownloadItem öğesini geçmişten silin. query ile eşleşen her DownloadItem için bir onErased etkinliği tetiklenir, ardından callback çağrılır.

Parametreler

• sorgu

  DownloadQuery

İadeler

• Promise<number[]>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

getFileIcon()

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

Belirtilen indirme işlemi için bir simge alın. Yeni indirme işlemlerinde, indirme işleminin hedef dosya adı belirlendikten sonra dosya simgeleri kullanılabilir (örneğin, onChanged, filename değişikliğiyle tetiklendiğinde). Dosya adı belirlenmeden önce simgeyi almaya çalışmak runtime.lastError üzerinden hataya neden olur. İndirme işlemi devam ederken bu işlev tarafından döndürülen resim, indirme işlemi tamamlandıktan sonra döndürülen resimden farklı olabilir. Simge alma işlemi, platforma bağlı olarak temel işletim sistemini veya araç setini sorgulayarak yapılır. Bu nedenle, döndürülen simge; indirme durumu, platform, kayıtlı dosya türleri ve görsel tema gibi çeşitli faktörlere bağlıdır. Dosya simgesi belirlenemezse runtime.lastError bir hata mesajı içerir.

Parametreler

• downloadId

  sayı

  İndirme işleminin tanımlayıcısı.

• seçenekler

  GetFileIconOptions isteğe bağlı

İadeler

• Promise<string | undefined>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  İndirme işlemini temsil eden bir resmin URL'siyle çözümlenen bir Promise döndürür.

open()

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

DownloadItem tamamlandıysa indirilen dosyayı hemen açar, aksi takdirde runtime.lastError aracılığıyla bir hata döndürür. Bu yöntem, "downloads" iznine ek olarak "downloads.open" iznini gerektirir. Öğe ilk kez açıldığında bir onChanged etkinliği tetiklenir. Bu yöntem yalnızca bir kullanıcı hareketine yanıt olarak çağrılabilir.

Parametreler

• downloadId

  sayı

  İndirilen dosyanın tanımlayıcısı.

İadeler

• Promise<void>

  Chrome 123 ve sonraki sürümler Chrome 148'den itibaren browser.*

pause()

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

İndirme işlemini duraklatın. İstek başarılı olduysa indirme işlemi duraklatılmış durumdadır. Aksi takdirde runtime.lastError bir hata mesajı içerir. İndirme etkin değilse istek başarısız olur.

Parametreler

• downloadId

  sayı

  Duraklatılacak indirmenin kimliği.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Duraklatma isteği tamamlandığında çözümlenen bir Promise döndürür.

removeFile()

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

İndirilen dosya varsa ve DownloadItem tamamlandıysa dosyayı kaldırın. Aksi takdirde runtime.lastError üzerinden bir hata döndürün.

Parametreler

• downloadId

  sayı

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

resume()

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

Duraklatılmış bir indirme işlemini devam ettirme İstek başarılı olduysa indirme işlemi devam eder ve duraklatılmaz. Aksi takdirde runtime.lastError bir hata mesajı içerir. İndirme etkin değilse istek başarısız olur.

Parametreler

• downloadId

  sayı

  Devam ettirilecek indirme işleminin kimliği.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Devam ettirme isteği tamamlandığında çözümlenen bir Promise döndürür.

search()

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

DownloadItem simgesini bulun. Tüm DownloadItem öğelerini almak için query değerini boş nesne olarak ayarlayın. Belirli bir DownloadItem almak için yalnızca id alanını ayarlayın. Çok sayıda öğe arasında gezinmek için orderBy: ['-startTime'] değerini ayarlayın, limit değerini sayfa başına öğe sayısına ayarlayın ve startedAfter değerini son sayfanın son öğesinin startTime değerine ayarlayın.

Parametreler

• sorgu

  DownloadQuery

İadeler

• Promise<DownloadItem[]>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

setShelfEnabled()

Chrome 117'den itibaren desteği sonlandırıldı

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

Bunun yerine setUiOptions kullanın.

Mevcut tarayıcı profiliyle ilişkili her pencerenin altındaki gri rafı etkinleştirin veya devre dışı bırakın. Raf, en az bir uzantı tarafından devre dışı bırakıldığı sürece devre dışı kalır. En az bir başka uzantı rafı devre dışı bırakmışken rafı etkinleştirmek, runtime.lastError üzerinden bir hata döndürür. "downloads" iznine ek olarak "downloads.shelf" izni gerekir.

Parametreler

• etkin

  boole

setUiOptions()

Chrome 105 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

Mevcut tarayıcı profiliyle ilişkili her pencerenin indirme kullanıcı arayüzünü değiştirin. En az bir uzantı UiOptions.enabled değerini false olarak ayarladığı sürece indirme kullanıcı arayüzü gizlenir. En az bir başka uzantı tarafından devre dışı bırakılmışken UiOptions.enabled ayarını doğru değerine ayarlamak, runtime.lastError üzerinden bir hata döndürür. "downloads" iznine ek olarak "downloads.ui" izni gerekir.

Parametreler

• seçenekler

  UiOptions

  İndirme kullanıcı arayüzünde yapılan bir değişikliği kapsülleyin.

İadeler

• Promise<void>

  Kullanıcı arayüzü güncellemesi tamamlandığında çözümlenen bir Promise döndürür.

show()

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

İndirilen dosyayı, dosya yöneticisindeki klasöründe gösterir.

Parametreler

• downloadId

  sayı

  İndirilen dosyanın tanımlayıcısı.

showDefaultFolder()

browser.downloads.showDefaultFolder(): void

Varsayılan İndirilenler klasörünü bir dosya yöneticisinde gösterir.

Etkinlikler

onChanged

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

DownloadItem'ın bytesReceived ve estimatedEndTime dışındaki özelliklerinden herhangi biri değiştiğinde bu etkinlik, downloadId ve değişen özellikleri içeren bir nesneyle tetiklenir.

Parametreler

• callback

  işlev

  callback parametresi şu şekilde görünür:

  (downloadDelta: DownloadDelta) => void

  • downloadDelta

    DownloadDelta

onCreated

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

Bu etkinlik, bir indirme işlemi başladığında DownloadItem nesnesiyle tetiklenir.

Parametreler

• callback

  işlev

  callback parametresi şu şekilde görünür:

  (downloadItem: DownloadItem) => void

  • downloadItem

    DownloadItem

onDeterminingFilename

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

Dosya adı belirleme işlemi sırasında uzantılara, hedef DownloadItem.filename değerini geçersiz kılma fırsatı verilir. Her uzantı, bu etkinlik için birden fazla işleyici kaydedemez. Her dinleyici, eşzamanlı veya eşzamansız olarak suggest işlevini tam olarak bir kez çağırmalıdır. Dinleyici, suggest işlevini eşzamansız olarak çağırırsa true değerini döndürmelidir. Dinleyici, suggest işlevini eşzamanlı olarak çağırmaz veya true değerini döndürmezse suggest otomatik olarak çağrılır. Tüm dinleyiciler suggest yöntemini çağırana kadar DownloadItem tamamlanmaz. Dinleyiciler, indirme işleminin dosya adı için downloadItem.filename kullanmasına izin vermek amacıyla suggest yöntemini herhangi bir bağımsız değişken olmadan çağırabilir veya hedef dosya adını geçersiz kılmak için suggest yöntemine bir suggestion nesnesi iletebilir. Dosya adını birden fazla uzantı geçersiz kılıyorsa dinleyicisi suggest işlevine bir suggestion nesnesi ileten son yüklenen uzantı geçerli olur. Hangi uzantının kazanacağı konusunda kafa karışıklığı yaşamamak için kullanıcılar çakışabilecek uzantıları yüklememelidir. İndirme işlemi download tarafından başlatılırsa ve hedef dosya adı, MIME türü ile geçici dosya adı belirlenmeden önce biliniyorsa download yerine filename değerini iletin.

Parametreler

• callback

  işlev

  callback parametresi şu şekilde görünür:

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

  • downloadItem

    DownloadItem

  • suggest

    işlev

    suggest parametresi şu şekilde görünür:

    (suggestion?: FilenameSuggestion) => void

    • öneri

      FilenameSuggestion isteğe bağlı

onErased

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

Bir indirme işlemi geçmişten silindiğinde downloadId ile tetiklenir.

Parametreler

• callback

  işlev

  callback parametresi şu şekilde görünür:

  (downloadId: number) => void

  • downloadId

    sayı