इस अनुमति से चेतावनी ट्रिगर होती है
ब्यौरा
प्रोग्राम के हिसाब से डाउनलोड शुरू करने, उनकी निगरानी करने, उनमें बदलाव करने, और उन्हें खोजने के लिए, chrome.downloads
API का इस्तेमाल करें.
अनुमतियां
downloads
मेनिफ़ेस्ट
इस एपीआई का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "downloads"
अनुमति का एलान करना होगा.
{
"name": "My extension",
...
"permissions": [
"downloads"
],
...
}
उदाहरण
chrome.downloads
API को इस्तेमाल करने के आसान उदाहरण, examples/api/download में मिल सकते हैं
डायरेक्ट्री. अन्य उदाहरणों के लिए और सोर्स कोड देखने में मदद पाने के लिए, सैंपल देखें.
टाइप
BooleanDelta
प्रॉपर्टी
-
जो मौजूदा
बूलियन ज़रूरी नहीं
-
पीछे जाएं
बूलियन ज़रूरी नहीं
DangerType
फ़ाइल
डाउनलोड की गई फ़ाइल का नाम संदिग्ध है.
url
डाउनलोड किए गए यूआरएल को नुकसान पहुंचाने वाला माना जाता है.
कॉन्टेंट
डाउनलोड की गई फ़ाइल नुकसान पहुंचाने वाली होती है.
असामान्य
डाउनलोड का यूआरएल आम तौर पर डाउनलोड नहीं किया जाता है और यह खतरनाक हो सकता है.
होस्ट
यह डाउनलोड एक ऐसे होस्ट से आया था जो नुकसान पहुंचाने वाले बाइनरी डिस्ट्रिब्यूट करने के लिए जाना जाता है. यह खतरनाक भी हो सकता है.
अनचाहा
डाउनलोड किया गया कॉन्टेंट अनचाहा या असुरक्षित हो सकता है. उदाहरण के लिए, तो ब्राउज़र या कंप्यूटर की सेटिंग में बदलाव हो सकते हैं.
सुरक्षित
डाउनलोड करने से उपयोगकर्ता के कंप्यूटर को कोई खतरा नहीं होता.
स्वीकृत
उपयोगकर्ता ने खतरनाक डाउनलोड को स्वीकार कर लिया है.
Enum
"asyncScanning"
"asyncLocalPasswordScanning"
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
में कोई बदलाव है, तो वह. -
राज्य
StringDelta ज़रूरी नहीं
अगर
state
में कोई बदलाव है, तो वह. -
totalBytes
DoubleDelta ज़रूरी नहीं है
अगर
totalBytes
में कोई बदलाव है, तो वह. -
url
StringDelta ज़रूरी नहीं
अगर
url
में कोई बदलाव है, तो वह.
DownloadItem
प्रॉपर्टी
-
byExtensionId
स्ट्रिंग ज़रूरी नहीं
अगर यह डाउनलोड किसी एक्सटेंशन से किया गया है, तो उस एक्सटेंशन का आइडेंटिफ़ायर जिसने यह डाउनलोड शुरू किया. सेट करने के बाद नहीं बदलता.
-
byExtensionName
स्ट्रिंग ज़रूरी नहीं
अगर यह डाउनलोड किसी एक्सटेंशन से हुआ है, तो उस एक्सटेंशन का स्थानीय नाम. इस नाम से यह डाउनलोड शुरू हुआ. अगर एक्सटेंशन का नाम बदलता है या उपयोगकर्ता अपनी स्थान-भाषा को बदलता है, तो यह बदल सकता है.
-
bytesReceived
संख्या
फ़ाइल कंप्रेस किए बिना, होस्ट से अब तक मिली बाइट की संख्या.
-
canResume
बूलियन
अगर डाउनलोड जारी है और रुक गया है, तो यह 'सही' होगा. इसके अलावा, अगर डाउनलोड रुक गया है, तो उसे वहीं से शुरू किया जा सकता है जहां उसे रोका गया था.
-
खतरा
इससे यह पता चलता है कि डाउनलोड किया गया कॉन्टेंट सुरक्षित है या संदिग्ध.
-
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))})})
-
मौजूद है
बूलियन
डाउनलोड की गई फ़ाइल अब भी मौजूद है या नहीं. यह जानकारी पुरानी हो सकती है. इसकी वजह यह है कि Chrome, फ़ाइल हटाने का अनुरोध अपने-आप नहीं करता. फ़ाइल मौजूद है या नहीं, इसकी जांच को ट्रिगर करने के लिए
search
() को कॉल करें. अगर फ़ाइल मिटा दी गई है, तो मौजूदगी की जांच पूरी होने के बाद,onChanged
इवेंट ट्रिगर हो जाएगा. ध्यान दें किsearch
(), वापस आने से पहले, जांच के खत्म होने का इंतज़ार नहीं करता. इसलिए, हो सकता है किsearch
() के नतीजे, फ़ाइल सिस्टम को सही तरीके से न दिखाएं. साथ ही, ज़रूरत पड़ने परsearch
() को कॉल किया जा सकता है. हालांकि, यह हर 10 सेकंड में एक बार से ज़्यादा बार फ़ाइल की मौजूदगी की जांच नहीं करेगा. -
fileSize
संख्या
डीकंप्रेशन के बाद पूरी फ़ाइल में बाइट की संख्या या अगर पता नहीं है, तो -1.
-
फ़ाइल का नाम
स्ट्रिंग
ऐब्सलूट लोकल पाथ.
-
finalUrl
स्ट्रिंग
Chrome 54 और उसके बाद वाले वर्शन के लिएसभी रीडायरेक्ट के बाद, उस संपूर्ण यूआरएल से जिससे डाउनलोड किया जा रहा है.
-
आईडी
संख्या
ऐसा आइडेंटिफ़ायर जो सभी ब्राउज़र सेशन में स्थायी होता है.
-
गुप्त मोड
बूलियन
गलत है, अगर इस डाउनलोड को इतिहास में रिकॉर्ड किया गया है, तो इसे रिकॉर्ड न किए जाने पर सही रखा जाता है.
-
माइम
स्ट्रिंग
फ़ाइल का MIME टाइप.
-
रोका गया
बूलियन
अगर डाउनलोड ने होस्ट का डेटा पढ़ना बंद कर दिया है, लेकिन कनेक्शन खुला रखा है, तो 'सही' होगा.
-
रेफ़रल देने वाला
स्ट्रिंग
पूरा यूआरएल.
-
startTime
स्ट्रिंग
ISO 8601 फ़ॉर्मैट में, डाउनलोड शुरू होने का समय. सीधे तारीख कंस्ट्रक्टर को पास किया जा सकता है:
chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})
-
राज्य
यह बताता है कि डाउनलोड जारी है, उसमें रुकावट आ रही है या पूरा हो गया है.
-
totalBytes
संख्या
फ़ाइल कंप्रेस किए बिना, पूरी फ़ाइल में बाइट की संख्या या अगर जानकारी नहीं है, तो -1.
-
url
स्ट्रिंग
वह संपूर्ण यूआरएल जिससे डाउनलोड किया गया है, यानी किसी दूसरे वेबलिंक पर भेजने से पहले.
DownloadOptions
प्रॉपर्टी
-
शरीर
स्ट्रिंग ज़रूरी नहीं
पोस्ट का मुख्य हिस्सा.
-
conflictAction
FilenameConflictAction ज़रूरी नहीं
filename
के मौजूद होने पर की जाने वाली कार्रवाई. -
फ़ाइल का नाम
स्ट्रिंग ज़रूरी नहीं
डाउनलोड की गई फ़ाइल को शामिल करने के लिए, डाउनलोड डायरेक्ट्री के हिसाब से बनाया गया फ़ाइल पाथ. इसमें सबडायरेक्ट्री शामिल हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और पाथ में बैक-रेफ़रंस ".." गड़बड़ी की वजह बनेगा.
onDeterminingFilename
, फ़ाइल के MIME टाइप और संभावित फ़ाइल नाम की पहचान होने के बाद, फ़ाइल नाम का सुझाव देने की अनुमति देता है. -
हेडर
HeaderNameValuePair[] ज़रूरी नहीं
अगर यूआरएल, एचटीटीपी[s] प्रोटोकॉल का इस्तेमाल करता है, तो अनुरोध के साथ भेजने के लिए अतिरिक्त एचटीटीपी हेडर. हर हेडर को एक डिक्शनरी के तौर पर दिखाया जाता है, जिसमें
name
कुंजियां होती हैं. साथ ही, इसमेंvalue
याbinaryValue
कुंजियां भी होती हैं. हालांकि, इन कुंजियों को XMLHttpRequest से अनुमति मिलती है. -
तरीका
HttpMethod ज़रूरी नहीं
अगर यूआरएल, एचटीटीपी[S] प्रोटोकॉल का इस्तेमाल करता है, तो एचटीटीपी तरीका इस्तेमाल किया जाएगा.
-
saveAs
बूलियन ज़रूरी नहीं
filename
सेट है या पहले से मौजूद है, इस पर ध्यान दिए बिना उपयोगकर्ता को फ़ाइल नाम चुनने की अनुमति देने के लिए फ़ाइल-चुनने वाले का इस्तेमाल करें. -
url
स्ट्रिंग
डाउनलोड किया जाने वाला यूआरएल.
DownloadQuery
प्रॉपर्टी
-
bytesReceived
नंबर वैकल्पिक
फ़ाइल कंप्रेस किए बिना, होस्ट से अब तक मिली बाइट की संख्या.
-
खतरा
DangerType ज़रूरी नहीं
इससे यह पता चलता है कि डाउनलोड किया गया कॉन्टेंट सुरक्षित है या संदिग्ध.
-
endTime
स्ट्रिंग ज़रूरी नहीं
ISO 8601 फ़ॉर्मैट में डाउनलोड खत्म होने का समय.
-
endedAfter
स्ट्रिंग ज़रूरी नहीं
ISO 8601 फ़ॉर्मैट में दिए गए मि॰से॰ के बाद खत्म होने वाले
DownloadItem
नतीजों को सीमित करता है -
endedBefore
स्ट्रिंग ज़रूरी नहीं
ISO 8601 फ़ॉर्मैट में दिए गए MS से पहले खत्म होने वाले
DownloadItem
नतीजों को सीमित करता है. -
गड़बड़ी
InterruptReason ज़रूरी नहीं
डाउनलोड में रुकावट क्यों आई.
-
मौजूद है
बूलियन ज़रूरी नहीं
डाउनलोड की गई फ़ाइल मौजूद है या नहीं;
-
fileSize
नंबर वैकल्पिक
डीकंप्रेशन के बाद पूरी फ़ाइल में बाइट की संख्या या अगर पता नहीं है, तो -1.
-
फ़ाइल का नाम
स्ट्रिंग ज़रूरी नहीं
ऐब्सलूट लोकल पाथ.
-
filenameRegex
स्ट्रिंग ज़रूरी नहीं
नतीजों को सिर्फ़
DownloadItem
तक सीमित करता है, जिसकाfilename
दिए गए रेगुलर एक्सप्रेशन से मेल खाता है. -
finalUrl
स्ट्रिंग ज़रूरी नहीं
Chrome 54 और उसके बाद वाले वर्शन के लिएसभी रीडायरेक्ट के बाद, उस संपूर्ण यूआरएल से जिससे डाउनलोड किया जा रहा है.
-
finalUrlRegex
स्ट्रिंग ज़रूरी नहीं
Chrome 54 और उसके बाद वाले वर्शन के लिएनतीजों को सिर्फ़
DownloadItem
तक सीमित करता है, जिसकाfinalUrl
दिए गए रेगुलर एक्सप्रेशन से मेल खाता है. -
आईडी
नंबर वैकल्पिक
क्वेरी करने के लिए
DownloadItem
काid
. -
सीमा
नंबर वैकल्पिक
मिलान करने वाले
DownloadItem
की ज़्यादा से ज़्यादा संख्या दिखाई गई. डिफ़ॉल्ट तौर पर, यह 1,000 पर सेट होता है. मिलान करने वाले सभीDownloadItem
दिखाने के लिए 0 पर सेट करें. पेज पर खोज के नतीजे पाने का तरीका जानने के लिए,search
पर जाएं. -
माइम
स्ट्रिंग ज़रूरी नहीं
फ़ाइल का MIME टाइप.
-
orderBy
स्ट्रिंग[] ज़रूरी नहीं
खोज के नतीजों को क्रम से लगाने के लिए, इस अरे के एलिमेंट को
DownloadItem
प्रॉपर्टी पर सेट करें. उदाहरण के लिए,orderBy=['startTime']
को सेट करने पर,DownloadItem
को शुरू होने के समय के हिसाब से बढ़ते क्रम में लगाया जाता है. घटते क्रम में लगाने के लिए, हाइफ़न के साथ प्रीफ़िक्स लगाएं: '-startTime'. -
रोका गया
बूलियन ज़रूरी नहीं
अगर डाउनलोड ने होस्ट का डेटा पढ़ना बंद कर दिया है, लेकिन कनेक्शन खुला रखा है, तो 'सही' होगा.
-
क्वेरी
स्ट्रिंग[] ज़रूरी नहीं
खोज के लिए इस्तेमाल हुए शब्दों का यह कलेक्शन
DownloadItem
तक सीमित है, जिसकेfilename
याurl
याfinalUrl
में वे सभी खोज शब्द हैं जो डैश '-' से शुरू नहीं होते और डैश से शुरू होने वाला कोई भी खोज शब्द नहीं है. -
startTime
स्ट्रिंग ज़रूरी नहीं
ISO 8601 फ़ॉर्मैट में, डाउनलोड शुरू होने का समय.
-
startedAfter
स्ट्रिंग ज़रूरी नहीं
ISO 8601 फ़ॉर्मैट में दिए गए मि॰से॰ के बाद शुरू होने वाले
DownloadItem
नतीजों को सीमित करता है. -
startedBefore
स्ट्रिंग ज़रूरी नहीं
ISO 8601 फ़ॉर्मैट में दिए गए MS से पहले शुरू होने वाले
DownloadItem
तक के नतीजों को सीमित करता है. -
राज्य
राज्य ज़रूरी नहीं
यह बताता है कि डाउनलोड जारी है, उसमें रुकावट आ रही है या पूरा हो गया है.
-
totalBytes
नंबर वैकल्पिक
फ़ाइल कंप्रेस किए बिना, पूरी फ़ाइल में बाइट की संख्या या अगर जानकारी नहीं है, तो -1.
-
totalBytesGreater
नंबर वैकल्पिक
इससे नतीजे, ऐसे
DownloadItem
तक सीमित होते हैं जिसकाtotalBytes
, दिए गए पूर्णांक से बड़ा है. -
totalBytesLess
नंबर वैकल्पिक
इससे नतीजे, ऐसे
DownloadItem
तक सीमित हो जाते हैं जिनकाtotalBytes
, दिए गए पूर्णांक से कम है. -
url
स्ट्रिंग ज़रूरी नहीं
वह संपूर्ण यूआरएल जिससे डाउनलोड किया गया है, यानी किसी दूसरे वेबलिंक पर भेजने से पहले.
-
urlRegex
स्ट्रिंग ज़रूरी नहीं
नतीजों को सिर्फ़
DownloadItem
तक सीमित करता है, जिसकाurl
दिए गए रेगुलर एक्सप्रेशन से मेल खाता है.
FilenameConflictAction
Uniquiify
डुप्लीकेट कॉपी से बचने के लिए, filename
को बदल दिया जाता है, ताकि फ़ाइल नाम के एक्सटेंशन से पहले काउंटर शामिल किया जा सके.
ओवरराइट करें
मौजूदा फ़ाइल को नई फ़ाइल से बदल दिया जाएगा.
मैसेज
उपयोगकर्ता को फ़ाइल चुनने के लिए डायलॉग बॉक्स भेजा जाएगा.
Enum
FilenameSuggestion
प्रॉपर्टी
-
conflictAction
FilenameConflictAction ज़रूरी नहीं
filename
के मौजूद होने पर की जाने वाली कार्रवाई. -
फ़ाइल का नाम
स्ट्रिंग
DownloadItem
का नया टारगेटDownloadItem.filename
, उपयोगकर्ता की डिफ़ॉल्ट डाउनलोड डायरेक्ट्री के पाथ के तौर पर. इस डायरेक्ट्री में सबडायरेक्ट्री हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और पाथ में बैक-रेफ़रंस ".." अनदेखा कर दिया जाएगा. अगर किसी भी एक्सटेंशन के ज़रिएonDeterminingFilename
लिसनर रजिस्टर हैं, तोfilename
को अनदेखा कर दिया जाता है.
GetFileIconOptions
प्रॉपर्टी
-
साइज़
नंबर वैकल्पिक
दिखाए गए आइकॉन का साइज़. आइकॉन, स्क्वेयर होगा, जिसका डाइमेंशन साइज़ * साइज़ पिक्सल होगा. आइकॉन का डिफ़ॉल्ट और सबसे बड़ा साइज़ 32x32 पिक्सल है. सिर्फ़ 16 और 32 साइज़ ही इस्तेमाल किए जा सकते हैं. कोई दूसरा साइज़ बताने में गड़बड़ी हुई है.
HeaderNameValuePair
प्रॉपर्टी
-
नाम
स्ट्रिंग
एचटीटीपी हेडर का नाम.
-
value
स्ट्रिंग
एचटीटीपी हेडर की वैल्यू.
HttpMethod
Enum
InterruptReason
Enum
State
in_progress
डाउनलोड को अभी सर्वर से डेटा मिल रहा है.
बाधित
किसी गड़बड़ी ने फ़ाइल होस्ट से कनेक्शन टूट गया.
पूरा हो गया
डाउनलोड हो गया.
Enum
StringDelta
प्रॉपर्टी
-
जो मौजूदा
स्ट्रिंग ज़रूरी नहीं
-
पीछे जाएं
स्ट्रिंग ज़रूरी नहीं
UiOptions
प्रॉपर्टी
-
चालू किया गया
बूलियन
डाउनलोड यूज़र इंटरफ़ेस (यूआई) को चालू या बंद करें.
तरीके
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
और इससे जुड़ी जानकारी अपने-आप भर जाएगी. अगर डाउनलोड सही तरीके से शुरू हो गया है, तो नए DownloadItem
के downloadId
के साथ callback
को कॉल किया जाएगा. अगर डाउनलोड शुरू करने में कोई गड़बड़ी हुई हो, तो callback
को downloadId=undefined
के साथ कॉल किया जाएगा और runtime.lastError
में जानकारी देने वाली स्ट्रिंग होगी. इस बात की कोई गारंटी नहीं है कि गड़बड़ी वाली स्ट्रिंग, रिलीज़ के बीच पुराने सिस्टम के साथ काम करती रहेंगी. एक्सटेंशन को इसे पार्स नहीं करना चाहिए.
पैरामीटर
-
विकल्प
क्या डाउनलोड करना है और कैसे करना है.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(downloadId: number) => void
-
downloadId
संख्या
-
रिटर्न
-
Promise<number>
Chrome 96 या इसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
erase()
chrome.downloads.erase(
query: DownloadQuery,
callback?: function,
)
डाउनलोड की गई फ़ाइल मिटाए बिना, मिलान करने वाले DownloadItem
को इतिहास से हमेशा के लिए मिटाएं. query
से मैच करने वाले हर DownloadItem
इवेंट के लिए, एक onErased
इवेंट ट्रिगर होगा. इसके बाद, callback
को कॉल किया जाएगा.
पैरामीटर
-
क्वेरी
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(erasedIds: number[]) => void
-
erasedIds
नंबर[]
-
रिटर्न
-
Promise<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 | तय नहीं है>
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
पर सेट करें.
पैरामीटर
-
क्वेरी
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(results: DownloadItem[]) => void
-
नतीजे
-
रिटर्न
-
Promise<DownloadItem[]>
Chrome 96 या इसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
setShelfEnabled()
chrome.downloads.setShelfEnabled(
enabled: boolean,
)
इसके बजाय, setUiOptions
का इस्तेमाल करें.
मौजूदा ब्राउज़र प्रोफ़ाइल से जुड़ी हर विंडो के नीचे मौजूद स्लेटी शेल्फ़ को चालू या बंद करें. शेल्फ़ तब तक बंद रहेगा, जब तक कम से कम एक एक्सटेंशन उसे बंद नहीं कर देता. अगर कम से कम एक और एक्सटेंशन के बंद होने पर शेल्फ़ को चालू किया जाता है, तो runtime.lastError
के ज़रिए आपको गड़बड़ी का मैसेज दिखेगा. "downloads"
अनुमति के साथ-साथ, "downloads.shelf"
अनुमति की ज़रूरत है.
पैरामीटर
-
चालू किया गया
बूलियन
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
और एक ऑब्जेक्ट के साथ फ़ायर हो जाता है. इस ऑब्जेक्ट में, ऐसी प्रॉपर्टी शामिल होती हैं जिनमें बदलाव हुआ है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(downloadDelta: DownloadDelta) => void
-
downloadDelta
-
onCreated
chrome.downloads.onCreated.addListener(
callback: function,
)
डाउनलोड शुरू होने पर, यह इवेंट DownloadItem
ऑब्जेक्ट के साथ फ़ायर होता है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(downloadItem: DownloadItem) => void
-
downloadItem
-
onDeterminingFilename
chrome.downloads.onDeterminingFilename.addListener(
callback: function,
)
फ़ाइल का नाम तय करने की प्रोसेस के दौरान, एक्सटेंशन को टारगेट DownloadItem.filename
को बदलने का मौका दिया जाएगा. हर एक्सटेंशन इस इवेंट के लिए एक से ज़्यादा लिसनर रजिस्टर नहीं कर सकता. हर लिसनर को suggest
को सिर्फ़ एक बार, सिंक्रोनस या एसिंक्रोनस तरीके से कॉल करना चाहिए. अगर सुनने वाला व्यक्ति suggest
को एसिंक्रोनस तरीके से कॉल करता है, तो उसे true
देना होगा. अगर लिसनर न तो suggest
को सिंक करके कॉल करता है और न ही true
का जवाब देता है, तो suggest
अपने-आप कॉल हो जाएगा. DownloadItem
तब तक पूरा नहीं होगा, जब तक सभी श्रोता suggest
पर कॉल नहीं कर लेते. उपयोगकर्ता, suggest
को बिना किसी आर्ग्युमेंट के कॉल कर सकते हैं, ताकि डाउनलोड अपने फ़ाइल नाम के लिए downloadItem.filename
का इस्तेमाल कर सके. इसके अलावा, टारगेट फ़ाइल नाम को बदलने के लिए, suggest
को suggestion
ऑब्जेक्ट पास किया जा सकता है. अगर एक से ज़्यादा एक्सटेंशन फ़ाइल नाम को बदल देते हैं, तो आखिरी बार इंस्टॉल किया गया एक्सटेंशन जिसका लिसनर, suggest
को suggestion
ऑब्जेक्ट पास करता है उसे जीतता है. कौनसा एक्सटेंशन काम करेगा, इस बारे में भ्रम की स्थिति से बचने के लिए, उपयोगकर्ताओं को ऐसे एक्सटेंशन इंस्टॉल नहीं करने चाहिए जिनके बीच टकराव हो सकता है. अगर download
से डाउनलोड शुरू किया जाता है और टारगेट फ़ाइल का नाम, MIME टाइप और संभावित फ़ाइल नाम तय होने से पहले ही पता चल जाता है, तो इसके बजाय filename
को download
पर पास करें.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(downloadItem: DownloadItem, suggest: function) => void
-
downloadItem
-
सुझाव दो
फ़ंक्शन
suggest
पैरामीटर ऐसा दिखता है:(suggestion?: FilenameSuggestion) => void
-
सुझाव
FilenameSuggestion ज़रूरी नहीं
-
-
onErased
chrome.downloads.onErased.addListener(
callback: function,
)
जब किसी डाउनलोड को इतिहास से मिटा दिया जाता है, तो downloadId
से सक्रिय होता है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(downloadId: number) => void
-
downloadId
संख्या
-