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

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

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

İ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

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

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

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ı