chrome.downloads

Açıklama

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

İzinler

downloads

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

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

Örnekler

chrome.downloads API'nin kullanımıyla ilgili basit örnekleri examples/api/downloads adresinde bulabilirsiniz. dizin. Diğer örnekler ve kaynak kodunun görüntülenmesiyle ilgili yardım için Örnekler bölümüne bakın.

Türler

BooleanDelta

Özellikler

• akım

  boole isteğe bağlı

• önceki

  boole isteğe bağlı

DangerType

dosya

İndirilen dosyanın adı şüpheli.

url

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

içerik

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

yaygın değildir

İndirmenin URL'si çok indirilen bir URL değil ve tehlikeli olabilir.

düzenleyen

İndirme, kötü amaçlı ikili programları dağıttığı bilinen bir ana makineden gelmiştir ve büyük olasılıkla tehlikelidir.

istenmeyen

İndirme işlemi istenmeyen veya güvenli olmayabilir. Ör. tarayıcı veya bilgisayar ayarlarında değişiklik yapabilir.

güvenli

İndirme işlemi, kullanıcının bilgisayarı için bilinen bir tehlike oluşturmamaktadır.

kabul edildi

Kullanıcı tehlikeli indirme işlemini kabul etti.

Enum

"file"

"url"

"content"

"yaygın olmayan"

"host"

"istenmeyen"

"güvenli"

"kabul edildi"

"allowlistedByPolicy"

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentAlert"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountComclaim"

"blockedScanFailed"

DoubleDelta

Özellikler

• akım

  sayı isteğe bağlı

• önceki

  sayı isteğe bağlı

DownloadDelta

Özellikler

• canResume

  BooleanDelta isteğe bağlı

  Varsa canResume ile ilgili değişiklik.

• tehlike

  StringDelta isteğe bağlı

  Varsa danger ile ilgili değişiklik.

• endTime

  StringDelta isteğe bağlı

  Varsa endTime ile ilgili değişiklik.

• hata

  StringDelta isteğe bağlı

  Varsa error ile ilgili değişiklik.

• mevcut

  BooleanDelta isteğe bağlı

  Varsa exists ile ilgili değişiklik.

• fileSize

  DoubleDelta isteğe bağlı

  Varsa fileSize ile ilgili değişiklik.

• filename

  StringDelta isteğe bağlı

  Varsa filename ile ilgili değişiklik.

• finalUrl

  StringDelta isteğe bağlı

  Chrome 54 ve sonraki sürümler 'nı inceleyin.

  Varsa finalUrl ile ilgili değişiklik.

• id

  sayı

  Değişen DownloadItem için id.

• mime

  StringDelta isteğe bağlı

  Varsa mime ile ilgili değişiklik.

• duraklatıldı

  BooleanDelta isteğe bağlı

  Varsa paused ile ilgili değişiklik.

• startTime

  StringDelta isteğe bağlı

  Varsa startTime ile ilgili değişiklik.

• durum

  StringDelta isteğe bağlı

  Varsa state ile ilgili değişiklik.

• totalBytes

  DoubleDelta isteğe bağlı

  Varsa totalBytes ile ilgili değişiklik.

• url

  StringDelta isteğe bağlı

  Varsa url ile ilgili değişiklik.

DownloadItem

Özellikler

• byExtensionId

  dize isteğe bağlı

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

• byExtensionName

  dize isteğe bağlı

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

• bytesReceived

  sayı

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

• canResume

  boolean

  İndirme devam ediyorsa ve duraklatıldıysa ya da kesintiye uğrarsa ve kesintiye uğradığı yerden devam ettirilebiliyorsa doğru değerini döndürür.

• tehlike

  DangerType

  Bu indirme işleminin güvenli olup olmadığını veya şüpheli olup olmadığının göstergesi.

• endTime

  dize isteğe bağlı

  ISO 8601 biçiminde, indirme işleminin sona erdiği zaman. Doğrudan Tarih oluşturucuya geçirilebilir: 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 neden kesintiye uğradığı? SERVER_ ile başlayan hatalardan birinin altında çok sayıda HTTP hatası gruplanabilir. Ağla ilgili hatalar NETWORK_ ile başlar, dosyayı dosya sistemine yazma işlemiyle ilgili hatalar FILE_ ile başlar ve kullanıcı tarafından başlatılan kesintiler USER_ ile başlar.

• estimatedEndTime

  dize isteğe bağlı

  ISO 8601 biçiminde indirme işleminin tamamlanacağı tahmini süre. Doğrudan Tarih oluşturucuya geçirilebilir: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

• mevcut

  boolean

  İ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ığı kontrolünü tetiklemek için search() işlevini çağırın. Durum kontrolü tamamlandığında, dosya silinmişse bir onChanged etkinliği tetiklenir. search() işlevi, geri dönmeden önce durum kontrolünün tamamlanmasını beklemez. Bu nedenle, search() işlevinden alınan sonuçlar, dosya sistemini doğru şekilde yansıtmayabilir. Ayrıca, search() gerektiği kadar sık çağrılabilir, ancak dosya varlığını her 10 saniyede bir defadan daha sık kontrol etmez.

• fileSize

  sayı

  Sıkıştırma işleminden sonra tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.

• filename

  dize

  Mutlak yerel yol.

• finalUrl

  dize

  Chrome 54 ve sonraki sürümler 'nı inceleyin.

  Tüm yönlendirmelerden sonra, bu indirme işleminin yapıldığı mutlak URL.

• id

  sayı

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

• gizli

  boolean

  Bu indirme geçmişe kaydedilirse false, kaydedilmezse true değerini alır.

• mime

  dize

  Dosyanın MIME türü.

• duraklatıldı

  boolean

  İndirme işlemi ana makineden gelen verileri okumayı durdurup bağlantıyı açık tuttuysa doğru değerini döndürür.

• yönlendiren

  dize

  Mutlak URL.

• startTime

  dize

  ISO 8601 biçiminde indirme işleminin başladığı zaman. Doğrudan Tarih oluşturucuya geçirilebilir: 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ırması dikkate alınmadan tüm dosyadaki bayt sayısı veya bilinmiyorsa -1 olur.

• url

  dize

  Bu indirme işleminin herhangi bir yönlendirmeden önce başlattığı mutlak URL.

DownloadOptions

Özellikler

• gövde

  dize isteğe bağlı

  Yayın gövdesi.

• conflictAction

  FilenameConflictAction isteğe bağlı

  filename zaten varsa yapılacak işlem.

• filename

  dize isteğe bağlı

  Muhtemelen alt dizinler de içeren, indirilen dosyayı içerecek İndirilenler dizinine bağlı bir dosya yolu. Mutlak yollar, boş yollar ve geriye referanslar ".." içeren yollar bir hataya neden olur. onDeterminingFilename, dosyanın MIME türü ve geçici bir dosya adı belirlendikten sonra dosya adının önerilmesine olanak tanır.

• üst bilgiler

  HeaderNameValuePair[] isteğe bağlı

  URL, HTTP[s] protokolünü kullanıyorsa istekle birlikte gönderilecek fazladan HTTP üstbilgileri. Her üst bilgi, XMLHttpRequest tarafından izin verilenlerle sınırlı olmak üzere name ve value ya da binaryValue anahtarlarını içeren bir sözlük olarak gösterilir.

• method

  HttpMethod isteğe bağlı

  URL'nin HTTP[S] protokolünü kullanması durumunda kullanılacak HTTP yöntemi.

• saveAs

  boole isteğe bağlı

  filename kullanıcısının ayarlanmış veya zaten mevcut olmasına bakılmaksızın, kullanıcının dosya adı seçmesine izin vermek için bir dosya seçici kullanın.

• url

  dize

  İndirilecek URL.

DownloadQuery

Özellikler

• bytesReceived

  sayı isteğe bağlı

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

• tehlike

  DangerType isteğe bağlı

  Bu indirme işleminin güvenli olup olmadığını veya şüpheli olup olmadığının göstergesi.

• endTime

  dize isteğe bağlı

  ISO 8601 biçiminde, indirme işleminin sona erdiği zaman.

• endedAfter

  dize isteğe bağlı

  ISO 8601 biçiminde belirtilen ms.den sonra sona eren sonuçları DownloadItem ile sınırlar

• endedBefore

  dize isteğe bağlı

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

• hata

  InterruptReason isteğe bağlı

  İndirme işleminin neden kesintiye uğradığı?

• mevcut

  boole isteğe bağlı

  İndirilen dosyanın mevcut olup olmadığı;

• fileSize

  sayı isteğe bağlı

  Sıkıştırma işleminden sonra tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.

• filename

  dize isteğe bağlı

  Mutlak yerel yol.

• filenameRegex

  dize isteğe bağlı

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

• finalUrl

  dize isteğe bağlı

  Chrome 54 ve sonraki sürümler 'nı inceleyin.

  Tüm yönlendirmelerden sonra, bu indirme işleminin yapıldığı mutlak URL.

• finalUrlRegex

  dize isteğe bağlı

  Chrome 54 ve sonraki sürümler 'nı inceleyin.

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

• id

  sayı isteğe bağlı

  Sorgulanacak DownloadItem öğesinin id öğesi.

• sınır

  sayı isteğe bağlı

  Maksimum sayıda eşleşen DownloadItem döndürüldü. Varsayılan olarak 1.000 değerine ayarlanır. Eşleşen tüm DownloadItem öğelerini döndürmek için 0 değerine ayarlayın. Sonuçların sayfaları arasında nasıl gezinileceğini öğrenmek için bkz. search.

• mime

  dize 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'] ayarlandığında DownloadItem başlangıç zamanına göre artan düzende sıralanır. Azalan sırayı belirtmek için başına kısa çizgi ekleyin: "-startTime".

• duraklatıldı

  boole isteğe bağlı

  İndirme işlemi ana makineden gelen verileri okumayı durdurup bağlantıyı açık tuttuysa doğru değerini döndürür.

• sorgu

  string[] isteğe bağlı

  Bu arama terimleri dizisi, sonuçları tire ("-") ile başlamayan tüm arama terimlerini filename veya url ya da finalUrl içeren DownloadItem ile sınırlandırır ve tireyle başlayan arama terimlerinin hiçbirinin olmaması.

• startTime

  dize isteğe bağlı

  ISO 8601 biçiminde indirme işleminin başladığı zaman.

• startedAfter

  dize isteğe bağlı

  Sonuçları, ISO 8601 biçiminde belirtilen ms.den sonra başlayan DownloadItem ile sınırlandırır.

• startedBefore

  dize isteğe bağlı

  ISO 8601 biçiminde, belirtilen ms.den önce başlayan sonuçları 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

  sayı isteğe bağlı

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

• totalBytesGreater

  sayı isteğe bağlı

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

• totalBytesLess

  sayı isteğe bağlı

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

• url

  dize isteğe bağlı

  Bu indirme işleminin herhangi bir yönlendirmeden önce başlattığı mutlak URL.

• urlRegex

  dize isteğe bağlı

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

FilenameConflictAction

tek

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

üzerine yazmak

Yeni dosya, mevcut dosyanın üzerine yazılır.

istem

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

Enum

"uniquify"

"üzerine yaz"

"istem"

FilenameSuggestion

Özellikler

• conflictAction

  FilenameConflictAction isteğe bağlı

  filename zaten varsa yapılacak işlem.

• filename

  dize

  Kullanıcının varsayılan İndirilenler dizinine göre muhtemelen alt dizinler içeren yeni DownloadItem hedefi DownloadItem.filename. Mutlak yollar, boş yollar ve geriye referanslar ".." içeren yollar yok sayılır. Uzantı tarafından kaydedilen onDeterminingFilename işleyici varsa filename yoksayılır.

GetFileIconOptions

Özellikler

• beden

  sayı isteğe bağlı

  Döndürülen simgenin boyutu. Simge, boyutlarda * boyut piksellerinde kare şeklinde olacaktır. Simgenin varsayılan ve en büyük boyutu 32x32 pikseldir. Yalnızca 16 ve 32 boyutları desteklenir. Diğer boyutların belirtilmesi hatadır.

HeaderNameValuePair

Özellikler

• ad

  dize

  HTTP üstbilgisinin adı.

• value

  dize

  HTTP üst bilgisinin değeri.

HttpMethod

Enum

"AL"

"YAYINLA"

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"

"KİLİTLENME"

State

in_progress

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

kesintiye uğradı

Bir hata nedeniyle dosya barındırıcısıyla bağlantı kesildi.

complete

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

Enum

"in_progress"

"kesintili"

"complete"

StringDelta

Özellikler

• akım

  dize isteğe bağlı

• önceki

  dize isteğe bağlı

UiOptions

Chrome 105 ve sonraki sürümler 'nı inceleyin.

Özellikler

• etkin

  boolean

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

Yöntemler

acceptDanger()

Söz 'nı inceleyin.

chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
)

Kullanıcıdan tehlikeli bir indirme işlemini kabul etmesini iste. 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 kabul edilirse bir 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ıyla yeniden adlandırılır, state "tamamlandı" olarak değiştirilir ve onChanged tetiklenir.

Parametreler

• downloadId

  sayı

  DownloadItem için tanımlayıcı.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<void>

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

cancel()

Söz 'nı inceleyin.

chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
)

İ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 değildir.

Parametreler

• downloadId

  sayı

  İptal edilecek indirme işleminin kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<void>

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

download()

Söz 'nı inceleyin.

chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
)

URL indirin. URL'de HTTP[S] protokolü kullanılıyorsa istek, ana makine adı için halihazırda ayarlanmış olan tüm çerezleri içerir. Hem filename hem de saveAs belirtilirse Farklı Kaydet iletişim kutusu, belirtilen filename ile önceden doldurulmuş olarak görüntülenir. İndirme işlemi başarıyla başlatıldıysa callback, yeni DownloadItem cihazının downloadId ile çağrılır. İndirme işlemi başlatılırken bir hata oluştuysa 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 olmaya devam edeceği garanti edilmez. Uzantılar bunu ayrıştırmamalıdır.

Parametreler

• seçenekler

  DownloadOptions

  Ne indirmeli, nasıl indirmelisiniz?

• geri çağırma

  işlev isteğe bağlı

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

  (downloadId: number) => void

  • downloadId

    sayı

İadeler

• Promise&lt;number&gt;

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

erase()

Söz 'nı inceleyin.

chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
)

İ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

• geri çağırma

  işlev isteğe bağlı

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

  (erasedIds: number[]) => void

  • erasedIds

    numara[]

İadeler

• Vaat<sayı[]>

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getFileIcon()

Söz 'nı inceleyin.

chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
  callback?: function,
)

Belirtilen indirme için bir simge alın. Yeni indirilenler için dosya simgeleri onCreated etkinliği alındıktan sonra kullanılabilir. İndirme işlemi devam ederken bu işlevin döndürdüğü görüntü, indirme işlemi tamamlandıktan sonra döndürülen görüntüden farklı olabilir. Simge alma işlemi, platforma bağlı olarak temel işletim sistemi veya araç seti sorgulanarak yapılır. Bu nedenle, döndürülen simge; indirme durumu, platform, kayıtlı dosya türleri ve görsel tema dahil olmak üzere çeşitli faktörlere bağlı olacaktır. Dosya simgesi belirlenemezse runtime.lastError bir hata mesajı içerir.

Parametreler

• downloadId

  sayı

  İndirme işlemine ilişkin tanımlayıcı.

• seçenekler

  GetFileIconOptions isteğe bağlı

• geri çağırma

  işlev isteğe bağlı

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

  (iconURL?: string) => void

  • iconURL

    dize isteğe bağlı

İadeler

• Söz<dize | tanımlanmadı>

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

open()

Söz 'nı inceleyin.

chrome.downloads.open(
  downloadId: number,
  callback?: function,
)

DownloadItem tamamlandıysa indirilen dosyayı şimdi açar; aksi takdirde runtime.lastError aracılığıyla hata döndürür. Bu yöntem için "downloads" izninin yanı sıra "downloads.open" izni de gerekir. Öğe ilk kez açıldığında bir onChanged etkinliği tetiklenir. Bu yöntem yalnızca kullanıcı hareketine yanıt olarak çağrılabilir.

Parametreler

• downloadId

  sayı

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

• geri çağırma

  işlev isteğe bağlı

  Chrome 123 ve sonraki sürümler 'nı inceleyin.

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

  () => void

İadeler

• Taahhüt<void>

  Chrome 123 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

pause()

Söz 'nı inceleyin.

chrome.downloads.pause(
  downloadId: number,
  callback?: function,
)

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

Parametreler

• downloadId

  sayı

  Duraklatılacak indirmenin kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<void>

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeFile()

Söz 'nı inceleyin.

chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
)

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

Parametreler

• downloadId

  sayı

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<void>

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

resume()

Söz 'nı inceleyin.

chrome.downloads.resume(
  downloadId: number,
  callback?: function,
)

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

Parametreler

• downloadId

  sayı

  Devam ettirilecek indirme işleminin kimliği.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<void>

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

search()

Söz 'nı inceleyin.

chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
)

DownloadItem uygulamasını bulun. Tüm DownloadItem öğelerini almak için query öğesini boş nesneye ayarlayın. Belirli bir DownloadItem öğesini elde etmek için yalnızca id alanını ayarlayın. Çok sayıda öğe arasında sayfalar arasında geçiş yapmak için orderBy: ['-startTime'] öğesini, limit öğesini sayfa başına öğe sayısı ve startedAfter öğesini de son sayfadaki son öğe için startTime olarak ayarlayın.

Parametreler

• sorgu

  DownloadQuery

• geri çağırma

  işlev isteğe bağlı

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

  (results: DownloadItem[]) => void

  • sonuç

    DownloadItem[]

İadeler

• Promise&lt;DownloadItem[]&gt;

  Chrome 96 ve sonraki sürümler 'nı inceleyin.

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setShelfEnabled()

Chrome 117'den bu yana desteği sonlandırıldı

chrome.downloads.setShelfEnabled(
  enabled: boolean,
)

Bunun yerine setUiOptions alanını kullanın.

Geçerli tarayıcı profiliyle ilişkili her pencerenin en altındaki gri rafı etkinleştirin veya devre dışı bırakın. En az bir uzantı devre dışı bıraktığı sürece raf devre dışı bırakılır. En az bir diğer uzantı devre dışıyken rafı etkinleştirirseniz runtime.lastError üzerinden hata döndürülür. "downloads" iznine ek olarak "downloads.shelf" iznini gerektirir.

Parametreler

• etkin

  boolean

setUiOptions()

Söz Chrome 105 ve sonraki sürümler

chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
)

Mevcut tarayıcı profiliyle ilişkili her pencerenin indirme kullanıcı arayüzünü değiştirin. En az bir uzantı UiOptions.enabled özelliğini false (yanlış) değerine ayarladığı sürece indirme kullanıcı arayüzü gizlenir. En az bir diğer uzantı devre dışıyken UiOptions.enabled doğru değerine ayarlanırsa runtime.lastError boyunca hata döndürülür. "downloads" iznine ek olarak "downloads.ui" iznini gerektirir.

Parametreler

• seçenekler

  UiOptions

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

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<void>

  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

show()

chrome.downloads.show(
  downloadId: number,
)

İndirilen dosyayı bir dosya yöneticisindeki klasöründe görüntüleyin.

Parametreler

• downloadId

  sayı

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

showDefaultFolder()

chrome.downloads.showDefaultFolder()

Bir dosya yöneticisinde varsayılan İndirilenler klasörünü gösterin.

Etkinlikler

onChanged

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

DownloadItem özelliğinin bytesReceived ve estimatedEndTime dışındaki özelliklerinden herhangi biri değiştiğinde bu etkinlik, downloadId ve değişen özellikleri içeren bir nesne ile birlikte tetiklenir.

Parametreler

• geri çağırma

  işlev

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

  (downloadDelta: DownloadDelta) => void

  • downloadDelta

    DownloadDelta

onCreated

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

Bir indirme işlemi başladığında bu etkinlik DownloadItem nesnesiyle tetiklenir.

Parametreler

• geri çağırma

  işlev

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

  (downloadItem: DownloadItem) => void

  • downloadItem

    DownloadItem

onDeterminingFilename

chrome.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 işleyici, eşzamanlı veya eşzamansız olarak suggest öğesini tam olarak bir kez çağırmalıdır. İşleyici suggest öğesini eşzamansız olarak çağırırsa true döndürmelidir. İşleyici suggest öğesini eşzamanlı olarak çağırmaz veya true döndürürse suggest otomatik olarak çağrılır. Tüm dinleyiciler suggest adlı kullanıcıyı çağırana kadar DownloadItem tamamlanmaz. Dinleyiciler, indirmenin dosya adı olarak downloadItem.filename kullanmasına izin vermek için suggest öğesini herhangi bir bağımsız değişken olmadan çağırabilir veya hedef dosya adını geçersiz kılmak için suggest öğesine bir suggestion nesnesi iletebilir. Dosya adını birden fazla uzantı geçersiz kılarsa, dinleyicisi suggest öğesine suggestion nesnesi ileten son yüklü uzantı kazanır. Hangi uzantının kazanacağına dair karışıklığı önlemek için kullanıcılar çakışabilecek uzantıları yüklememelidir. İndirme işlemi download tarafından başlatılıyorsa ve hedef dosya adı, MIME türü ve geçici dosya adı belirlenmeden önce biliniyorsa bunun yerine filename öğesini download hizmetine iletin.

Parametreler

• geri çağırma

  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

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

Geçmişten silinen bir indirme işlemi olduğunda downloadId ile tetiklenir.

Parametreler

• geri çağırma

  işlev

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

  (downloadId: number) => void

  • downloadId

    sayı