Bu sayfa, Cloud Translation API ile çevrilmiştir.

chrome.downloads

Açıklama

İndirmeleri programlı bir şekilde başlatmak, izlemek, değiştirmek ve aramak için chrome.downloads API'sini 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 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

boole isteğe bağlı
önceki

boole isteğe bağlı

DangerType

file

İndirilen dosyanın adı şüpheli.

url

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

İndirilen dosyanın URL'si çok indirilen bir dosya değil ve tehlikeli olabilir.

düzenleyen

İndirme işlemi, kötü amaçlı ikili programlar dağıttığı bilinen bir ana makineden geldi ve muhtemelen tehlikelidir.

istenmeyen

İndirme işlemi istenmeyen 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şturmamaktadır.

kabul edilir

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

Enum

"url"

"uncommon"

"host"

"unwanted"

"accepted"

"allowlistedByPolicy"

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

DoubleDelta

Özellikler

akım

numara isteğe bağlı
önceki

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

BooleanDelta isteğe bağlı

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

DoubleDelta isteğe bağlı

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

StringDelta isteğe bağlı

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

StringDelta isteğe bağlı

Chrome 54 ve sonraki sürümler

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

sayı

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

StringDelta isteğe bağlı

mime değerindeki değişiklik (varsa).
duraklatıldı

BooleanDelta isteğe bağlı

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

StringDelta isteğe bağlı

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

StringDelta isteğe bağlı

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

DoubleDelta isteğe bağlı

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

StringDelta isteğe bağlı

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

DownloadItem

Özellikler

byExtensionId

string isteğe bağlı

İndirme bir uzantı tarafından başlatıldıysa bu indirme işlemini başlatan uzantının tanımlayıcısı. Ayarlandıktan sonra değişmez.
byExtensionName

string isteğe bağlı

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

sayı

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

boolean

İndirme devam ediyor ve duraklatılmışsa veya kesintiye uğrayıp 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 olarak bilinip bilinmediğini belirtir.
endTime

string isteğe bağlı

İndirmenin ISO 8601 biçiminde 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şlemi neden kesintiye uğradı? SERVER_ ile başlayan hatalardan birinin altında çeşitli HTTP hataları gruplanabilir. Ağla ilgili hatalar NETWORK_ ile başlar, dosyayı dosya sistemine yazma işlemiyle ilgili hatalar FILE_ ile, kullanıcı tarafından başlatılan kesintiler ise USER_ ile başlar.
estimatedEndTime

string isteğe bağlı

İndirmenin ISO 8601 biçiminde 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ırmayı otomatik olarak izlemediğinden bu bilgiler güncel olmayabilir. Dosya varlığı kontrolünü tetiklemek için search() yöntemini çağırın. Varlık kontrolü tamamlandığında, dosya silinmişse bir onChanged etkinliği tetiklenir. search() işlevinin dönmeden önce varlık kontrolünün tamamlanmasını beklemediğini unutmayın. Bu nedenle, search() işlevinden gelen sonuçlar dosya sistemini doğru bir şekilde yansıtmayabilir. Ayrıca, search() gerektiğinde çağrılabilir, ancak dosya varlığını 10 saniyede bir defadan daha sık kontrol etmez.
fileSize

sayı

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

dize

Mutlak yerel yol.
finalUrl

dize

Chrome 54 ve sonraki sürümler

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

sayı

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

boolean

Bu indirme, geçmişe kaydedilirse false, kaydedilmiyorsa true (doğru) değerine sahiptir.
mime

dize

Dosyanın MIME türü.
duraklatıldı

boolean

İndirme işlemi ana makineden veri okumayı durdurdu, ancak bağlantıyı açık tuttuysa doğru değerini döndürür.
referrer

dize

Mutlak URL.
startTime

dize

İndirmenin ISO 8601 biçiminde 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))})})
state

Durum

İndirme işleminin ilerlediğini, kesintiye uğradığını veya tamamlandığını belirtir.
totalBytes

sayı

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

dize

Bu indirme işleminin tüm yönlendirmelerden önce başlatıldığı mutlak URL.

DownloadOptions

Özellikler

body

string isteğe bağlı

Yayın gövdesi.
conflictAction

FilenameConflictAction isteğe bağlı

filename zaten mevcutsa yapılacak işlem.
filename

string isteğe bağlı

İndirilen dosyayı içeren İndirilenler dizinine göreli, muhtemelen alt dizinler içeren bir dosya yolu. Mutlak yollar, boş yollar ve ".." geri başvuruları içeren yollar hataya neden olur. onDeterminingFilename, dosyanın MIME türü ve geçici bir dosya adı belirlendikten sonra dosya adı önerilmesine olanak tanır.
headers

HeaderNameValuePair[] isteğe bağlı

URL, HTTP[s] protokolünü kullanıyorsa istekle birlikte gönderilecek fazladan HTTP üstbilgileri. Her başlık, XMLHttpRequest tarafından izin verilenlerle sınırlı name veya value ya da binaryValue anahtarlarını içeren bir sözlük olarak temsil edilir.
method

HttpMethod isteğe bağlı

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

boole isteğe bağlı

Kullanıcının, filename uygulamasının ayarlanmış olup olmadığına bakılmaksızın dosya adı seçmesine izin vermek için dosya seçici kullanın.
url

dize

İndirilecek URL.

DownloadQuery

Özellikler

bytesReceived

numara 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 olarak bilinip bilinmediğini belirtir.
endTime

string isteğe bağlı

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

string isteğe bağlı

Sonuçları, ISO 8601 biçiminde belirtilen ms. sonunda sona eren DownloadItem ile sınırlar
endedBefore

string isteğe bağlı

Sonuçları, ISO 8601 biçiminde belirtilen ms. değerinden önce sona eren DownloadItem ile sınırlar.
hata

InterruptReason isteğe bağlı

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

boole isteğe bağlı

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

numara isteğe bağlı

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

string isteğe bağlı

Mutlak yerel yol.
filenameRegex

string isteğe bağlı

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

string isteğe bağlı

Chrome 54 ve sonraki sürümler

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

string isteğe bağlı

Chrome 54 ve sonraki sürümler

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

numara isteğe bağlı

Sorgulanacak DownloadItem öğesinin id değeri.
sınır

numara isteğe bağlı

Döndürülen maksimum sayıda DownloadItem. Varsayılan olarak 1.000 değerine ayarlanır. Eşleşen tüm DownloadItem değerlerinin döndürülmesi için değeri 0 olarak ayarlayın. Sonuçlar arasında nasıl gezineceğinizi öğrenmek için search bölümüne bakın.
mime

string isteğe bağlı

Dosyanın MIME türü.
orderBy

string[] isteğe bağlı

Arama sonuçlarını sıralamak için bu dizinin öğelerini DownloadItem özelliklerine ayarlayın. Örneğin, orderBy=['startTime'] ayarlanırsa DownloadItem başlangıç zamanına göre artan düzende sıralanır. Azalan sırayı belirtmek için önek olarak kısa çizgi kullanın: "-startTime".
duraklatıldı

boole isteğe bağlı

İndirme işlemi ana makineden veri okumayı durdurdu, ancak 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ı filename veya url ya da finalUrl tire "-" ile başlamayan tüm arama terimlerini ve tire ile başlayan hiçbir arama terimini içermeyen DownloadItem ile sınırlandırır.
startTime

string isteğe bağlı

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

string isteğe bağlı

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

string isteğe bağlı

Sonuçları, ISO 8601 biçiminde belirtilen ms. değerinden önce başlayan DownloadItem ile sınırlar.
state

Eyalet isteğe bağlı

İndirme işleminin ilerlediğini, kesintiye uğradığını veya tamamlandığını belirtir.
totalBytes

numara isteğe bağlı

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

numara isteğe bağlı

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

numara isteğe bağlı

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

string isteğe bağlı

Bu indirme işleminin tüm yönlendirmelerden önce başlatıldığı mutlak URL.
urlRegex

string isteğe bağlı

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

FilenameConflictAction

eşitlemek

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

üzerine yazma

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

istem

Kullanıcıdan bir dosya seçici iletişim kutusu görüntülenir.

Enum

"uniquify"

FilenameSuggestion

Özellikler

conflictAction

FilenameConflictAction isteğe bağlı

filename zaten mevcutsa yapılacak işlem.
filename

dize

Kullanıcının varsayılan İndirilenler dizinine göreli bir yol olarak muhtemelen alt dizinler içeren DownloadItem adlı yeni hedef DownloadItem.filename. Mutlak yollar, boş yollar ve ".." geri başvuruları içeren yollar yok sayılır. Herhangi bir uzantı tarafından kaydedilmiş onDeterminingFilename işleyici varsa filename yoksayılır.

GetFileIconOptions

Özellikler

beden

isteğe bağlı

Döndürülen simgenin boyutu. Simge, boyutları * boyut pikselleri olan kare şeklinde olacak. Simgenin varsayılan ve en büyük boyutu 32x32 pikseldir. Yalnızca 16 ve 32 boyutları desteklenir. Başka bir boyutu belirtmek hatadır.

HeaderNameValuePair

Özellikler

ad

dize

HTTP üstbilgisinin adı.
value

dize

HTTP üstbilgisinin değeri.

HttpMethod

Enum

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"

State

in_progress

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

kesintiye uğradı

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

complete

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

Enum

"in_progress"

"interrupted"

"complete"

StringDelta

Özellikler

akım

string isteğe bağlı
önceki

string isteğe bağlı

UiOptions

Chrome 105 ve sonraki sürümler

Özellikler

etkin

boolean

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

Yöntemler

acceptDanger()

Söz

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

Kullanıcıdan tehlikeli bir dosyayı indirmeyi kabul etmesini iste. Yalnızca görünür bir bağlamdan (sekme, pencere veya sayfa/tarayıcı işlem pop-up'ı) çağrılabilir. Tehlikeli indirmeleri otomatik olarak kabul etmez. İndirme işlemi 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ına göre yeniden adlandırılır, state "tamamlandı" olarak değişir ve onChanged tetiklenir.

Parametreler

downloadId

sayı

DownloadItem için tanımlayıcı.
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
()=>void
```

İlerlemeler

Promise<void>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

cancel()

Söz

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 ya da artık mevcut değildir.

Parametreler

downloadId

sayı

İptal edilecek indirmenin kimliği.
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
()=>void
```

İlerlemeler

Promise<void>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

download()

Söz

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

Bir URL indirin. URL, HTTP[S] protokolünü kullanıyorsa istek, ana makine adı için o sırada ayarlanmış olan tüm çerezleri içerir. Hem filename hem de saveAs belirtilirse farklı Kaydet iletişim kutusu, belirtilen filename ile önceden doldurulmuş şekilde görüntülenir. İndirme işlemi başarıyla başlatıldıysa callback, yeni DownloadItem 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 olarak kalacağı garanti edilmez. Uzantılar bunu ayrıştırmamalıdır.

Parametreler

seçenekler

DownloadOptions

Neyi nasıl indirmeli?
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
(downloadId: number)=>void
```
- downloadId
  
  sayı

İlerlemeler

Vaat<sayı>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

erase()

Söz

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

İndirilen dosyayı silmeden, eşleşen DownloadItem dosyasını 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

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
(erasedIds: number[])=>void
```
- erasedIds
  
  numara[]

İlerlemeler

Vaat<sayı[]>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getFileIcon()

Söz

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

Belirtilen indirme işlemi için bir simge alın. Dosya simgeleri, yeni indirmelerde onCreated etkinliği alındıktan sonra kullanılabilir. İndirme işlemi devam ederken bu işlevin döndürdüğü resim, indirme işlemi tamamlandıktan sonra döndürülen görüntüden farklı olabilir. Simge alma işlemi, platforma bağlı olarak işletim sistemini veya araç setini sorgulayarak gerçekleştirilir. Bu nedenle, döndürülen simge; indirmenin durumu, platform, kayıtlı dosya türleri ve görsel tema gibi bir dizi faktöre bağlıdır. Dosya simgesi belirlenemezse runtime.lastError bir hata mesajı içerir.

Parametreler

downloadId

sayı

İndirmenin tanımlayıcısı.
seçenekler

GetFileIconOptions isteğe bağlı
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
(iconURL?: string)=>void
```
- iconURL
  
  string isteğe bağlı

İlerlemeler

Söz<dize|undefined>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

open()

Söz

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

DownloadItem tamamlandıysa indirilen dosyayı şimdi açar. Aksi takdirde runtime.lastError üzerinden 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 bir kullanıcı hareketine yanıt olarak çağrılabilir.

Parametreler

downloadId

sayı

İndirilen dosyanın tanımlayıcısı.
geri çağırma

Functions (isteğe bağlı)

Chrome 123 ve sonraki sürümler

callback parametresi şu şekilde görünür:
```
()=>void
```

İlerlemeler

Promise<void>

Chrome 123 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

pause()

Söz

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

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

Parametreler

downloadId

sayı

Duraklatılacak indirmenin kimliği.
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
()=>void
```

İlerlemeler

Promise<void>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

removeFile()

Söz

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

DownloadItem tamamlandıysa indirilen dosyayı kaldırın. Aksi takdirde runtime.lastError tarihine kadar hata döndürülür.

Parametreler

downloadId

sayı
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
()=>void
```

İlerlemeler

Promise<void>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

resume()

Söz

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

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

Parametreler

downloadId

sayı

Devam ettirilecek indirmenin kimliği.
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
()=>void
```

İlerlemeler

Promise<void>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

search()

Söz

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

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

Parametreler

sorgu

DownloadQuery
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
(results: DownloadItem[])=>void
```
- sonuç
  
  DownloadItem[]

İlerlemeler

Promise<DownloadItem[]>

Chrome 96 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setShelfEnabled()

Chrome 117 sürümünden itibaren kullanımdan kaldırıldı

chrome.downloads.setShelfEnabled(
  enabled: boolean,
)

Bunun yerine setUiOptions alanını kullanın.

Geçerli tarayıcı profiliyle ilişkili her pencerenin alt kısmında bulunan gri rafı etkinleştirin veya devre dışı bırakın. En az bir uzantı devre dışı bıraktığı sürece raf da devre dışı bırakılır. En az bir diğer uzantı devre dışıyken rafı etkinleştirirseniz runtime.lastError tarihine kadar hata döndürülür. "downloads" izninin yanı sıra "downloads.shelf" iznini de gerektirir.

Parametreler

etkin

boolean

setUiOptions()

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

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 değerini false (yanlış) olarak ayarladığı sürece indirme kullanıcı arayüzü gizlenir. En az bir diğer uzantı devre dışıyken UiOptions.enabled değeri true (doğru) değerine ayarlanırsa runtime.lastError üzerinden bir hata döndürülür. "downloads" izninin yanı sıra "downloads.ui" iznini de gerektirir.

Parametreler

seçenekler

UiOptions

İndirme kullanıcı arayüzündeki bir değişikliği kapsülleyin.
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
()=>void
```

İlerlemeler

Promise<void>

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

show()

chrome.downloads.show(
  downloadId: number,
)

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

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öster.

Etkinlikler

onChanged

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

bytesReceived ve estimatedEndTime hariç DownloadItem özelliklerinden herhangi biri değiştiğinde bu etkinlik downloadId ve değişen özellikleri içeren bir nesne ile 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,
)

Bu etkinlik, bir indirme işlemi başladığında 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 sürecinde uzantılara, DownloadItem.filename hedefini geçersiz kılma fırsatı sunulur. Her uzantı bu etkinlik için birden fazla işleyici kaydedemez. Her dinleyici suggest öğesini eşzamanlı veya eşzamansız olarak tam olarak bir kez çağırmalıdır. İşleyici, suggest öğesini eşzamansız olarak çağırırsa true değerini döndürmelidir. Dinleyici suggest öğesini eşzamanlı olarak çağırmaz veya true değerini döndürürse suggest otomatik olarak çağrılır. Tüm dinleyiciler suggest araması yapana kadar DownloadItem tamamlanmaz. İşleyiciler, indirmenin dosya adı için downloadItem.filename kullanmasına izin vermek üzere suggest öğesini 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 aktarabilir. Birden fazla uzantı, dosya adını geçersiz kılarsa işleyicisi suggest öğesine bir suggestion nesnesi ileten son yüklenen uzantı kazanır. Hangi uzantının kazanacağıyla ilgili karışıklığı önlemek için kullanıcılar çakışabilecek uzantıları yüklememelidir. İndirme işlemi download tarafından başlatıldıysa ve hedef dosya adı, MIME türü ve geçici dosya adı belirlenmeden önce biliniyorsa bunun yerine filename öğesini download hedefine 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,
)

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

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(downloadId: number)=>void
```
- downloadId
  
  sayı