Bu izin uyarı tetikler
Açıklama
İndirme işlemlerini programatik olarak başlatmak, izlemek, işlemek ve aramak için chrome.downloads
API'yi kullanın.
İzinler
downloads
Manifest
Bu API'yi kullanmak için uzantı manifestinde "downloads"
iznini beyan etmeniz gerekir.
{
"name": "My extension",
...
"permissions": [
"downloads"
],
...
}
Örnekler
chrome.downloads
API'nin kullanımıyla ilgili basit örnekleri examples/api/downloads adresinde bulabilirsiniz.
dizin. Diğer örnekler ve kaynak kodunun görüntülenmesiyle ilgili yardım için Örnekler bölümüne bakın.
Türler
BooleanDelta
Özellikler
-
akım
boole isteğe bağlı
-
önceki
boole isteğe bağlı
DangerType
dosya
İndirilen dosyanın adı şüpheli.
url
İndirmenin URL'sinin kötü amaçlı olduğu biliniyor.
içerik
İndirilen dosyanın kötü amaçlı olduğu biliniyor.
yaygın değildir
İndirmenin URL'si çok indirilen bir URL değil ve tehlikeli olabilir.
düzenleyen
İndirme, kötü amaçlı ikili programları dağıttığı bilinen bir ana makineden gelmiştir ve büyük olasılıkla tehlikelidir.
istenmeyen
İndirme işlemi istenmeyen veya güvenli olmayabilir. Ör. tarayıcı veya bilgisayar ayarlarında değişiklik yapabilir.
güvenli
İndirme işlemi, kullanıcının bilgisayarı için bilinen bir tehlike oluşturmamaktadır.
kabul edildi
Kullanıcı tehlikeli indirme işlemini kabul etti.
Enum
"asyncScanning"
"asyncLocalPasswordScanning"
DoubleDelta
Özellikler
-
akım
sayı isteğe bağlı
-
önceki
sayı isteğe bağlı
DownloadDelta
Özellikler
-
canResume
BooleanDelta isteğe bağlı
Varsa
canResume
ile ilgili değişiklik. -
tehlike
StringDelta isteğe bağlı
Varsa
danger
ile ilgili değişiklik. -
endTime
StringDelta isteğe bağlı
Varsa
endTime
ile ilgili değişiklik. -
hata
StringDelta isteğe bağlı
Varsa
error
ile ilgili değişiklik. -
mevcut
BooleanDelta isteğe bağlı
Varsa
exists
ile ilgili değişiklik. -
fileSize
DoubleDelta isteğe bağlı
Varsa
fileSize
ile ilgili değişiklik. -
filename
StringDelta isteğe bağlı
Varsa
filename
ile ilgili değişiklik. -
finalUrl
StringDelta isteğe bağlı
Chrome 54 ve sonraki sürümler 'nı inceleyin.Varsa
finalUrl
ile ilgili değişiklik. -
id
sayı
Değişen
DownloadItem
içinid
. -
mime
StringDelta isteğe bağlı
Varsa
mime
ile ilgili değişiklik. -
duraklatıldı
BooleanDelta isteğe bağlı
Varsa
paused
ile ilgili değişiklik. -
startTime
StringDelta isteğe bağlı
Varsa
startTime
ile ilgili değişiklik. -
durum
StringDelta isteğe bağlı
Varsa
state
ile ilgili değişiklik. -
totalBytes
DoubleDelta isteğe bağlı
Varsa
totalBytes
ile ilgili değişiklik. -
url
StringDelta isteğe bağlı
Varsa
url
ile ilgili değişiklik.
DownloadItem
Özellikler
-
byExtensionId
dize isteğe bağlı
Bu indirme işlemi bir uzantı tarafından başlatıldıysa uzantıyı başlatan uzantının tanımlayıcısı. Ayarlandıktan sonra değişmez.
-
byExtensionName
dize isteğe bağlı
Bu indirme işlemi bir uzantı tarafından başlatıldıysa bunu başlatan uzantının yerelleştirilmiş adı. Uzantının adını veya kullanıcı yerel ayarını değiştirirse değişebilir.
-
bytesReceived
sayı
Dosya sıkıştırması dikkate alınmadan, ana makineden o ana kadar alınan bayt sayısı.
-
canResume
boolean
İndirme devam ediyorsa ve duraklatıldıysa ya da kesintiye uğrarsa ve kesintiye uğradığı yerden devam ettirilebiliyorsa doğru değerini döndürür.
-
tehlike
Bu indirme işleminin güvenli olup olmadığını veya şüpheli olup olmadığının göstergesi.
-
endTime
dize isteğe bağlı
ISO 8601 biçiminde, indirme işleminin sona erdiği zaman. Doğrudan Tarih oluşturucuya geçirilebilir:
chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})
-
hata
InterruptReason isteğe bağlı
İndirme işleminin neden kesintiye uğradığı?
SERVER_
ile başlayan hatalardan birinin altında çok sayıda HTTP hatası gruplanabilir. Ağla ilgili hatalarNETWORK_
ile başlar, dosyayı dosya sistemine yazma işlemiyle ilgili hatalarFILE_
ile başlar ve kullanıcı tarafından başlatılan kesintilerUSER_
ile başlar. -
estimatedEndTime
dize isteğe bağlı
ISO 8601 biçiminde indirme işleminin tamamlanacağı tahmini süre. Doğrudan Tarih oluşturucuya geçirilebilir:
chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})
-
mevcut
boolean
İndirilen dosyanın hâlâ mevcut olup olmadığı. Chrome, dosya kaldırma işlemlerini otomatik olarak izlemediğinden bu bilgiler güncel olmayabilir. Dosya varlığı kontrolünü tetiklemek için
search
() işlevini çağırın. Durum kontrolü tamamlandığında, dosya silinmişse bironChanged
etkinliği tetiklenir.search
() işlevi, geri dönmeden önce durum kontrolünün tamamlanmasını beklemez. Bu nedenle,search
() işlevinden alınan sonuçlar, dosya sistemini doğru şekilde yansıtmayabilir. Ayrıca,search
() gerektiği kadar sık çağrılabilir, ancak dosya varlığını her 10 saniyede bir defadan daha sık kontrol etmez. -
fileSize
sayı
Sıkıştırma işleminden sonra tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.
-
filename
dize
Mutlak yerel yol.
-
finalUrl
dize
Chrome 54 ve sonraki sürümler 'nı inceleyin.Tüm yönlendirmelerden sonra, bu indirme işleminin yapıldığı mutlak URL.
-
id
sayı
Tarayıcı oturumları arasında kalıcı olan bir tanımlayıcı.
-
gizli
boolean
Bu indirme geçmişe kaydedilirse false, kaydedilmezse true değerini alır.
-
mime
dize
Dosyanın MIME türü.
-
duraklatıldı
boolean
İndirme işlemi ana makineden gelen verileri okumayı durdurup bağlantıyı açık tuttuysa doğru değerini döndürür.
-
yönlendiren
dize
Mutlak URL.
-
startTime
dize
ISO 8601 biçiminde indirme işleminin başladığı zaman. Doğrudan Tarih oluşturucuya geçirilebilir:
chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})
-
durum
İndirme işleminin devam ettiğini, kesintiye uğradığını veya tamamlandığını gösterir.
-
totalBytes
sayı
Dosya sıkıştırması dikkate alınmadan tüm dosyadaki bayt sayısı veya bilinmiyorsa -1 olur.
-
url
dize
Bu indirme işleminin herhangi bir yönlendirmeden önce başlattığı mutlak URL.
DownloadOptions
Özellikler
-
gövde
dize isteğe bağlı
Yayın gövdesi.
-
conflictAction
FilenameConflictAction isteğe bağlı
filename
zaten varsa yapılacak işlem. -
filename
dize isteğe bağlı
Muhtemelen alt dizinler de içeren, indirilen dosyayı içerecek İndirilenler dizinine bağlı bir dosya yolu. Mutlak yollar, boş yollar ve geriye referanslar ".." içeren yollar bir hataya neden olur.
onDeterminingFilename
, dosyanın MIME türü ve geçici bir dosya adı belirlendikten sonra dosya adının önerilmesine olanak tanır. -
başlıklar
HeaderNameValuePair[] isteğe bağlı
URL, HTTP[s] protokolünü kullanıyorsa istekle birlikte gönderilecek fazladan HTTP üstbilgileri. Her üst bilgi, XMLHttpRequest tarafından izin verilenlerle sınırlı olmak üzere
name
vevalue
ya dabinaryValue
anahtarlarını içeren bir sözlük olarak gösterilir. -
method
HttpMethod isteğe bağlı
URL'nin HTTP[S] protokolünü kullanması durumunda kullanılacak HTTP yöntemi.
-
saveAs
boole isteğe bağlı
filename
kullanıcısının ayarlanmış veya zaten mevcut olmasına bakılmaksızın, kullanıcının dosya adı seçmesine izin vermek için bir dosya seçici kullanın. -
url
dize
İndirilecek URL.
DownloadQuery
Özellikler
-
bytesReceived
sayı isteğe bağlı
Dosya sıkıştırması dikkate alınmadan, ana makineden o ana kadar alınan bayt sayısı.
-
tehlike
DangerType isteğe bağlı
Bu indirme işleminin güvenli olup olmadığını veya şüpheli olup olmadığının göstergesi.
-
endTime
dize isteğe bağlı
ISO 8601 biçiminde, indirme işleminin sona erdiği zaman.
-
endedAfter
dize isteğe bağlı
ISO 8601 biçiminde belirtilen ms.den sonra sona eren sonuçları
DownloadItem
ile sınırlar -
endedBefore
dize isteğe bağlı
ISO 8601 biçiminde, belirtilen ms.den önce sona eren sonuçları
DownloadItem
ile sınırlandırır. -
hata
InterruptReason isteğe bağlı
İndirme işleminin neden kesintiye uğradığı?
-
mevcut
boole isteğe bağlı
İndirilen dosyanın mevcut olup olmadığı;
-
fileSize
sayı isteğe bağlı
Sıkıştırma işleminden sonra tüm dosyadaki bayt sayısı veya bilinmiyorsa -1.
-
filename
dize isteğe bağlı
Mutlak yerel yol.
-
filenameRegex
dize isteğe bağlı
filename
değeri, belirtilen normal ifadeyle eşleşen sonuçlarıDownloadItem
ile sınırlar. -
finalUrl
dize isteğe bağlı
Chrome 54 ve sonraki sürümler 'nı inceleyin.Tüm yönlendirmelerden sonra, bu indirme işleminin yapıldığı mutlak URL.
-
finalUrlRegex
dize isteğe bağlı
Chrome 54 ve sonraki sürümler 'nı inceleyin.finalUrl
değeri, belirtilen normal ifadeyle eşleşen sonuçlarıDownloadItem
ile sınırlar. -
id
sayı isteğe bağlı
Sorgulanacak
DownloadItem
öğesininid
öğesi. -
sınır
sayı isteğe bağlı
Maksimum sayıda eşleşen
DownloadItem
döndürüldü. Varsayılan olarak 1.000 değerine ayarlanır. Eşleşen tümDownloadItem
öğelerini döndürmek için 0 değerine ayarlayın. Sonuçların sayfaları arasında nasıl gezinileceğini öğrenmek için bkz.search
. -
mime
dize isteğe bağlı
Dosyanın MIME türü.
-
orderBy
string[] isteğe bağlı
Arama sonuçlarını sıralamak için bu dizinin öğelerini
DownloadItem
özelliklerine ayarlayın. Örneğin,orderBy=['startTime']
ayarlandığındaDownloadItem
başlangıç zamanına göre artan düzende sıralanır. Azalan sırayı belirtmek için başına kısa çizgi ekleyin: "-startTime". -
duraklatıldı
boole isteğe bağlı
İndirme işlemi ana makineden gelen verileri okumayı durdurup bağlantıyı açık tuttuysa doğru değerini döndürür.
-
sorgu
string[] isteğe bağlı
Bu arama terimleri dizisi, sonuçları tire ("-") ile başlamayan tüm arama terimlerini
filename
veyaurl
ya dafinalUrl
içerenDownloadItem
ile sınırlandırır ve tireyle başlayan arama terimlerinin hiçbirinin olmaması. -
startTime
dize isteğe bağlı
ISO 8601 biçiminde indirme işleminin başladığı zaman.
-
startedAfter
dize isteğe bağlı
Sonuçları, ISO 8601 biçiminde belirtilen ms.den sonra başlayan
DownloadItem
ile sınırlandırır. -
startedBefore
dize isteğe bağlı
ISO 8601 biçiminde, belirtilen ms.den önce başlayan sonuçları
DownloadItem
ile sınırlandırır. -
durum
Eyalet isteğe bağlı
İndirme işleminin devam ettiğini, kesintiye uğradığını veya tamamlandığını gösterir.
-
totalBytes
sayı isteğe bağlı
Dosya sıkıştırması dikkate alınmadan tüm dosyadaki bayt sayısı veya bilinmiyorsa -1 olur.
-
totalBytesGreater
sayı isteğe bağlı
totalBytes
değeri, belirtilen tam sayıdan büyük olan sonuçlarıDownloadItem
ile sınırlar. -
totalBytesLess
sayı isteğe bağlı
totalBytes
değeri, belirtilen tam sayıdan küçük olan sonuçlarıDownloadItem
ile sınırlar. -
url
dize isteğe bağlı
Bu indirme işleminin herhangi bir yönlendirmeden önce başlattığı mutlak URL.
-
urlRegex
dize isteğe bağlı
url
değeri, belirtilen normal ifadeyle eşleşen sonuçlarıDownloadItem
ile sınırlar.
FilenameConflictAction
tek
Yinelemeyi önlemek için filename
, dosya adı uzantısından önce bir sayaç içerecek şekilde değiştirilir.
üzerine yazmak
Yeni dosya, mevcut dosyanın üzerine yazılır.
istem
Kullanıcıdan bir dosya seçici iletişim kutusu gösterilir.
Enum
FilenameSuggestion
Özellikler
-
conflictAction
FilenameConflictAction isteğe bağlı
filename
zaten varsa yapılacak işlem. -
filename
dize
Kullanıcının varsayılan İndirilenler dizinine göre muhtemelen alt dizinler içeren yeni
DownloadItem
hedefiDownloadItem.filename
. Mutlak yollar, boş yollar ve geriye referanslar ".." içeren yollar yok sayılır. Uzantı tarafından kaydedilenonDeterminingFilename
işleyici varsafilename
yoksayılır.
GetFileIconOptions
Özellikler
-
beden
sayı isteğe bağlı
Döndürülen simgenin boyutu. Simge, boyutlarda * boyut piksellerinde kare şeklinde olacaktır. Simgenin varsayılan ve en büyük boyutu 32x32 pikseldir. Yalnızca 16 ve 32 boyutları desteklenir. Diğer boyutların belirtilmesi hatadır.
HeaderNameValuePair
Özellikler
-
ad
dize
HTTP üstbilgisinin adı.
-
value
dize
HTTP üst bilgisinin değeri.
HttpMethod
Enum
InterruptReason
Enum
State
in_progress
İndirme işlemi şu anda sunucudan veri alıyor.
kesintiye uğradı
Bir hata nedeniyle dosya barındırıcısıyla bağlantı kesildi.
complete
İndirme işlemi başarıyla tamamlandı.
Enum
StringDelta
Özellikler
-
akım
dize isteğe bağlı
-
önceki
dize 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 indirme işlemini kabul etmesini iste. Yalnızca görünür bir bağlamdan (sekme, pencere veya sayfa/tarayıcı işlemi pop-up'ı) çağrılabilir. Tehlikeli indirmeleri otomatik olarak kabul etmez. İndirme kabul edilirse bir onChanged
etkinliği tetiklenir. Aksi takdirde hiçbir şey olmaz. Tüm veriler geçici bir dosyaya getirildiğinde ve indirme işlemi tehlikeli olmadığında veya tehlike kabul edildiğinde, geçici dosya hedef dosya adıyla yeniden adlandırılır, state
"tamamlandı" olarak değiştirilir ve onChanged
tetiklenir.
Parametreler
-
downloadId
sayı
DownloadItem
için tanımlayıcı. -
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
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 veya artık mevcut değildir.
Parametreler
-
downloadId
sayı
İptal edilecek indirme işleminin kimliği.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
download()
chrome.downloads.download(
options: DownloadOptions,
callback?: function,
)
URL indirin. URL'de HTTP[S] protokolü kullanılıyorsa istek, ana makine adı için halihazırda ayarlanmış olan tüm çerezleri içerir. Hem filename
hem de saveAs
belirtilirse Farklı Kaydet iletişim kutusu, belirtilen filename
ile önceden doldurulmuş olarak görüntülenir. İndirme işlemi başarıyla başlatıldıysa callback
, yeni DownloadItem
cihazının downloadId
ile çağrılır. İndirme işlemi başlatılırken bir hata oluştuysa callback
, downloadId=undefined
ile çağrılır ve runtime.lastError
açıklayıcı bir dize içerir. Hata dizelerinin sürümler arasında geriye dönük uyumlu olmaya devam edeceği garanti edilmez. Uzantılar bunu ayrıştırmamalıdır.
Parametreler
-
seçenekler
Ne indirmeli, nasıl indirmelisiniz?
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(downloadId: number) => void
-
downloadId
sayı
-
İadeler
-
Promise<number>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
erase()
chrome.downloads.erase(
query: DownloadQuery,
callback?: function,
)
İndirilen dosyayı silmeden eşleşen DownloadItem
öğesini geçmişten silin. query
ile eşleşen her DownloadItem
için bir onErased
etkinliği tetiklenir, ardından callback
çağrılır.
Parametreler
-
sorgu
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(erasedIds: number[]) => void
-
erasedIds
numara[]
-
İadeler
-
Promise<number[]>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getFileIcon()
chrome.downloads.getFileIcon(
downloadId: number,
options?: GetFileIconOptions,
callback?: function,
)
Belirtilen indirme için bir simge alın. Yeni indirilenler için dosya simgeleri onCreated
etkinliği alındıktan sonra kullanılabilir. İndirme işlemi devam ederken bu işlevin döndürdüğü görüntü, indirme işlemi tamamlandıktan sonra döndürülen görüntüden farklı olabilir. Simge alma işlemi, platforma bağlı olarak temel işletim sistemi veya araç seti sorgulanarak yapılır. Bu nedenle, döndürülen simge; indirme durumu, platform, kayıtlı dosya türleri ve görsel tema dahil olmak üzere çeşitli faktörlere bağlı olacaktır. Dosya simgesi belirlenemezse runtime.lastError
bir hata mesajı içerir.
Parametreler
-
downloadId
sayı
İndirme işlemine ilişkin tanımlayıcı.
-
seçenekler
GetFileIconOptions isteğe bağlı
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(iconURL?: string) => void
-
iconURL
dize isteğe bağlı
-
İadeler
-
Promise<string | tanımlanmadı>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
open()
chrome.downloads.open(
downloadId: number,
callback?: function,
)
DownloadItem
tamamlandıysa indirilen dosyayı şimdi açar; aksi takdirde runtime.lastError
aracılığıyla hata döndürür. Bu yöntem için "downloads"
izninin yanı sıra "downloads.open"
izni de gerekir. Öğe ilk kez açıldığında bir onChanged
etkinliği tetiklenir. Bu yöntem yalnızca kullanıcı hareketine yanıt olarak çağrılabilir.
Parametreler
-
downloadId
sayı
İndirilen dosyanın tanımlayıcısı.
-
geri çağırma
işlev isteğe bağlı
Chrome 123 ve sonraki sürümler 'nı inceleyin.callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 123 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
pause()
chrome.downloads.pause(
downloadId: number,
callback?: function,
)
İndirme işlemini duraklatın. İstek başarılı olduysa indirme işlemi duraklatılmış durumda demektir. Aksi takdirde runtime.lastError
hata mesajı içerir. İndirme etkin değilse istek başarısız olur.
Parametreler
-
downloadId
sayı
Duraklatılacak indirmenin kimliği.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeFile()
chrome.downloads.removeFile(
downloadId: number,
callback?: function,
)
İndirilen dosya varsa ve DownloadItem
tamamlandıysa kaldırın; Aksi takdirde runtime.lastError
üzerinden hata döndürür.
Parametreler
-
downloadId
sayı
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
resume()
chrome.downloads.resume(
downloadId: number,
callback?: function,
)
Duraklatılmış indirme işlemini devam ettirme. İstek başarılı olduysa indirme işlemi devam eder ve devam ettirilir. Aksi takdirde runtime.lastError
hata mesajı içerir. İndirme etkin değilse istek başarısız olur.
Parametreler
-
downloadId
sayı
Devam ettirilecek indirme işleminin kimliği.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
search()
chrome.downloads.search(
query: DownloadQuery,
callback?: function,
)
DownloadItem
uygulamasını bulun. Tüm DownloadItem
öğelerini almak için query
öğesini boş nesneye ayarlayın. Belirli bir DownloadItem
öğesini elde etmek için yalnızca id
alanını ayarlayın. Çok sayıda öğe arasında sayfalar arasında geçiş yapmak için orderBy: ['-startTime']
öğesini, limit
öğesini sayfa başına öğe sayısı ve startedAfter
öğesini de son sayfadaki son öğe için startTime
olarak ayarlayın.
Parametreler
-
sorgu
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(results: DownloadItem[]) => void
-
sonuç
-
İadeler
-
Promise<DownloadItem[]>
Chrome 96 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
setShelfEnabled()
chrome.downloads.setShelfEnabled(
enabled: boolean,
)
Bunun yerine setUiOptions
alanını kullanın.
Geçerli tarayıcı profiliyle ilişkili her pencerenin en altındaki gri rafı etkinleştirin veya devre dışı bırakın. En az bir uzantı devre dışı bıraktığı sürece raf devre dışı bırakılır. En az bir diğer uzantı devre dışıyken rafı etkinleştirirseniz runtime.lastError
üzerinden hata döndürülür. "downloads"
iznine ek olarak "downloads.shelf"
iznini gerektirir.
Parametreler
-
etkin
boolean
setUiOptions()
chrome.downloads.setUiOptions(
options: UiOptions,
callback?: function,
)
Mevcut tarayıcı profiliyle ilişkili her pencerenin indirme kullanıcı arayüzünü değiştirin. En az bir uzantı UiOptions.enabled
özelliğini false (yanlış) değerine ayarladığı sürece indirme kullanıcı arayüzü gizlenir. En az bir diğer uzantı devre dışıyken UiOptions.enabled
doğru değerine ayarlanırsa runtime.lastError
boyunca hata döndürülür. "downloads"
iznine ek olarak "downloads.ui"
iznini gerektirir.
Parametreler
-
seçenekler
İndirme kullanıcı arayüzünde yapılan bir değişikliği kapsama.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
show()
chrome.downloads.show(
downloadId: number,
)
İndirilen dosyayı bir dosya yöneticisindeki klasöründe görüntüleyin.
Parametreler
-
downloadId
sayı
İndirilen dosyanın tanımlayıcısı.
showDefaultFolder()
chrome.downloads.showDefaultFolder()
Bir dosya yöneticisinde varsayılan İndirilenler klasörünü gösterin.
Etkinlikler
onChanged
chrome.downloads.onChanged.addListener(
callback: function,
)
DownloadItem
özelliğinin bytesReceived
ve estimatedEndTime
dışındaki özelliklerinden herhangi biri değiştiğinde bu etkinlik, downloadId
ve değişen özellikleri içeren bir nesne ile birlikte tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(downloadDelta: DownloadDelta) => void
-
downloadDelta
-
onCreated
chrome.downloads.onCreated.addListener(
callback: function,
)
Bir indirme işlemi başladığında bu etkinlik DownloadItem
nesnesiyle tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(downloadItem: DownloadItem) => void
-
downloadItem
-
onDeterminingFilename
chrome.downloads.onDeterminingFilename.addListener(
callback: function,
)
Dosya adı belirleme işlemi sırasında uzantılara, hedef DownloadItem.filename
değerini geçersiz kılma fırsatı verilir. Her uzantı bu etkinlik için birden fazla işleyici kaydedemez. Her işleyici, eşzamanlı veya eşzamansız olarak suggest
öğesini tam olarak bir kez çağırmalıdır. İşleyici suggest
öğesini eşzamansız olarak çağırırsa true
döndürmelidir. İşleyici suggest
öğesini eşzamanlı olarak çağırmaz veya true
döndürürse suggest
otomatik olarak çağrılır. Tüm dinleyiciler suggest
adlı kullanıcıyı çağırana kadar DownloadItem
tamamlanmaz. Dinleyiciler, indirmenin dosya adı olarak downloadItem.filename
kullanmasına izin vermek için suggest
öğesini herhangi bir bağımsız değişken olmadan çağırabilir veya hedef dosya adını geçersiz kılmak için suggest
öğesine bir suggestion
nesnesi iletebilir. Dosya adını birden fazla uzantı geçersiz kılarsa, dinleyicisi suggest
öğesine suggestion
nesnesi ileten son yüklü uzantı kazanır. Hangi uzantının kazanacağına dair karışıklığı önlemek için kullanıcılar çakışabilecek uzantıları yüklememelidir. İndirme işlemi download
tarafından başlatılıyorsa ve hedef dosya adı, MIME türü ve geçici dosya adı belirlenmeden önce biliniyorsa bunun yerine filename
öğesini download
hizmetine iletin.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(downloadItem: DownloadItem, suggest: function) => void
-
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,
)
Geçmişten silinen bir indirme işlemi olduğunda downloadId
ile tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(downloadId: number) => void
-
downloadId
sayı
-