यह अनुमति चेतावनी ट्रिगर करती है
कंपनी का ब्यौरा
प्रोग्राम के हिसाब से, डाउनलोड शुरू करने, उनकी निगरानी करने, उनमें हेर-फेर करने, और डाउनलोड खोजने के लिए, chrome.downloads
API का इस्तेमाल करें.
अनुमतियां
downloads
मेनिफ़ेस्ट
इस एपीआई का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "downloads"
की अनुमति के बारे में एलान करना होगा.
{
"name": "My extension",
...
"permissions": [
"downloads"
],
...
}
उदाहरण
chrome.downloads
API को इस्तेमाल करने के आसान उदाहरण, आपको examples/api/downloads
डायरेक्ट्री में मिल जाएंगे. अन्य उदाहरणों के लिए और सोर्स कोड देखने में मदद के लिए, सैंपल देखें.
टाइप
BooleanDelta
प्रॉपर्टी
-
जो मौजूदा
बूलियन ज़रूरी नहीं
-
पीछे जाएं
बूलियन ज़रूरी नहीं
DangerType
फ़ाइल
डाउनलोड की गई फ़ाइल का नाम संदिग्ध है.
यूआरएल
डाउनलोड किए गए यूआरएल को नुकसान पहुंचाने वाला माना जाता है.
वीडियो
डाउनलोड की गई फ़ाइल नुकसान पहुंचाने वाला मानी जाती है.
असामान्य
डाउनलोड किए जाने वाले यूआरएल को आम तौर पर डाउनलोड नहीं किया जाता और यह खतरनाक हो सकता है.
होस्ट
यह डाउनलोड एक ऐसे होस्ट से किया गया था जो नुकसान पहुंचाने वाली बाइनरी फ़ाइलें डिस्ट्रिब्यूट करता है. इससे, नुकसान पहुंचाने की संभावना है.
अनचाही
डाउनलोड की गई फ़ाइल अनचाही या असुरक्षित हो सकती है. उदाहरण के लिए, यह ब्राउज़र या कंप्यूटर की सेटिंग में बदलाव कर सकता है.
सुरक्षित
डाउनलोड होने से उपयोगकर्ता के कंप्यूटर को कोई खतरा नहीं होता.
स्वीकार की गई
उपयोगकर्ता ने खतरनाक डाउनलोड स्वीकार कर लिया है.
Enum
"asyncLocalPasswordScanning"
"passwordProtected"
"sensitiveContentWarning"
"sensitiveContentBlock"
"promptForScanning"
"promptForLocalPasswordScanning"
DoubleDelta
प्रॉपर्टी
-
जो मौजूदा
नंबर ज़रूरी नहीं
-
पीछे जाएं
नंबर ज़रूरी नहीं
DownloadDelta
प्रॉपर्टी
-
canResume
BooleanDelta ज़रूरी नहीं
canResume
में बदलाव, अगर कोई है. -
खतरा
StringDelta ज़रूरी नहीं
danger
में बदलाव, अगर कोई है. -
endTime
StringDelta ज़रूरी नहीं
endTime
में बदलाव, अगर कोई है. -
गड़बड़ी
StringDelta ज़रूरी नहीं
error
में बदलाव, अगर कोई है. -
मौजूद है
BooleanDelta ज़रूरी नहीं
exists
में बदलाव, अगर कोई है. -
fileSize
DoubleDelta ज़रूरी नहीं
fileSize
में बदलाव, अगर कोई है. -
फ़ाइल का नाम
StringDelta ज़रूरी नहीं
filename
में बदलाव, अगर कोई है. -
finalUrl
StringDelta ज़रूरी नहीं
Chrome 54 और इसके बाद के वर्शनfinalUrl
में बदलाव, अगर कोई है. -
आईडी
नंबर
DownloadItem
काid
, जिसमें बदलाव हुआ है. -
माइम
StringDelta ज़रूरी नहीं
mime
में बदलाव, अगर कोई है. -
रोका गया
BooleanDelta ज़रूरी नहीं
paused
में बदलाव, अगर कोई है. -
startTime
StringDelta ज़रूरी नहीं
startTime
में बदलाव, अगर कोई है. -
state
StringDelta ज़रूरी नहीं
state
में बदलाव, अगर कोई है. -
totalBytes
DoubleDelta ज़रूरी नहीं
totalBytes
में बदलाव, अगर कोई है. -
यूआरएल
StringDelta ज़रूरी नहीं
url
में बदलाव, अगर कोई है.
DownloadItem
प्रॉपर्टी
-
byExtensionId
स्ट्रिंग ज़रूरी नहीं
उस एक्सटेंशन का आइडेंटिफ़ायर जिसने यह डाउनलोड शुरू किया था, अगर यह डाउनलोड किसी एक्सटेंशन से शुरू किया गया था. सेट करने के बाद नहीं बदलता.
-
byExtensionName
स्ट्रिंग ज़रूरी नहीं
उस एक्सटेंशन का स्थानीय जगह के हिसाब से नाम जिसने यह डाउनलोड शुरू किया था, अगर यह डाउनलोड किसी एक्सटेंशन से शुरू किया गया था. अगर एक्सटेंशन अपना नाम बदलता है या उपयोगकर्ता अपनी स्थान-भाषा बदलता है, तो एक्सटेंशन बदल सकता है.
-
bytesReceived
नंबर
फ़ाइल कंप्रेस किए बिना, होस्ट से अब तक मिले बाइट की संख्या.
-
canResume
boolean
अगर डाउनलोड प्रगति में है और रुका हुआ है, तो सही.
-
खतरा
इससे यह पता चलता है कि डाउनलोड सुरक्षित है या संदिग्ध है.
-
endTime
स्ट्रिंग ज़रूरी नहीं
वह समय जब डाउनलोड ISO 8601 फ़ॉर्मैट में खत्म हुआ. इसे सीधे तारीख बनाने वाले कंस्ट्रक्टर को पास किया जा सकता है:
chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})
-
गड़बड़ी
InterruptReason ज़रूरी नहीं
डाउनलोड क्यों रोका गया था. कई तरह की एचटीटीपी गड़बड़ियों को,
SERVER_
से शुरू होने वाली किसी एक गड़बड़ी में शामिल किया जा सकता है. नेटवर्क से जुड़ी गड़बड़ियांNETWORK_
से शुरू होती हैं, फ़ाइल सिस्टम पर फ़ाइल लिखने की प्रोसेस से जुड़ी गड़बड़ियांFILE_
से शुरू होती हैं और उपयोगकर्ता की ओर से शुरू की गई रुकावटेंUSER_
से शुरू होती हैं. -
estimatedEndTime
स्ट्रिंग ज़रूरी नहीं
ISO 8601 फ़ॉर्मैट में डाउनलोड पूरा होने का अनुमानित समय. इसे सीधे तारीख बनाने वाले कंस्ट्रक्टर को पास किया जा सकता है:
chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})
-
मौजूद है
boolean
क्या डाउनलोड की गई फ़ाइल अब भी मौजूद है. यह जानकारी पुरानी हो सकती है, क्योंकि Chrome अपने-आप फ़ाइल हटाने का अनुरोध नहीं करता. फ़ाइल मौजूद है या नहीं, इसकी जांच करने के लिए,
search
() को कॉल करें. मौजूदगी की जांच पूरी होने पर, अगर फ़ाइल मिटा दी गई है, तोonChanged
इवेंट फ़ायर होगा. ध्यान दें किsearch
(), मौजूद होने की जांच के खत्म होने का इंतज़ार नहीं करता. इसलिए, हो सकता है किsearch
() से मिलने वाले नतीजे, फ़ाइल सिस्टम को सही तरीके से न दिखाएं.search
() को ज़रूरत के मुताबिक कई बार कॉल किया जा सकता है. हालांकि, यह हर 10 सेकंड से ज़्यादा बार, फ़ाइल मौजूद होने की जांच नहीं करेगा. -
fileSize
नंबर
डिकंप्रेशन के बाद, पूरी फ़ाइल में बाइट की संख्या या अज्ञात होने पर -1.
-
फ़ाइल का नाम
स्ट्रिंग
ऐब्सलूट लोकल पाथ.
-
finalUrl
स्ट्रिंग
Chrome 54 और इसके बाद के वर्शनवह संपूर्ण यूआरएल जिससे यह डाउनलोड सभी रीडायरेक्ट के बाद बनाया जा रहा है.
-
आईडी
नंबर
ऐसा आइडेंटिफ़ायर जो ब्राउज़र के सभी सेशन में बना रहता है.
-
गुप्त मोड
boolean
अगर इस डाउनलोड को इतिहास में रिकॉर्ड किया गया है, तो गलत है. अगर इसे रिकॉर्ड नहीं किया जाता है, तो सही.
-
माइम
स्ट्रिंग
फ़ाइल का MIME टाइप.
-
रोका गया
boolean
अगर डाउनलोड ने होस्ट से डेटा पढ़ना बंद कर दिया है, लेकिन कनेक्शन को खुला रखा है, तो सही.
-
referrer
स्ट्रिंग
कुल यूआरएल.
-
startTime
स्ट्रिंग
वह समय जब ISO 8601 फ़ॉर्मैट में डाउनलोड शुरू हुआ. इसे सीधे तारीख बनाने वाले कंस्ट्रक्टर को पास किया जा सकता है:
chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})
-
state
यह बताता है कि डाउनलोड चल रहा है, रुक-रुककर चल रहा है या पूरा हो गया है.
-
totalBytes
नंबर
फ़ाइल कंप्रेस किए बिना पूरी फ़ाइल में बाइट की संख्या या अगर पता न हो, तो -1.
-
यूआरएल
स्ट्रिंग
वह पूरा यूआरएल जिससे यह डाउनलोड शुरू हुआ, किसी भी रीडायरेक्ट से पहले.
DownloadOptions
प्रॉपर्टी
-
body
स्ट्रिंग ज़रूरी नहीं
पोस्ट का मुख्य हिस्सा.
-
conflictAction
FilenameConflictAction ज़रूरी नहीं
अगर
filename
पहले से मौजूद है, तो यह कार्रवाई करें. -
फ़ाइल का नाम
स्ट्रिंग ज़रूरी नहीं
डाउनलोड की गई फ़ाइल को शामिल करने के लिए, डाउनलोड डायरेक्ट्री से जुड़ा फ़ाइल पाथ, जिसमें सबडायरेक्ट्री शामिल हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और बैक-रेफ़रंस ".." वाले पाथ से गड़बड़ी होगी.
onDeterminingFilename
, फ़ाइल का MIME टाइप और अस्थायी फ़ाइल नाम मिलने के बाद, फ़ाइल के नाम का सुझाव देने की अनुमति देता है. -
headers
HeaderNameValuePair[] ज़रूरी नहीं
अगर यूआरएल एचटीटीपी[s] प्रोटोकॉल का इस्तेमाल करता है, तो अनुरोध के साथ भेजने के लिए अतिरिक्त एचटीटीपी हेडर. हर हेडर एक डिक्शनरी के तौर पर दिखाया जाता है. इसमें
name
के साथ-साथvalue
याbinaryValue
की कुंजियां शामिल होती हैं. यह सिर्फ़ XMLHttpRequest के ज़रिए अनुमति दी जाती है. -
method
HttpMethod ज़रूरी नहीं
अगर यूआरएल, एचटीटीपी[S] प्रोटोकॉल का इस्तेमाल करता है, तो एचटीटीपी वाला तरीका.
-
saveAs
बूलियन ज़रूरी नहीं
फ़ाइल चुनने की सुविधा का इस्तेमाल करके, उपयोगकर्ता को फ़ाइल का नाम चुनने की अनुमति देनी है. भले ही,
filename
सेट हो या पहले से मौजूद हो. -
यूआरएल
स्ट्रिंग
डाउनलोड करने के लिए यूआरएल.
DownloadQuery
प्रॉपर्टी
-
bytesReceived
नंबर ज़रूरी नहीं
फ़ाइल कंप्रेस किए बिना, होस्ट से अब तक मिले बाइट की संख्या.
-
खतरा
DangerType ज़रूरी नहीं
इससे यह पता चलता है कि डाउनलोड सुरक्षित है या संदिग्ध है.
-
endTime
स्ट्रिंग ज़रूरी नहीं
वह समय जब डाउनलोड ISO 8601 फ़ॉर्मैट में खत्म हुआ.
-
endedAfter
स्ट्रिंग ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है, जो ISO 8601 फ़ॉर्मैट में दिए गए MS के बाद खत्म होते हैं -
endedBefore
स्ट्रिंग ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है, जो ISO 8601 फ़ॉर्मैट में दिए गए MS से पहले खत्म होते हैं. -
गड़बड़ी
InterruptReason ज़रूरी नहीं
डाउनलोड में रुकावट क्यों हुई.
-
मौजूद है
बूलियन ज़रूरी नहीं
क्या डाउनलोड की गई फ़ाइल मौजूद है;
-
fileSize
नंबर ज़रूरी नहीं
डिकंप्रेशन के बाद, पूरी फ़ाइल में बाइट की संख्या या अज्ञात होने पर -1.
-
फ़ाइल का नाम
स्ट्रिंग ज़रूरी नहीं
ऐब्सलूट लोकल पाथ.
-
filenameRegex
स्ट्रिंग ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है जिनकाfilename
, दिए गए रेगुलर एक्सप्रेशन से मेल खाता है. -
finalUrl
स्ट्रिंग ज़रूरी नहीं
Chrome 54 और इसके बाद के वर्शनवह संपूर्ण यूआरएल जिससे यह डाउनलोड सभी रीडायरेक्ट के बाद बनाया जा रहा है.
-
finalUrlRegex
स्ट्रिंग ज़रूरी नहीं
Chrome 54 और इसके बाद के वर्शननतीजों को
DownloadItem
तक सीमित करता है जिनकाfinalUrl
, दिए गए रेगुलर एक्सप्रेशन से मेल खाता है. -
आईडी
नंबर ज़रूरी नहीं
क्वेरी करने के लिए
DownloadItem
काid
. -
सीमा
नंबर ज़रूरी नहीं
मेल खाने वाले ज़्यादा से ज़्यादा
DownloadItem
नतीजे दिखाए जा सकते हैं. डिफ़ॉल्ट वैल्यू 1000 होती है. मिलते-जुलते सभीDownloadItem
लौटाने के लिए, 0 पर सेट करें. नतीजों को पेज में बांटने का तरीका जानने के लिए,search
पर जाएं. -
माइम
स्ट्रिंग ज़रूरी नहीं
फ़ाइल का MIME टाइप.
-
orderBy
स्ट्रिंग[] ज़रूरी नहीं है
खोज के नतीजों को क्रम से लगाने के लिए, इस कलेक्शन के एलिमेंट को
DownloadItem
प्रॉपर्टी पर सेट करें. उदाहरण के लिए,orderBy=['startTime']
को सेट करने पर,DownloadItem
को उनके शुरू होने के समय के हिसाब से बढ़ते क्रम में लगाया जाता है. घटते क्रम में तय करने के लिए, प्रीफ़िक्स के साथ हाइफ़न लगाएं: '-startTime'. -
रोका गया
बूलियन ज़रूरी नहीं
अगर डाउनलोड ने होस्ट से डेटा पढ़ना बंद कर दिया है, लेकिन कनेक्शन को खुला रखा है, तो सही.
-
query
स्ट्रिंग[] ज़रूरी नहीं है
खोज के लिए इस्तेमाल हुए शब्दों की यह कैटगरी, नतीजों को
DownloadItem
तक सीमित करती है. इनकेfilename
याurl
याfinalUrl
में वे सभी शब्द शामिल हैं जो डैश '-' से शुरू नहीं होते. साथ ही, इनमें खोज के लिए इस्तेमाल होने वाला ऐसा कोई भी शब्द नहीं है जो डैश से शुरू नहीं होता. -
startTime
स्ट्रिंग ज़रूरी नहीं
वह समय जब ISO 8601 फ़ॉर्मैट में डाउनलोड शुरू हुआ.
-
startedAfter
स्ट्रिंग ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है, जो ISO 8601 फ़ॉर्मैट में दिए गए MS के बाद शुरू हुए थे. -
startedBefore
स्ट्रिंग ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है, जो ISO 8601 फ़ॉर्मैट में दिए गए MS से पहले शुरू हुआ था. -
state
राज्य ज़रूरी नहीं
यह बताता है कि डाउनलोड चल रहा है, रुक-रुककर चल रहा है या पूरा हो गया है.
-
totalBytes
नंबर ज़रूरी नहीं
फ़ाइल कंप्रेस किए बिना पूरी फ़ाइल में बाइट की संख्या या अगर पता न हो, तो -1.
-
totalBytesGreater
नंबर ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है जिनकाtotalBytes
दिए गए पूर्णांक से बड़ा है. -
totalBytesLess
नंबर ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है जिनकाtotalBytes
, दिए गए पूर्णांक से कम है. -
यूआरएल
स्ट्रिंग ज़रूरी नहीं
वह पूरा यूआरएल जिससे यह डाउनलोड शुरू हुआ, किसी भी रीडायरेक्ट से पहले.
-
urlRegex
स्ट्रिंग ज़रूरी नहीं
नतीजों को
DownloadItem
तक सीमित करता है जिनकाurl
, दिए गए रेगुलर एक्सप्रेशन से मेल खाता है.
FilenameConflictAction
एक जैसा
डुप्लिकेशन से बचने के लिए, filename
को बदल दिया जाता है, ताकि फ़ाइल नाम के एक्सटेंशन से पहले काउंटर शामिल किया जा सके.
ओवरराइट करें
मौजूदा फ़ाइल को नई फ़ाइल से बदल दिया जाएगा.
मैसेज
उपयोगकर्ता को फ़ाइल चुनने के लिए एक डायलॉग बॉक्स दिखेगा.
Enum
FilenameSuggestion
प्रॉपर्टी
-
conflictAction
FilenameConflictAction ज़रूरी नहीं
अगर
filename
पहले से मौजूद है, तो यह कार्रवाई करें. -
फ़ाइल का नाम
स्ट्रिंग
DownloadItem
का नया टारगेटDownloadItem.filename
, उपयोगकर्ता की डिफ़ॉल्ट डाउनलोड डायरेक्ट्री से जुड़े पाथ के तौर पर हो सकता है. इसमें सबडायरेक्ट्री शामिल हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और ऐसे पाथ को अनदेखा कर दिया जाएगा जिनमें बैक-रेफ़रंस ".." शामिल हैं. अगर किसी भी एक्सटेंशन के ज़रिए रजिस्टर किया गया कोईonDeterminingFilename
लिसनर है, तोfilename
को अनदेखा कर दिया जाता है.
GetFileIconOptions
प्रॉपर्टी
-
साइज़
ज़रूरी नहीं है
लौटाए गए आइकॉन का साइज़. आइकॉन, डाइमेंशन साइज़ * साइज़ पिक्सल वाला स्क्वेयर होगा. आइकॉन का डिफ़ॉल्ट और सबसे बड़ा साइज़ 32x32 पिक्सल है. सिर्फ़ 16 और 32 साइज़ इस्तेमाल किए जा सकते हैं. कोई दूसरा साइज़ तय करना एक गड़बड़ी है.
HeaderNameValuePair
प्रॉपर्टी
-
नाम
स्ट्रिंग
एचटीटीपी हेडर का नाम.
-
value
स्ट्रिंग
एचटीटीपी हेडर की वैल्यू.
HttpMethod
Enum
"GET"
InterruptReason
Enum
"FILE_FAILED"
"FILE_ACCESS_DENIED"
"FILE_NO_SPACE"
"FILE_TOO_LARGE"
"FILE_VIRUS_INFECTED"
"FILE_TRANSIENT_ERROR"
"FILE_BLOCKED"
"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_CONTENT_LENGTH_MISMATCH"
"USER_CANCELED"
"USER_SHUTDOWN"
State
in_progress
डाउनलोड में फ़िलहाल सर्वर से डेटा मिल रहा है.
रुका हुआ है
किसी गड़बड़ी की वजह से, फ़ाइल होस्ट से कनेक्शन टूट गया है.
पूरा हो गया
डाउनलोड हो गया.
Enum
"in_progress"
StringDelta
प्रॉपर्टी
-
जो मौजूदा
स्ट्रिंग ज़रूरी नहीं
-
पीछे जाएं
स्ट्रिंग ज़रूरी नहीं
UiOptions
प्रॉपर्टी
-
चालू किया गया
boolean
डाउनलोड यूज़र इंटरफ़ेस (यूआई) चालू या बंद करें.
तरीके
acceptDanger()
chrome.downloads.acceptDanger(
downloadId: number,
callback?: function,
)
उपयोगकर्ता से किसी खतरनाक डाउनलोड को स्वीकार करने का अनुरोध करें. इसे सिर्फ़ दिखने वाले कॉन्टेक्स्ट (टैब, विंडो या पेज/ब्राउज़र ऐक्शन पॉप-अप) से कॉल किया जा सकता है. नुकसान पहुंचाने वाले डाउनलोड अपने-आप स्वीकार नहीं किए जाते. अगर डाउनलोड स्वीकार कर लिया जाता है, तो onChanged
इवेंट फ़ायर होगा, वरना कुछ भी नहीं होगा. जब सारा डेटा किसी अस्थायी फ़ाइल में फ़ेच किया जाता है और डाउनलोड किया गया डेटा खतरनाक नहीं होता या खतरा स्वीकार किया जाता है, तो अस्थायी फ़ाइल का नाम टारगेट फ़ाइल नाम में बदल दिया जाता है. इसके बाद, state
'पूरा हो गया' में बदल जाता है और onChanged
ट्रिगर हो जाता है.
पैरामीटर
-
downloadId
नंबर
DownloadItem
के लिए आइडेंटिफ़ायर. -
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
लौटाए गए प्रॉडक्ट
-
Promise<void>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
cancel()
chrome.downloads.cancel(
downloadId: number,
callback?: function,
)
डाउनलोड रद्द करना. callback
चलने पर, डाउनलोड रद्द हो जाता है, पूरा हो जाता है, उसमें रुकावट आती है या वह अब मौजूद नहीं है.
पैरामीटर
-
downloadId
नंबर
रद्द करने के लिए डाउनलोड का आईडी.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
लौटाए गए प्रॉडक्ट
-
Promise<void>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
download()
chrome.downloads.download(
options: DownloadOptions,
callback?: function,
)
यूआरएल डाउनलोड करें. अगर यूआरएल, एचटीटीपी[S] प्रोटोकॉल का इस्तेमाल करता है, तो अनुरोध में वे सभी कुकी शामिल की जाएंगी जो फ़िलहाल इसके होस्टनेम के लिए सेट की गई हैं. अगर filename
और saveAs
, दोनों के बारे में बताया गया है, तो इस रूप में सेव करें डायलॉग दिखाया जाएगा. यह डायलॉग, पहले से ही filename
के साथ अपने-आप भर जाएगा. अगर डाउनलोड शुरू हो जाता है, तो callback
को नए DownloadItem
के downloadId
के साथ कॉल किया जाएगा. अगर डाउनलोड शुरू करने में कोई गड़बड़ी हुई है, तो callback
को downloadId=undefined
के साथ कॉल किया जाएगा और runtime.lastError
में जानकारी देने वाली स्ट्रिंग होगी. इस बात की कोई गारंटी नहीं है कि गड़बड़ी वाली स्ट्रिंग, रिलीज़ के बीच पुराने सिस्टम के साथ काम करेंगी. एक्सटेंशन को इसे पार्स नहीं करना चाहिए.
पैरामीटर
-
विकल्प
क्या डाउनलोड करना है और कैसे करना है.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(downloadId: number) => void
-
downloadId
नंबर
-
लौटाए गए प्रॉडक्ट
-
वादा<number>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
erase()
chrome.downloads.erase(
query: DownloadQuery,
callback?: function,
)
डाउनलोड की गई फ़ाइल को मिटाए बिना, इतिहास से DownloadItem
से मेल खाने वाले डेटा को हमेशा के लिए मिटाएं. query
से मेल खाने वाले हर DownloadItem
के लिए, onErased
इवेंट सक्रिय होगा. इसके बाद, callback
कॉल किया जाएगा.
पैरामीटर
-
query
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(erasedIds: number[]) => void
-
erasedIds
नंबर[]
-
लौटाए गए प्रॉडक्ट
-
वादा करें<number[]>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
getFileIcon()
chrome.downloads.getFileIcon(
downloadId: number,
options?: GetFileIconOptions,
callback?: function,
)
तय किए गए डाउनलोड के लिए आइकॉन पाएं. नए डाउनलोड के लिए, onCreated
इवेंट मिलने के बाद फ़ाइल आइकॉन उपलब्ध होंगे. डाउनलोड पूरा होने के दौरान इस फ़ंक्शन से दिखाई गई इमेज, डाउनलोड पूरा होने के बाद दिखाई गई इमेज से अलग हो सकती है. आइकॉन वापस पाने के लिए, प्लैटफ़ॉर्म के हिसाब से ऑपरेटिंग सिस्टम या टूलकिट के बारे में क्वेरी की जाती है. इसलिए, दिखने वाला आइकॉन कई चीज़ों पर निर्भर करता है. इनमें डाउनलोड की स्थिति, प्लैटफ़ॉर्म, रजिस्टर किए गए फ़ाइल टाइप, और विज़ुअल थीम शामिल हैं. अगर फ़ाइल आइकॉन का पता नहीं चलता, तो runtime.lastError
में गड़बड़ी का मैसेज दिखेगा.
पैरामीटर
-
downloadId
नंबर
डाउनलोड के लिए आइडेंटिफ़ायर.
-
विकल्प
GetFileIconOptions ज़रूरी नहीं
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(iconURL?: string) => void
-
iconURL
स्ट्रिंग ज़रूरी नहीं
-
लौटाए गए प्रॉडक्ट
-
Promise<string | undefined>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
open()
chrome.downloads.open(
downloadId: number,
callback?: function,
)
अगर DownloadItem
पूरा हो गया है, तो डाउनलोड की गई फ़ाइल को अभी खोलता है. ऐसा न होने पर, runtime.lastError
के ज़रिए गड़बड़ी दिखाता है. इस तरीके के लिए, "downloads"
के साथ-साथ "downloads.open"
की अनुमति भी ज़रूरी है. किसी आइटम को पहली बार खोलने पर onChanged
इवेंट ट्रिगर होता है. इस तरीके को सिर्फ़ उपयोगकर्ता जेस्चर के जवाब में कॉल किया जा सकता है.
पैरामीटर
-
downloadId
नंबर
डाउनलोड की गई फ़ाइल का आइडेंटिफ़ायर.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
Chrome 123 के बाद के वर्शनcallback
पैरामीटर ऐसा दिखता है:() => void
लौटाए गए प्रॉडक्ट
-
Promise<void>
Chrome 123 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
pause()
chrome.downloads.pause(
downloadId: number,
callback?: function,
)
डाउनलोड रोकें. अगर अनुरोध पूरा हो जाता है, तो डाउनलोड रुकी हुई स्थिति में होता है. अगर ऐसा नहीं है, तो runtime.lastError
में गड़बड़ी का मैसेज है. डाउनलोड की सुविधा चालू न होने पर, अनुरोध रद्द हो जाएगा.
पैरामीटर
-
downloadId
नंबर
डाउनलोड रोकने के लिए आईडी.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
लौटाए गए प्रॉडक्ट
-
Promise<void>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
removeFile()
chrome.downloads.removeFile(
downloadId: number,
callback?: function,
)
अगर डाउनलोड की गई फ़ाइल मौजूद है और DownloadItem
पूरा है, तो उसे हटाएं. ऐसा न करने पर, runtime.lastError
की मदद से गड़बड़ी का मैसेज दिखाएं.
पैरामीटर
-
downloadId
नंबर
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
लौटाए गए प्रॉडक्ट
-
Promise<void>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
resume()
chrome.downloads.resume(
downloadId: number,
callback?: function,
)
रोके गए डाउनलोड को फिर से शुरू करें. अगर अनुरोध पूरा हो जाता है, तो डाउनलोड की प्रोसेस जारी है और रोक हटा दी जाएगी. अगर ऐसा नहीं है, तो runtime.lastError
में गड़बड़ी का मैसेज है. डाउनलोड की सुविधा चालू न होने पर, अनुरोध रद्द हो जाएगा.
पैरामीटर
-
downloadId
नंबर
डाउनलोड फिर से शुरू करने के लिए आईडी.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
लौटाए गए प्रॉडक्ट
-
Promise<void>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
search()
chrome.downloads.search(
query: DownloadQuery,
callback?: function,
)
DownloadItem
को ढूंढें. सभी DownloadItem
पाने के लिए, query
को खाली ऑब्जेक्ट पर सेट करें. कोई खास DownloadItem
पाने के लिए, सिर्फ़ id
फ़ील्ड को सेट करें. बड़ी संख्या में आइटम पेज देखने के लिए, orderBy: ['-startTime']
सेट करें. इसके बाद, limit
को हर पेज के आइटम की संख्या पर सेट करें और startedAfter
को आखिरी पेज के आखिरी आइटम के startTime
पर सेट करें.
पैरामीटर
-
query
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(results: DownloadItem[]) => void
-
नतीजे
-
लौटाए गए प्रॉडक्ट
-
Promise<DownloadItem[]>
Chrome 96 के बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
setShelfEnabled()
chrome.downloads.setShelfEnabled(
enabled: boolean,
)
इसके बजाय, setUiOptions
का इस्तेमाल करें.
मौजूदा ब्राउज़र प्रोफ़ाइल से जुड़ी हर विंडो के नीचे मौजूद स्लेटी रंग की शेल्फ़ को चालू या बंद करें. यह शेल्फ़ तब तक बंद रहेगी, जब तक कम से कम किसी एक एक्सटेंशन ने उसे बंद नहीं किया होगा. अगर शेल्फ़ को चालू करने पर कम से कम एक अन्य एक्सटेंशन बंद हो जाता है, तो runtime.lastError
से गड़बड़ी दिखेगी. "downloads"
अनुमति के साथ-साथ, "downloads.shelf"
की अनुमति भी ज़रूरी है.
पैरामीटर
-
चालू किया गया
boolean
setUiOptions()
chrome.downloads.setUiOptions(
options: UiOptions,
callback?: function,
)
मौजूदा ब्राउज़र प्रोफ़ाइल से जुड़ी हर विंडो के डाउनलोड यूज़र इंटरफ़ेस (यूआई) को बदलें. जब तक कम से कम एक एक्सटेंशन UiOptions.enabled
को गलत पर सेट करता है, तब तक डाउनलोड यूज़र इंटरफ़ेस (यूआई) छिपा रहेगा. अगर कम से कम एक अन्य एक्सटेंशन के बंद होने पर UiOptions.enabled
को 'सही है' पर सेट किया जाता है, तो यह runtime.lastError
की मदद से गड़बड़ी दिखाएगा. "downloads"
अनुमति के साथ-साथ, "downloads.ui"
की अनुमति भी ज़रूरी है.
पैरामीटर
-
विकल्प
डाउनलोड यूज़र इंटरफ़ेस (यूआई) में बदलाव शामिल करें.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
लौटाए गए प्रॉडक्ट
-
Promise<void>
प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
show()
chrome.downloads.show(
downloadId: number,
)
डाउनलोड की गई फ़ाइल को फ़ाइल मैनेजर में उसके फ़ोल्डर में दिखाएं.
पैरामीटर
-
downloadId
नंबर
डाउनलोड की गई फ़ाइल का आइडेंटिफ़ायर.
showDefaultFolder()
chrome.downloads.showDefaultFolder()
फ़ाइल मैनेजर में डिफ़ॉल्ट डाउनलोड फ़ोल्डर दिखाएं.
इवेंट
onChanged
chrome.downloads.onChanged.addListener(
callback: function,
)
जब bytesReceived
और estimatedEndTime
को छोड़कर, DownloadItem
की किसी भी प्रॉपर्टी में बदलाव होता है, तो यह इवेंट downloadId
और उस प्रॉपर्टी के साथ ट्रिगर होता है जिसमें बदलाव हुआ है.
पैरामीटर
-
कॉलबैक
function
callback
पैरामीटर ऐसा दिखता है:(downloadDelta: DownloadDelta) => void
-
downloadDelta
-
onCreated
chrome.downloads.onCreated.addListener(
callback: function,
)
डाउनलोड शुरू होने पर, यह इवेंट DownloadItem
ऑब्जेक्ट के साथ सक्रिय होता है.
पैरामीटर
-
कॉलबैक
function
callback
पैरामीटर ऐसा दिखता है:(downloadItem: DownloadItem) => void
-
downloadItem
-
onDeterminingFilename
chrome.downloads.onDeterminingFilename.addListener(
callback: function,
)
फ़ाइल का नाम तय करने की प्रोसेस के दौरान, एक्सटेंशन को टारगेट DownloadItem.filename
को बदलने का मौका दिया जाएगा. हर एक्सटेंशन, इस इवेंट के लिए एक से ज़्यादा लिसनर को रजिस्टर नहीं कर सकता. हर लिसनर को suggest
को ठीक एक बार कॉल करना होगा. इसके लिए, सिंक्रोनस (एसिंक्रोनस तरीके से) या एसिंक्रोनस रूप से कॉल किया जाएगा. अगर लिसनर, suggest
को एसिंक्रोनस रूप से कॉल करता है, तो उसे true
मिलना चाहिए. अगर लिसनर, न तो suggest
को सिंक करता है और न ही true
को रिटर्न करता है, तो suggest
को अपने-आप कॉल किया जाएगा. जब तक सभी श्रोता suggest
को कॉल नहीं कर लेते, तब तक DownloadItem
पूरा नहीं होगा. डाउनलोड को उसके फ़ाइल नाम के लिए downloadItem.filename
का इस्तेमाल करने देने के लिए, श्रोता बिना किसी तर्क के suggest
को कॉल कर सकते हैं या टारगेट फ़ाइल नाम को बदलने के लिए suggest
को suggestion
ऑब्जेक्ट पास कर सकते हैं. अगर एक से ज़्यादा एक्सटेंशन, फ़ाइल नाम को ओवरराइड करते हैं, तो वह आखिरी एक्सटेंशन इंस्टॉल किया जाएगा जिसका लिसनर, suggestion
ऑब्जेक्ट को suggest
पास करता है. कौनसा एक्सटेंशन विजेता होगा, इस बारे में भ्रम से बचने के लिए उपयोगकर्ताओं को ऐसे एक्सटेंशन इंस्टॉल नहीं करने चाहिए, जो विरोध कर सकते हों. अगर डाउनलोड download
से शुरू हो जाता है और MIME टाइप और संभावित फ़ाइल नाम तय होने से पहले ही टारगेट फ़ाइल का नाम पता चल जाता है, तो filename
को download
पर पास करें.
पैरामीटर
-
कॉलबैक
function
callback
पैरामीटर ऐसा दिखता है:(downloadItem: DownloadItem, suggest: function) => void
-
downloadItem
-
सुझाव
function
suggest
पैरामीटर ऐसा दिखता है:(suggestion?: FilenameSuggestion) => void
-
सुझाव
FilenameSuggestion ज़रूरी नहीं
-
-
onErased
chrome.downloads.onErased.addListener(
callback: function,
)
जब किसी डाउनलोड को इतिहास से मिटा दिया जाता है, तब downloadId
से सक्रिय होता है.
पैरामीटर
-
कॉलबैक
function
callback
पैरामीटर ऐसा दिखता है:(downloadId: number) => void
-
downloadId
नंबर
-