chrome.downloads

Bu izin uyarı tetikler.

Açıklama

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

İzinler

downloads

Manifest

Bu API'yi kullanmak için "downloads" iznini uzantı manifestinde belirtmeniz 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 kodunu görüntüleme konusunda yardım için Örnekler bölümüne bakın.

Türler

BooleanDelta

Özellikler

  • akım

    boolean isteğe bağlı

  • önceki

    boolean isteğe bağlı

DangerType

dosya

İndirilen dosyanın adı şüpheli.

url

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

içerik

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

yaygın değildir

İndirilen dosyanın URL'si yaygın olarak indirilmediği için tehlikeli olabilir.

düzenleyen

İndirilen dosya, kötü amaçlı ikili dosyalar dağıttığı bilinen bir barındırıcıdan geldiği için tehlikeli olabilir.

istenmeyen

İndirme işlemi istenmeyen bir durum olabilir veya güvenli olmayabilir. Örneğin, 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şturmaz.

kabul edildi

Kullanıcı, tehlikeli indirme işlemini kabul etmiştir.

Enum

"file"

"url"

"content"

"uncommon"

"host"

"unwanted"

"safe"

"accepted"

"allowlistedByPolicy"

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

DoubleDelta

Özellikler

  • akım

    number isteğe bağlı

  • önceki

    number isteğe bağlı

DownloadDelta

Özellikler

  • canResume

    BooleanDelta isteğe bağlı

    Varsa canResume metriğindeki değişiklik.

  • tehlike

    StringDelta isteğe bağlı

    Varsa danger metriğindeki değişiklik.

  • endTime

    StringDelta isteğe bağlı

    Varsa endTime metriğindeki değişiklik.

  • hata

    StringDelta isteğe bağlı

    Varsa error metriğindeki değişiklik.

  • exists

    BooleanDelta isteğe bağlı

    Varsa exists metriğindeki değişiklik.

  • fileSize

    DoubleDelta isteğe bağlı

    Varsa fileSize metriğindeki değişiklik.

  • filename

    StringDelta isteğe bağlı

    Varsa filename metriğindeki değişiklik.

  • finalUrl

    StringDelta isteğe bağlı

    Chrome 54 veya daha yeni bir sürüm

    Varsa finalUrl metriğindeki değişiklik.

  • id

    sayı

    Değişen DownloadItem id.

  • mime

    StringDelta isteğe bağlı

    Varsa mime metriğindeki değişiklik.

  • duraklatıldı

    BooleanDelta isteğe bağlı

    Varsa paused metriğindeki değişiklik.

  • startTime

    StringDelta isteğe bağlı

    Varsa startTime metriğindeki değişiklik.

  • durum

    StringDelta isteğe bağlı

    Varsa state metriğindeki değişiklik.

  • totalBytes

    DoubleDelta isteğe bağlı

    Varsa totalBytes metriğindeki değişiklik.

  • url

    StringDelta isteğe bağlı

    Varsa url metriğindeki değişiklik.

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ı. Ayarlanırsa değiştirilmez.

  • 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

    boolean

    İndirme işlemi devam ediyorsa ve duraklatılmışsa veya kesintiye uğramışsa ve kesintiye uğradığı yerden devam ettirilebiliyorsa doğru (true) 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 birinin 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))})})

  • exists

    boolean

    İ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() işlevini çağırı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 sıklıkta ç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ı.

  • gizli

    boolean

    Bu indirme geçmişe kaydedilmişse false, kaydedilmemişse true.

  • mime

    dize

    Dosyanın MIME türü.

  • duraklatıldı

    boolean

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

  • yönlendiren

    dize

    Mutlak URL.

  • startTime

    dize

    İndirmenin 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 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öreli 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ı ö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 XMLHttpRequest'in izin verdiği 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ı

    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 milisaniyeden önce sona eren DownloadItem ile sınırlar.

  • hata

    InterruptReason isteğe bağlı

    İndirme işleminin kesintiye uğramasının nedeni.

  • exists

    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ı

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

    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 ve tire ile başlayan arama terimlerinin hiçbirini içermeyen DownloadItem ile sınırlar.

  • startTime

    dize isteğe bağlı

    İndirmenin başladığı zaman (ISO 8601 biçiminde).

  • 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

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

    İ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 tam sayı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

Tekrarı ö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.

prompt

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

Enum

"uniquify"

"overwrite"

"istem"

FilenameSuggestion

Özellikler

  • conflictAction

    FilenameConflictAction isteğe bağlı

    filename zaten varsa yapılacak işlem.

  • filename

    dize

    DownloadItem'ın yeni hedefi 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 boyutu. Simge, boyut * boyut piksel boyutlarında kare şeklinde olur. Simgenin varsayılan ve en büyük boyutu 32x32 pikseldir. Yalnızca 16 ve 32 boyutları desteklenir. Başka bir boyut belirtmek hatadır.

HeaderNameValuePair

Özellikler

  • ad

    dize

    HTTP üstbilgisinin adı.

  • value

    dize

    HTTP başlığının 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, dosya ana makinesiyle bağlantının kesilmesine neden oldu.

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

    boolean

    İ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ı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 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ıyla değiştirilir, state "tamamlandı" olarak değişir ve onChanged tetiklenir.

Parametreler

  • downloadId

    sayı

    DownloadItem öğesinin tanımlayıcısıdır.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

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

    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 indirme 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 belirtilirse 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 ç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

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

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

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

    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ır. Yeni indirmelerde, onCreated etkinliği alındıktan sonra dosya simgeleri kullanılabilir. İ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 veya daha yeni bir sürüm

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

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

    () => void

İadeler

  • Promise<void>

    Chrome 123 veya daha yeni bir sürüm

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

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

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

    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, limit değerini sayfa başına öğe sayısına ve startedAfter değerini son sayfadaki son öğenin startTime değerine ayarlayın.

Parametreler

İadeler

  • Promise<DownloadItem[]>

    Chrome 96 veya daha yeni bir sürüm

    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.

Mevcut 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 eklenti 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

    boolean

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ş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ı 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>

    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'nin bytesReceived ve estimatedEndTime dışındaki özelliklerinden herhangi biri değiştiğinde bu etkinlik, downloadId ile ve değişen özellikleri içeren bir nesneyle birlikte tetiklenir.

Parametreler

  • callback

    işlev

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

    (downloadDelta: DownloadDelta) => void

onCreated

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

Bu etkinlik, bir indirme işlemi başladığında DownloadItem nesnesiyle birlikte 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 sürecinde uzantılara hedef DownloadItem.filename'i geçersiz kılma fırsatı verilir. Her uzantı, bu etkinlik için birden fazla dinleyici 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 ne suggest işlevini eşzamanlı olarak çağırır ne de true işlevini döndürürse suggest işlevi otomatik olarak çağrılır. Tüm dinleyiciler suggest araması yapana kadar DownloadItem tamamlanmaz. Dinleyiciler, dosya adında downloadItem.filename kullanılabilmesi 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 tetiklenir.

Parametreler

  • callback

    işlev

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

    (downloadId: number) => void

    • downloadId

      sayı