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ümlerfinalUrl
değerindeki değişiklik (varsa). -
id
sayı
Değişen
DownloadItem
öğesininid
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
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 hatalarNETWORK_
ile başlar, dosyayı dosya sistemine yazma işlemiyle ilgili hatalarFILE_
ile, kullanıcı tarafından başlatılan kesintiler iseUSER_
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 bironChanged
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ümlerTü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
İ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
veyavalue
ya dabinaryValue
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şenDownloadItem
ile sınırlar. -
finalUrl
string isteğe bağlı
Chrome 54 ve sonraki sürümlerTüm yönlendirmelerden sonra, bu indirme işleminin yapıldığı mutlak URL.
-
finalUrlRegex
string isteğe bağlı
Chrome 54 ve sonraki sürümlerSonuçları,
finalUrl
değeri belirtilen normal ifadeyle eşleşenDownloadItem
ile sınırlar. -
id
numara isteğe bağlı
Sorgulanacak
DownloadItem
öğesininid
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ümDownloadItem
değerlerinin döndürülmesi için değeri 0 olarak ayarlayın. Sonuçlar arasında nasıl gezineceğinizi öğrenmek içinsearch
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ırsaDownloadItem
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
veyaurl
ya dafinalUrl
tire "-" ile başlamayan tüm arama terimlerini ve tire ile başlayan hiçbir arama terimini içermeyenDownloadItem
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 olanDownloadItem
ile sınırlar. -
totalBytesLess
numara isteğe bağlı
Sonuçları,
totalBytes
değeri belirtilen tam sayıdan küçük olanDownloadItem
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şenDownloadItem
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 hedefDownloadItem.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 varsafilename
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
Özellikler
-
etkin
boolean
İndirme kullanıcı arayüzünü etkinleştirin veya devre dışı bırakın.
Yöntemler
acceptDanger()
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ümlerVaatler, 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()
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ümlerVaatler, 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()
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
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ümlerVaatler, 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()
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
-
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ümlerVaatler, 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()
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
-
Promise<string | undefined>
Chrome 96 ve sonraki sürümlerVaatler, 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()
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ümlercallback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 123 ve sonraki sürümlerVaatler, 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()
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ümlerVaatler, 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()
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ümlerVaatler, 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()
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ümlerVaatler, 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()
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
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(results: DownloadItem[]) => void
-
sonuç
-
İlerlemeler
-
Promise<DownloadItem[]>
Chrome 96 ve sonraki sürümlerVaatler, 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.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()
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
İ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
-
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
-
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
-
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ı
-