chrome.downloads

refresh date: 2026-09-25 robots: noindex

Bu izin uyarı tetikler

Açıklama

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

İzinler

downloads

Manifest

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

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

Örnekler

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

Türler

BooleanDelta

Özellikler

  • akım

    boolean isteğe bağlı

  • önceki

    boolean isteğe bağlı

DangerType

Enum

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

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

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

"uncommon"
İndirilen dosyanın URL'si çok indirilen bir URL olmadığı için tehlikeli olabilir.

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

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

"güvenli"
İndirme, kullanıcının bilgisayarı için bilinen bir tehlike oluşturmuyor.

"accepted"
Kullanıcı, tehlikeli indirmeyi kabul etti.

"allowlistedByPolicy"
Kurumsal 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. Gerekli olduğunda Chrome, diske indirme işlemini engeller ve dosyayı doğrudan Google Drive'a indirir.

"forceSaveToOnedrive"
Secure Enterprise Browser uzantısı tarafından kullanılır. Gerekli olduğunda Chrome, diske indirmeyi 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).

  • tehlike

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

  • var

    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 veya daha yeni bir sürüm

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

  • id

    sayı

    Değişen DownloadItem id.

  • 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

    dize isteğe bağlı

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

  • byExtensionName

    dize isteğe bağlı

    Bu indirme bir uzantı tarafından başlatıldıysa indirmeyi 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 işlemi dikkate alınmadan, ana makineden şu ana kadar alınan bayt sayısı.

  • canResume

    boole

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

  • tehlike

    DangerType

    Bu indirmenin güvenli olduğu mu düşünülüyor yoksa şüpheli olduğu mu biliniyor?

  • endTime

    dize isteğe bağlı

    İndirmenin 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. Çeşitli HTTP hataları, SERVER_ ile başlayan hatalardan biri altında gruplandırılabilir. Ağla ilgili hatalar NETWORK_ ile, dosyanın dosya sistemine yazılmasıyla ilgili hatalar FILE_ ile, kullanıcı tarafından başlatılan kesintiler ise USER_ ile başlar.

  • estimatedEndTime

    dize isteğe bağlı

    İndirme işleminin tamamlanacağı tahmini süre (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))})})

  • var

    boole

    İndirilen dosyanın hâlâ mevcut olup olmadığı Chrome, dosyaların kaldırılmasını otomatik olarak izlemediği için bu bilgiler güncel olmayabilir. Dosyanın varlığıyla ilgili kontrolü tetiklemek için search numaralı telefonu arayın. Dosyanın varlığı kontrolü tamamlandığında, dosya silinmişse onChanged etkinliği tetiklenir. search() işlevinin, döndürmeden önce varlık kontrolünün tamamlanmasını beklemediğini unutmayın. Bu nedenle, search() işlevinden elde edilen sonuçlar dosya sistemini doğru şekilde yansıtmayabilir. Ayrıca, search() gerektiği kadar sık çağrılabilir ancak dosyanın varlığı 10 saniyede birden daha sık kontrol edilmez.

  • fileSize

    sayı

    Sıkıştırma sonrası dosyanın tamamındaki bayt sayısı veya bilinmiyorsa -1.

  • filename

    dize

    Mutlak yerel yol.

  • finalUrl

    dize

    Chrome 54 veya daha yeni bir sürüm

    Bu indirmenin yapıldığı mutlak URL (tüm yönlendirmelerden sonra).

  • id

    sayı

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

  • incognito

    boole

    Bu indirme işlemine geçmişte yer veriliyorsa yanlış, yer verilmiyorsa 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.

  • yönlendiren

    dize

    Mutlak URL.

  • startTime

    dize

    ISO 8601 biçiminde belirtilen, indirme işleminin başladığı zaman. 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 edip etmediğini, kesintiye uğrayıp uğramadığını veya tamamlanıp tamamlanmadığını gösterir.

  • totalBytes

    sayı

    Dosya sıkıştırma işlemi dikkate alınmadan dosyanın tamamındaki bayt sayısı veya bilinmiyorsa -1.

  • url

    dize

    Bu indirmenin başlatıldığı mutlak URL (yönlendirmelerden önce).

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ı

    İndirilen dosyayı içerecek olan, İndirilenler dizinine göre göreceli 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 dosya adı belirlendikten sonra dosya adı önermeye olanak tanır.

  • başlıklar

    HeaderNameValuePair[] isteğe bağlı

    URL, HTTP[s] protokolünü kullanıyorsa istekle birlikte gönderilecek ek HTTP başlıkları. Her üstbilgi, name anahtarlarını ve XMLHttpRequest tarafından izin verilenlerle sınırlı olmak üzere value veya binaryValue anahtarlarını içeren bir sözlük olarak gösterilir.

  • method

    HttpMethod isteğe bağlı

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

  • saveAs

    boolean isteğe bağlı

    filename ayarlanmış olsun veya olması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

    number isteğe bağlı

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

  • tehlike

    DangerType isteğe bağlıdır.

    Bu indirmenin güvenli olduğu mu düşünülüyor yoksa şüpheli olduğu mu biliniyor?

  • endTime

    dize isteğe bağlı

    İndirmenin sona erdiği zaman (ISO 8601 biçiminde).

  • endedAfter

    dize isteğe bağlı

    Sonuçları, ISO 8601 biçiminde belirtilen milisaniye değerinden sonra sona eren DownloadItem ile sınırlar.

  • endedBefore

    dize isteğe bağlı

    Sonuçları, ISO 8601 biçiminde verilen ms'den önce sona eren DownloadItem ile sınırlar.

  • hata

    InterruptReason isteğe bağlı

    İndirme işleminin kesintiye uğrama nedeni.

  • var

    boolean isteğe bağlı

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

  • fileSize

    number isteğe bağlı

    Sıkıştırma sonrası dosyanın tamamındaki bayt sayısı veya bilinmiyorsa -1.

  • filename

    dize isteğe bağlı

    Mutlak yerel yol.

  • filenameRegex

    dize isteğe bağlı

    Sonuçları, filename'si verilen normal ifadeyle eşleşen DownloadItem ile sınırlar.

  • finalUrl

    dize isteğe bağlı

    Chrome 54 veya daha yeni bir sürüm

    Bu indirmenin yapıldığı mutlak URL (tüm yönlendirmelerden sonra).

  • finalUrlRegex

    dize isteğe bağlı

    Chrome 54 veya daha yeni bir sürüm

    Sonuçları, finalUrl'si verilen normal ifadeyle eşleşen DownloadItem ile sınırlar.

  • id

    number isteğe bağlı

    Sorgulanacak DownloadItem'ın id.

  • sınır

    number isteğe bağlı

    Döndürülen maksimum eşleşen DownloadItem sayısı. Varsayılan olarak 1.000 değerine ayarlanır. Eşleşen tüm DownloadItem öğelerini döndürmek için 0 olarak ayarlayın. Sonuçlar arasında nasıl gezineceğinizi öğrenmek için search başlıklı makaleyi inceleyin.

  • 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 tire ile önek ekleyin: "-startTime".

  • duraklatıldı

    boolean isteğe bağlı

    İndirme işlemi ana makineden veri okumayı durdurduysa ancak bağlantıyı açık tuttuysa doğru.

  • sorgu

    string[] isteğe bağlı

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

  • startTime

    dize isteğe bağlı

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

  • startedAfter

    dize isteğe bağlı

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

  • startedBefore

    dize isteğe bağlı

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

  • durum

    State isteğe bağlı

    İndirme işleminin devam edip etmediğini, kesintiye uğrayıp uğramadığını veya tamamlanıp tamamlanmadığını gösterir.

  • totalBytes

    number isteğe bağlı

    Dosya sıkıştırma işlemi dikkate alınmadan dosyanın tamamındaki bayt sayısı veya bilinmiyorsa -1.

  • totalBytesGreater

    number isteğe bağlı

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

  • totalBytesLess

    number isteğe bağlı

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

  • url

    dize isteğe bağlı

    Bu indirmenin başlatıldığı mutlak URL (yönlendirmelerden önce).

  • urlRegex

    dize isteğe bağlı

    Sonuçları, url'si verilen normal ifadeyle eşleşen DownloadItem ile sınırlar.

FilenameConflictAction

benzersiz hale getirme

Çakışmayı ö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"

"overwrite"

"prompt"

FilenameSuggestion

Özellikler

  • conflictAction

    FilenameConflictAction isteğe bağlı

    filename zaten varsa yapılacak işlem.

  • filename

    dize

    DownloadItem'ın yeni hedef DownloadItem.filename'ı. Kullanıcının varsayılan İndirilenler dizinine göre bir yol olarak alt dizinler içerebilir. Mutlak yollar, boş yollar ve geri referanslar ".." içeren yollar yoksayılır. Uzantılar tarafından kaydedilen onDeterminingFilename dinleyicileri 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ın ölçeklendirme faktörüne göre ölçeklendirilir (ör. 2x ekranda 32 boyut için 64x64 piksel). Arka plan hizmeti çalışanlarından gelen çağrılar varsayılan olarak 1x ölçeklidir.

HeaderNameValuePair

Özellikler

  • ad

    dize

    HTTP başlığının 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ı

Dosya barındırıcısıyla bağlantı bir hata nedeniyle kesildi.

complete

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

Enum

"in_progress"

"interrupted"

"complete"

StringDelta

Özellikler

  • akım

    dize isteğe bağlı

  • önceki

    dize isteğe bağlı

UiOptions

Chrome 105 veya daha yeni bir sürüm

Özellikler

  • etkin

    boole

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

Yöntemler

acceptDanger()

Promise 
chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
): Promise<void>

Kullanıcıyı tehlikeli bir indirme işlemini kabul etmeye yönlendirme 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 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 ya da tehlike kabul edildiğinde geçici dosyanın adı hedef dosya adı olarak değiştirilir, state "tamamlandı" olarak değişir ve onChanged tetiklenir.

Parametreler

  • downloadId

    sayı

    DownloadItem kimliği.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

cancel()

Promise 
chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
): 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 değildir.

Parametreler

  • downloadId

    sayı

    İptal edilecek indirmenin kimliği.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

download()

Promise 
chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
): Promise<number>

URL indirin. URL, HTTP[S] protokolünü kullanıyorsa istek, ana makine adı için şu anda ayarlanmış tüm çerezleri içerir. Hem filename hem de saveAs belirtilmişse belirtilen filename ile önceden doldurulmuş Farklı Kaydet iletişim kutusu gösterilir. İndirme işlemi başarıyla başladıysa callback, yeni DownloadItem'nin downloadId ile çağrılır. İndirme başlatılırken bir hata oluştuysa callback, downloadId=undefined ile birlikte ç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 uyumluluğu garanti edilmez. Uzantılar bunu ayrıştırmamalıdır.

Parametreler

  • seçenekler

    DownloadOptions

    Ne indireceğiniz ve nasıl indireceğiniz.

  • callback

    işlev isteğe bağlı

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

    (downloadId: number) => void

    • downloadId

      sayı

İadeler

  • Promise<number>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

erase()

Promise 
chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
): Promise<number[]>

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

Parametreler

  • callback

    işlev isteğe bağlı

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

    (erasedIds: number[]) => void

    • erasedIds

      number[]

İadeler

  • Promise<number[]>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getFileIcon()

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

Belirtilen indirme için bir simge alın. Yeni indirmelerde, dosya simgeleri indirme işleminin hedef dosya adı belirlendikten sonra (örneğin, filename değişikliğiyle onChanged tetiklendiğinde) kullanılabilir. 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 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 gibi çeşitli faktörlere bağlıdır. Dosya simgesi belirlenemezse runtime.lastError hata mesajı içerir.

Parametreler

  • downloadId

    sayı

    İndirmenin tanımlayıcısı.

  • seçenekler

    GetFileIconOptions isteğe bağlı

  • callback

    işlev isteğe bağlı

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

    (iconURL?: string) => void

    • iconURL

      dize isteğe bağlı

İadeler

  • Promise<string | undefined>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

open()

Promise 
chrome.downloads.open(
  downloadId: number,
  callback?: function,
): Promise<void>

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

Parametreler

  • downloadId

    sayı

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

  • callback

    işlev isteğe bağlı

    Chrome 123+

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

    () => void

İadeler

  • Promise<void>

    Chrome 123+

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

pause()

Promise 
chrome.downloads.pause(
  downloadId: number,
  callback?: function,
): Promise<void>

İndirmeyi duraklatın. İstek başarılıysa indirme işlemi duraklatılmış durumdadır. 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.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeFile()

Promise 
chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
): Promise<void>

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

Parametreler

  • downloadId

    sayı

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

resume()

Promise 
chrome.downloads.resume(
  downloadId: number,
  callback?: function,
): Promise<void>

Duraklatılmış bir indirme işlemine devam etme İstek başarılı olduysa indirme işlemi devam eder ve duraklatılmaz. 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.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Promise 
chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
): Promise<DownloadItem[]>

DownloadItem bulun. Tüm DownloadItem değerlerini 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 olarak, limit değerini sayfa başına öğe sayısı olarak ve startedAfter değerini son sayfadaki son öğenin startTime olarak ayarlayın.

Parametreler

İadeler

  • Promise<DownloadItem[]>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setShelfEnabled()

Chrome 117'den beri kullanımdan kaldırıldı
chrome.downloads.setShelfEnabled(
  enabled: boolean,
): void

Bunun yerine setUiOptions kullanın.

Geçerli tarayıcı profiliyle ilişkili her pencerenin alt kısmındaki gri rafı etkinleştirin veya devre dışı bırakın. En az bir uzantı devre dışı bıraktığı sürece raf devre dışı kalır. En az bir uzantı rafı devre dışı bırakmışken rafı etkinleştirmek runtime.lastError üzerinden hata döndürür. "downloads" iznine ek olarak "downloads.shelf" izni gerekir.

Parametreler

  • etkin

    boole

setUiOptions()

Promise Chrome 105 ve sonraki sürümler 
chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
): Promise<void>

Mevcut tarayıcı profiliyle ilişkili her pencerenin indirme kullanıcı arayüzünü değiştirir. 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ı devre dışı bırakmışken UiOptions.enabled değerini true olarak ayarlamak, runtime.lastError üzerinden 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 kapsar.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

show()

chrome.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()

chrome.downloads.showDefaultFolder(): void

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

Etkinlikler

onChanged

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

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

Parametreler

  • callback

    işlev

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

    (downloadDelta: DownloadDelta) => void

onCreated

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

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

Parametreler

  • callback

    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'yi geçersiz kılma fırsatı verilir. Her uzantı, bu etkinlik için birden fazla işleyici kaydedemez. Her dinleyici, suggest işlevini senkron veya asenkron olarak 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ğırmazsa veya true değerini döndürmezse suggest işlevi otomatik olarak çağrılır. Tüm dinleyiciler suggest'ı aramadığı sürece DownloadItem tamamlanmaz. Dinleyiciler, indirme işleminin dosya adı olarak downloadItem.filename kullanmasına izin vermek için suggest işlevini herhangi bir bağımsız değişken olmadan çağırabilir veya hedef dosya adını geçersiz kılmak için suggest işlevine bir suggestion nesnesi iletebilir. Dosya adını birden fazla uzantı geçersiz kılıyorsa dinleyicisi suggestion nesnesini suggest'ye ileten, en son yüklenen uzantı kazanır. Hangi uzantının kazanacağı konusunda karışıklık yaşanmaması için kullanıcılar çakışabilecek uzantıları yüklememelidir. İndirme işlemi download tarafından başlatılırsa ve MIME türü ile geçici dosya adı belirlenmeden önce hedef dosya adı biliniyorsa filename yerine download iletin.

Parametreler

onErased

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

İndirme geçmişten silindiğinde downloadId ile birlikte tetiklenir.

Parametreler

  • callback

    işlev

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

    (downloadId: number) => void

    • downloadId

      sayı