ब्यौरा
प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए डाउनलोड शुरू करने, उन पर नज़र रखने, उनमें बदलाव करने, और उन्हें खोजने के लिए, chrome.downloads API का इस्तेमाल करें.
अनुमतियां
downloadsइस एपीआई का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "downloads" अनुमति का एलान करना होगा.
{
"name": "My extension",
...
"permissions": [
"downloads"
],
}
उदाहरण
examples/api/downloads डायरेक्ट्री में, browser.downloads API के इस्तेमाल के आसान उदाहरण देखे जा सकते हैं. अन्य उदाहरणों और सोर्स कोड देखने में मदद पाने के लिए, सैंपल देखें.
टाइप
BooleanDelta
प्रॉपर्टी
-
जो मौजूदा
boolean ज़रूरी नहीं है
-
पीछे जाएं
boolean ज़रूरी नहीं है
DangerType
Enum
"file"
डाउनलोड की गई फ़ाइल का नाम संदिग्ध है.
"url"
डाउनलोड करने के लिए दिए गए यूआरएल के बारे में पता चला है कि यह नुकसान पहुंचाने वाला है.
"content"
डाउनलोड की गई फ़ाइल में नुकसान पहुंचाने वाला कॉन्टेंट मौजूद है.
"uncommon"
डाउनलोड किए जाने वाले यूआरएल को आम तौर पर डाउनलोड नहीं किया जाता है और यह खतरनाक हो सकता है.
"होस्ट"
यह डाउनलोड, नुकसान पहुंचाने वाले बाइनरी फ़ाइलें डिस्ट्रिब्यूट करने वाले होस्ट से आया है. इसलिए, यह खतरनाक हो सकता है.
"अनचाहा"
यह डाउनलोड संभावित रूप से अनचाहा या असुरक्षित है. उदाहरण के लिए, यह ब्राउज़र या कंप्यूटर की सेटिंग में बदलाव कर सकता है.
"सुरक्षित"
इस डाउनलोड से, उपयोगकर्ता के कंप्यूटर को कोई खतरा नहीं है.
"accepted"
उपयोगकर्ता ने खतरनाक डाउनलोड स्वीकार कर लिया है.
"allowlistedByPolicy"
Enterprise-related values.
"asyncScanning"
"asyncLocalPasswordScanning"
"passwordProtected"
"blockedTooLarge"
"sensitiveContentWarning"
"sensitiveContentBlock"
"deepScannedFailed"
"deepScannedSafe"
"deepScannedOpenedDangerous"
"promptForScanning"
"promptForLocalPasswordScanning"
"accountCompromise"
"blockedScanFailed"
"forceSaveToGdrive"
इसका इस्तेमाल Secure Enterprise Browser एक्सटेंशन करता है. ज़रूरत पड़ने पर, Chrome डिस्क में डाउनलोड करने की सुविधा को ब्लॉक कर देगा और फ़ाइल को सीधे Google Drive में डाउनलोड कर देगा.
"forceSaveToOnedrive"
इसका इस्तेमाल Secure Enterprise Browser एक्सटेंशन करता है. ज़रूरत पड़ने पर, Chrome डिस्क में डाउनलोड होने वाली फ़ाइल को ब्लॉक कर देगा और उसे सीधे OneDrive में डाउनलोड कर देगा.
DoubleDelta
प्रॉपर्टी
-
जो मौजूदा
number ज़रूरी नहीं
-
पीछे जाएं
number ज़रूरी नहीं
DownloadDelta
प्रॉपर्टी
-
canResume
BooleanDelta ज़रूरी नहीं है
अगर
canResumeमें कोई बदलाव हुआ है, तो उसकी जानकारी. -
खतरा
StringDelta ज़रूरी नहीं है
अगर
dangerमें कोई बदलाव हुआ है, तो उसकी जानकारी. -
endTime
StringDelta ज़रूरी नहीं है
अगर
endTimeमें कोई बदलाव हुआ है, तो उसकी जानकारी. -
गड़बड़ी
StringDelta ज़रूरी नहीं है
अगर
errorमें कोई बदलाव हुआ है, तो उसकी जानकारी. -
मौजूद है
BooleanDelta ज़रूरी नहीं है
अगर
existsमें कोई बदलाव हुआ है, तो उसकी जानकारी. -
fileSize
DoubleDelta ज़रूरी नहीं है
अगर
fileSizeमें कोई बदलाव हुआ है, तो उसकी जानकारी. -
filename
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
string ज़रूरी नहीं है
अगर इस डाउनलोड को किसी एक्सटेंशन ने शुरू किया है, तो इस डाउनलोड को शुरू करने वाले एक्सटेंशन का आइडेंटिफ़ायर. इसे सेट करने के बाद बदला नहीं जा सकता.
-
byExtensionName
string ज़रूरी नहीं है
अगर इस डाउनलोड को किसी एक्सटेंशन ने शुरू किया है, तो इस डाउनलोड को शुरू करने वाले एक्सटेंशन का स्थानीय नाम. एक्सटेंशन का नाम बदलने या उपयोगकर्ता के स्थान-भाषा बदलने पर, यह कुकी बदल सकती है.
-
bytesReceived
संख्या
होस्ट से अब तक मिले बाइट की संख्या. इसमें फ़ाइल कंप्रेस करने की सुविधा को शामिल नहीं किया गया है.
-
canResume
बूलियन
अगर डाउनलोड जारी है और उसे रोका गया है या अगर डाउनलोड में रुकावट आई है और उसे वहीं से फिर से शुरू किया जा सकता है जहां रुकावट आई थी, तो यह वैल्यू 'सही' होती है.
-
खतरा
इससे पता चलता है कि यह डाउनलोड सुरक्षित है या संदिग्ध है.
-
endTime
string ज़रूरी नहीं है
आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड खत्म होने का समय. इसे सीधे तौर पर Date कंस्ट्रक्टर को पास किया जा सकता है:
chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})}) -
गड़बड़ी
InterruptReason optional
डाउनलोड में रुकावट क्यों आई. कई तरह की एचटीटीपी गड़बड़ियों को
SERVER_से शुरू होने वाली किसी एक गड़बड़ी के तहत ग्रुप किया जा सकता है. नेटवर्क से जुड़ी गड़बड़ियांNETWORK_से शुरू होती हैं. फ़ाइल सिस्टम में फ़ाइल लिखने की प्रोसेस से जुड़ी गड़बड़ियांFILE_से शुरू होती हैं. साथ ही, उपयोगकर्ता की वजह से होने वाली रुकावटेंUSER_से शुरू होती हैं. -
estimatedEndTime
string ज़रूरी नहीं है
आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड पूरा होने का अनुमानित समय. इसे सीधे तौर पर Date कंस्ट्रक्टर को पास किया जा सकता है:
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.
-
filename
स्ट्रिंग
ऐब्सलूट लोकल पाथ.
-
finalUrl
स्ट्रिंग
Chrome 54 या इसके बाद का वर्शनयह वह संपूर्ण यूआरएल होता है जिससे यह डाउनलोड किया जा रहा है. इसमें सभी रीडायरेक्ट के बाद का यूआरएल शामिल होता है.
-
आईडी
संख्या
यह एक ऐसा आइडेंटिफ़ायर है जो ब्राउज़र के सभी सेशन में बना रहता है.
-
गुप्त
बूलियन
अगर इस डाउनलोड को इतिहास में रिकॉर्ड किया गया है, तो वैल्यू False होगी. अगर इसे रिकॉर्ड नहीं किया गया है, तो वैल्यू True होगी.
-
माइम
स्ट्रिंग
फ़ाइल का एमआईएमई टाइप.
-
रोका गया
बूलियन
अगर डाउनलोड ने होस्ट से डेटा पढ़ना बंद कर दिया है, लेकिन कनेक्शन खुला रखा है, तो यह वैल्यू सही होती है.
-
रेफ़रल देने वाला
स्ट्रिंग
संपूर्ण यूआरएल.
-
startTime
स्ट्रिंग
आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड शुरू होने का समय. इसे सीधे तौर पर Date कंस्ट्रक्टर को पास किया जा सकता है:
chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})}) -
राज्य
इससे पता चलता है कि डाउनलोड की प्रोसेस चल रही है, रुक गई है या पूरी हो गई है.
-
totalBytes
संख्या
पूरी फ़ाइल में बाइट की संख्या. इसमें फ़ाइल कंप्रेस करने की सुविधा को शामिल नहीं किया जाता. अगर यह जानकारी उपलब्ध नहीं है, तो वैल्यू -1 होती है.
-
url
स्ट्रिंग
यह वह संपूर्ण यूआरएल है जिससे यह डाउनलोड शुरू हुआ था. इसमें किसी भी तरह का रीडायरेक्ट शामिल नहीं है.
DownloadOptions
प्रॉपर्टी
-
body
string ज़रूरी नहीं है
पोस्ट का मुख्य हिस्सा.
-
conflictAction
FilenameConflictAction ज़रूरी नहीं है
अगर
filenameपहले से मौजूद है, तो की जाने वाली कार्रवाई. -
filename
string ज़रूरी नहीं है
डाउनलोड की गई फ़ाइल को सेव करने के लिए, Downloads डायरेक्ट्री के हिसाब से फ़ाइल पाथ. इसमें सबडायरेक्ट्री भी शामिल हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और ".." वाले बैक-रेफ़रंस वाले पाथ से गड़बड़ी होगी.
onDeterminingFilenameकी मदद से, फ़ाइल का एमआईएमई टाइप और फ़ाइल का संभावित नाम तय होने के बाद, फ़ाइल का नाम सुझाया जा सकता है. -
हेडर
HeaderNameValuePair[] optional
अगर यूआरएल, एचटीटीपी[s] प्रोटोकॉल का इस्तेमाल करता है, तो अनुरोध के साथ भेजे जाने वाले अतिरिक्त एचटीटीपी हेडर. हर हेडर को एक डिक्शनरी के तौर पर दिखाया जाता है. इसमें
nameऔरvalueयाbinaryValueकुंजियां होती हैं. ये कुंजियां, XMLHttpRequest के लिए मान्य होनी चाहिए. -
तरीका
HttpMethod ज़रूरी नहीं है
अगर यूआरएल में एचटीटीपी[एस] प्रोटोकॉल का इस्तेमाल किया जाता है, तो एचटीटीपी के इस तरीके का इस्तेमाल करें.
-
saveAs
boolean ज़रूरी नहीं है
फ़ाइल चुनने वाले टूल का इस्तेमाल करें, ताकि उपयोगकर्ता फ़ाइल का नाम चुन सके. इससे कोई फ़र्क़ नहीं पड़ता कि
filenameसेट है या पहले से मौजूद है. -
url
स्ट्रिंग
डाउनलोड करने के लिए यूआरएल.
DownloadQuery
प्रॉपर्टी
-
bytesReceived
number ज़रूरी नहीं
होस्ट से अब तक मिले बाइट की संख्या. इसमें फ़ाइल कंप्रेस करने की सुविधा को शामिल नहीं किया गया है.
-
खतरा
DangerType ज़रूरी नहीं है
इससे पता चलता है कि यह डाउनलोड सुरक्षित है या संदिग्ध है.
-
endTime
string ज़रूरी नहीं है
आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड खत्म होने का समय.
-
endedAfter
string ज़रूरी नहीं है
नतीजों को
DownloadItemतक सीमित करता है. यह , आईएसओ 8601 फ़ॉर्मैट में दिए गए मिलीसेकंड के बाद खत्म हुआ था -
endedBefore
string ज़रूरी नहीं है
नतीजों को उन
DownloadItemतक सीमित करता है जो आईएसओ 8601 फ़ॉर्मैट में दिए गए मिलीसेकंड से पहले खत्म हो गए थे. -
गड़बड़ी
InterruptReason optional
डाउनलोड की प्रोसेस क्यों रुक गई.
-
मौजूद है
boolean ज़रूरी नहीं है
डाउनलोड की गई फ़ाइल मौजूद है या नहीं;
-
fileSize
number ज़रूरी नहीं
डिकंप्रेशन के बाद पूरी फ़ाइल में बाइट की संख्या या अगर यह जानकारी उपलब्ध नहीं है, तो -1.
-
filename
string ज़रूरी नहीं है
ऐब्सलूट लोकल पाथ.
-
filenameRegex
string ज़रूरी नहीं है
नतीजों को
DownloadItemतक सीमित करता है. इनमें से सिर्फ़ वे नतीजे शामिल होते हैं जिनकीfilename, दिए गए रेगुलर एक्सप्रेशन से मेल खाती है. -
finalUrl
string ज़रूरी नहीं है
Chrome 54 या इसके बाद का वर्शनयह वह संपूर्ण यूआरएल होता है जिससे यह डाउनलोड किया जा रहा है. इसमें सभी रीडायरेक्ट के बाद का यूआरएल शामिल होता है.
-
finalUrlRegex
string ज़रूरी नहीं है
Chrome 54 या इसके बाद का वर्शननतीजों को
DownloadItemतक सीमित करता है. इनमें से सिर्फ़ वे नतीजे शामिल होते हैं जिनकीfinalUrl, दिए गए रेगुलर एक्सप्रेशन से मेल खाती है. -
आईडी
number ज़रूरी नहीं
क्वेरी करने के लिए
DownloadItemकाid. -
सीमा
number ज़रूरी नहीं
मिलते-जुलते
DownloadItemकी ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट वैल्यू 1,000 होती है. मेल खाने वाले सभीDownloadItemवापस पाने के लिए, इसे 0 पर सेट करें. नतीजों को पेज के हिसाब से देखने का तरीका जानने के लिए,searchदेखें. -
माइम
string ज़रूरी नहीं है
फ़ाइल का एमआईएमई टाइप.
-
orderBy
string[] ज़रूरी नहीं है
खोज के नतीजों को क्रम से लगाने के लिए, इस ऐरे के एलिमेंट को
DownloadItemप्रॉपर्टी पर सेट करें. उदाहरण के लिए,orderBy=['startTime']को सेट करने पर,DownloadItemको उनके शुरू होने के समय के हिसाब से बढ़ते क्रम में लगाया जाता है. घटते क्रम के लिए, हाइफ़न का इस्तेमाल करें: '-startTime'. -
रोका गया
boolean ज़रूरी नहीं है
अगर डाउनलोड ने होस्ट से डेटा पढ़ना बंद कर दिया है, लेकिन कनेक्शन खुला रखा है, तो यह वैल्यू सही होती है.
-
क्वेरी
string[] ज़रूरी नहीं है
खोज के लिए इस्तेमाल हुए शब्दों के इस कलेक्शन से, नतीजे सिर्फ़
DownloadItemतक सीमित हो जाते हैं. इनमें ऐसे नतीजे शामिल होते हैं जिनकेfilenameयाurlयाfinalUrlमें, डैश '-' से शुरू न होने वाले खोज के लिए इस्तेमाल हुए सभी शब्द शामिल होते हैं. साथ ही, डैश से शुरू होने वाले खोज के लिए इस्तेमाल हुए कोई भी शब्द शामिल नहीं होते. -
startTime
string ज़रूरी नहीं है
आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड शुरू होने का समय.
-
startedAfter
string ज़रूरी नहीं है
नतीजों को
DownloadItemतक सीमित करता है. ये नतीजे, आईएसओ 8601 फ़ॉर्मैट में दिए गए मिलीसेकंड के बाद शुरू हुए थे. -
startedBefore
string ज़रूरी नहीं है
नतीजों को
DownloadItemतक सीमित करता है. यह , ISO 8601 फ़ॉर्मैट में दिए गए एमएस से पहले शुरू हुआ था. -
राज्य
State ज़रूरी नहीं
इससे पता चलता है कि डाउनलोड की प्रोसेस चल रही है, रुक गई है या पूरी हो गई है.
-
totalBytes
number ज़रूरी नहीं
पूरी फ़ाइल में बाइट की संख्या. इसमें फ़ाइल कंप्रेस करने की सुविधा को शामिल नहीं किया जाता. अगर यह जानकारी उपलब्ध नहीं है, तो वैल्यू -1 होती है.
-
totalBytesGreater
number ज़रूरी नहीं
नतीजों को
DownloadItemतक सीमित करता है. इसमेंtotalBytesकी वैल्यू, दिए गए पूर्णांक से ज़्यादा होती है. -
totalBytesLess
number ज़रूरी नहीं
नतीजों को उन
DownloadItemतक सीमित करता है जिनकाtotalBytes, दिए गए पूर्णांक से कम है. -
url
string ज़रूरी नहीं है
यह वह संपूर्ण यूआरएल है जिससे यह डाउनलोड शुरू हुआ था. इसमें किसी भी तरह का रीडायरेक्ट शामिल नहीं है.
-
urlRegex
string ज़रूरी नहीं है
नतीजों को
DownloadItemतक सीमित करता है. इनमें से सिर्फ़ वे नतीजे शामिल होते हैं जिनकीurl, दिए गए रेगुलर एक्सप्रेशन से मेल खाती है.
FilenameConflictAction
uniquify
डुप्लीकेट होने से बचाने के लिए, filename को बदल दिया जाता है. इसमें फ़ाइल नाम के एक्सटेंशन से पहले काउंटर शामिल होता है.
ओवरराइट करें
मौजूदा फ़ाइल को नई फ़ाइल से बदल दिया जाएगा.
प्रॉम्प्ट
उपयोगकर्ता को फ़ाइल चुनने का डायलॉग दिखेगा.
Enum
"uniquify"
"overwrite"
"prompt"
FilenameSuggestion
प्रॉपर्टी
-
conflictAction
FilenameConflictAction ज़रूरी नहीं है
अगर
filenameपहले से मौजूद है, तो की जाने वाली कार्रवाई. -
filename
स्ट्रिंग
DownloadItemका नया टारगेटDownloadItem.filename, उपयोगकर्ता की डिफ़ॉल्ट डाउनलोड डायरेक्ट्री के हिसाब से पाथ के तौर पर होता है. इसमें सबडायरेक्ट्री भी हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और बैक-रेफ़रंस ".." वाले पाथ को अनदेखा कर दिया जाएगा. अगर किसी एक्सटेंशन नेonDeterminingFilenameलिसनर रजिस्टर किए हैं, तोfilenameको अनदेखा कर दिया जाता है.
GetFileIconOptions
प्रॉपर्टी
-
साइज़
number ज़रूरी नहीं
डेंसिटी-इंडिपेंडेंट पिक्सल (डीआईपी) में, दिखाए गए आइकॉन का साइज़. यह 16 या 32 होना चाहिए (डिफ़ॉल्ट रूप से 32 पर सेट होता है). हाई-डीपीआई डिसप्ले पर, दिखाई गई इमेज को डिवाइस के स्केल फ़ैक्टर के हिसाब से स्केल किया जाता है. उदाहरण के लिए, 2x डिसप्ले पर 32 साइज़ के लिए 64x64 पिक्सल. बैकग्राउंड में चलने वाली सेवा वर्कर से किए गए कॉल, डिफ़ॉल्ट रूप से 1x स्केल पर होते हैं.
HeaderNameValuePair
प्रॉपर्टी
-
नाम
स्ट्रिंग
एचटीटीपी हेडर का नाम.
-
मान
स्ट्रिंग
एचटीटीपी हेडर की वैल्यू.
HttpMethod
Enum
"GET"
"POST"
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"
"CRASH"
State
in_progress
फ़िलहाल, डाउनलोड को सर्वर से डेटा मिल रहा है.
रुकावट आई
कोई गड़बड़ी होने की वजह से, फ़ाइल होस्ट से कनेक्शन टूट गया है.
पूरा हो गया
डाउनलोड हो गया.
Enum
"in_progress"
"interrupted"
"complete"
StringDelta
प्रॉपर्टी
-
जो मौजूदा
string ज़रूरी नहीं है
-
पीछे जाएं
string ज़रूरी नहीं है
UiOptions
प्रॉपर्टी
-
चालू किया गया
बूलियन
डाउनलोड यूज़र इंटरफ़ेस (यूआई) को चालू या बंद करें.
तरीके
acceptDanger()
chrome.downloads.acceptDanger(
downloadId: number,
): Promise<void>
उपयोगकर्ता को नुकसान पहुंचाने वाले डाउनलोड को स्वीकार करने के लिए कहा जाता है. इसे सिर्फ़ ऐसे कॉन्टेक्स्ट से कॉल किया जा सकता है जो दिखता हो. जैसे, टैब, विंडो या पेज/ब्राउज़र ऐक्शन पॉप-अप. यह मोड, खतरनाक डाउनलोड को अपने-आप स्वीकार नहीं करता. अगर डाउनलोड स्वीकार कर लिया जाता है, तो onChanged इवेंट ट्रिगर होगा. ऐसा न होने पर, कुछ नहीं होगा. जब सारा डेटा किसी अस्थायी फ़ाइल में फ़ेच हो जाता है और डाउनलोड खतरनाक नहीं होता या खतरे को स्वीकार कर लिया जाता है, तो अस्थायी फ़ाइल का नाम बदलकर टारगेट फ़ाइल का नाम कर दिया जाता है. साथ ही, state की स्थिति बदलकर 'complete' हो जाती है और onChanged ट्रिगर हो जाता है.
पैरामीटर
-
downloadId
संख्या
DownloadItemके लिए आइडेंटिफ़ायर.
रिटर्न
-
Promise<void>
Chrome 96 और इसके बाद के वर्शनयह एक प्रॉमिस दिखाता है. जब खतरे की चेतावनी वाला डायलॉग बॉक्स बंद हो जाता है, तब यह प्रॉमिस रिज़ॉल्व हो जाता है.
cancel()
chrome.downloads.cancel(
downloadId: number,
): Promise<void>
डाउनलोड रद्द करना. callback चलाने पर, डाउनलोड रद्द हो जाता है, पूरा हो जाता है, रुक जाता है या अब मौजूद नहीं रहता.
पैरामीटर
-
downloadId
संख्या
डाउनलोड रद्द करने का आईडी.
रिटर्न
-
Promise<void>
Chrome 96 और इसके बाद के वर्शनयह एक प्रॉमिस दिखाता है. सदस्यता रद्द करने का अनुरोध पूरा होने पर, यह प्रॉमिस रिज़ॉल्व हो जाता है.
download()
chrome.downloads.download(
options: DownloadOptions,
): Promise<number>
किसी यूआरएल को डाउनलोड करें. अगर यूआरएल में एचटीटीपी[एस] प्रोटोकॉल का इस्तेमाल किया जाता है, तो अनुरोध में उसके होस्टनेम के लिए सेट की गई सभी कुकी शामिल होंगी. अगर filename और saveAs, दोनों तय किए गए हैं, तो 'इस नाम से सेव करें' डायलॉग दिखेगा. इसमें filename की तय की गई वैल्यू पहले से भरी होगी. अगर डाउनलोड शुरू हो जाता है, तो callback को नए DownloadItem के downloadId के साथ कॉल किया जाएगा. अगर डाउनलोड शुरू करने में कोई गड़बड़ी हुई है, तो callback को downloadId=undefined के साथ कॉल किया जाएगा. साथ ही, runtime.lastError में जानकारी देने वाली स्ट्रिंग शामिल होगी. यह ज़रूरी नहीं है कि रिलीज़ के बीच, गड़बड़ी वाली स्ट्रिंग पुराने सिस्टम के साथ काम करती रहें. एक्सटेंशन को इसे पार्स नहीं करना चाहिए.
पैरामीटर
-
विकल्प
क्या और कैसे डाउनलोड करें.
रिटर्न
-
Promise<number>
Chrome 96 और इसके बाद के वर्शनयह एक प्रॉमिस दिखाता है. यह प्रॉमिस, नए
DownloadItemके आईडी के साथ रिज़ॉल्व होता है.
erase()
chrome.downloads.erase(
query: DownloadQuery,
): Promise<number[]>
डाउनलोड की गई फ़ाइल को मिटाए बिना, इतिहास से मिलती-जुलती DownloadItem मिटाएं. query से मेल खाने वाले हर DownloadItem के लिए, onErased इवेंट ट्रिगर होगा. इसके बाद, callback को कॉल किया जाएगा.
पैरामीटर
-
क्वेरी
रिटर्न
-
Promise<number[]>
Chrome 96 और इसके बाद के वर्शन
getFileIcon()
chrome.downloads.getFileIcon(
downloadId: number,
options?: GetFileIconOptions,
): Promise<string | undefined>
डाउनलोड किए गए किसी आइटम के लिए आइकॉन वापस पाएं. नए डाउनलोड के लिए, फ़ाइल के आइकॉन तब उपलब्ध होते हैं, जब डाउनलोड की गई फ़ाइल का नाम तय हो जाता है. उदाहरण के लिए, जब onChanged, filename में हुए बदलाव के साथ ट्रिगर होता है. फ़ाइल का नाम तय होने से पहले आइकॉन को वापस पाने की कोशिश करने पर, runtime.lastError के ज़रिए गड़बड़ी का मैसेज दिखेगा. डाउनलोड के दौरान, इस फ़ंक्शन से मिली इमेज, डाउनलोड पूरा होने के बाद मिली इमेज से अलग हो सकती है. प्लैटफ़ॉर्म के आधार पर, आइकॉन को वापस पाने के लिए, ऑपरेटिंग सिस्टम या टूलकिट से क्वेरी की जाती है. इसलिए, दिखाया गया आइकॉन कई बातों पर निर्भर करेगा. जैसे, डाउनलोड की स्थिति, प्लैटफ़ॉर्म, रजिस्टर किए गए फ़ाइल टाइप, और विज़ुअल थीम. अगर फ़ाइल के आइकॉन का पता नहीं लगाया जा सकता, तो runtime.lastError में गड़बड़ी का मैसेज दिखेगा.
पैरामीटर
-
downloadId
संख्या
डाउनलोड के लिए आइडेंटिफ़ायर.
-
विकल्प
GetFileIconOptions ज़रूरी नहीं है
रिटर्न
-
Promise<string | undefined>
Chrome 96 और इसके बाद के वर्शनयह एक प्रॉमिस दिखाता है. यह प्रॉमिस, डाउनलोड को दिखाने वाली इमेज के यूआरएल के साथ रिज़ॉल्व होता है.
open()
chrome.downloads.open(
downloadId: number,
): Promise<void>
अगर DownloadItem पूरा हो गया है, तो डाउनलोड की गई फ़ाइल को अभी खोलता है. ऐसा न होने पर, runtime.lastError के ज़रिए गड़बड़ी दिखाता है. इस तरीके के लिए, "downloads" अनुमति के साथ-साथ "downloads.open" अनुमति भी ज़रूरी है. आइटम को पहली बार खोलने पर, onChanged इवेंट ट्रिगर होता है. इस तरीके को सिर्फ़ उपयोगकर्ता के जेस्चर के जवाब में कॉल किया जा सकता है.
पैरामीटर
-
downloadId
संख्या
डाउनलोड की गई फ़ाइल के लिए आइडेंटिफ़ायर.
रिटर्न
-
Promise<void>
Chrome 123 या इसके बाद के वर्शन
pause()
chrome.downloads.pause(
downloadId: number,
): Promise<void>
डाउनलोड रोकें. अगर अनुरोध पूरा हो गया है, तो डाउनलोड रुक जाएगा. अगर ऐसा नहीं है, तो runtime.lastError में गड़बड़ी का मैसेज होता है. अगर डाउनलोड चालू नहीं है, तो अनुरोध पूरा नहीं किया जा सकेगा.
पैरामीटर
-
downloadId
संख्या
डाउनलोड को रोकने के लिए आईडी.
रिटर्न
-
Promise<void>
Chrome 96 और इसके बाद के वर्शनयह एक प्रॉमिस दिखाता है. जब वीडियो रोकने का अनुरोध पूरा हो जाता है, तब यह प्रॉमिस रिज़ॉल्व हो जाता है.
removeFile()
chrome.downloads.removeFile(
downloadId: number,
): Promise<void>
अगर डाउनलोड की गई फ़ाइल मौजूद है और DownloadItem पूरा हो गया है, तो उसे हटा दें. ऐसा न होने पर, runtime.lastError के ज़रिए गड़बड़ी की जानकारी दें.
पैरामीटर
-
downloadId
संख्या
रिटर्न
-
Promise<void>
Chrome 96 और इसके बाद के वर्शन
resume()
chrome.downloads.resume(
downloadId: number,
): Promise<void>
रोके गए डाउनलोड को फिर से शुरू करें. अगर अनुरोध पूरा हो गया है, तो डाउनलोड जारी रहेगा और उसे रोका नहीं जाएगा. अगर ऐसा नहीं है, तो runtime.lastError में गड़बड़ी का मैसेज होता है. अगर डाउनलोड चालू नहीं है, तो अनुरोध पूरा नहीं किया जा सकेगा.
पैरामीटर
-
downloadId
संख्या
उस डाउनलोड का आईडी जिसे फिर से शुरू करना है.
रिटर्न
-
Promise<void>
Chrome 96 और इसके बाद के वर्शनयह एक प्रॉमिस दिखाता है. जब फिर से शुरू करने का अनुरोध पूरा हो जाता है, तब यह प्रॉमिस रिज़ॉल्व हो जाता है.
search()
chrome.downloads.search(
query: DownloadQuery,
): Promise<DownloadItem[]>
DownloadItem खोजें. सभी DownloadItem पाने के लिए, query को खाली ऑब्जेक्ट पर सेट करें. किसी खास DownloadItem के लिए, सिर्फ़ id फ़ील्ड सेट करें. ज़्यादा आइटमों को पेज पर दिखाने के लिए, orderBy: ['-startTime'] को सेट करें. साथ ही, limit को हर पेज पर आइटमों की संख्या पर सेट करें. इसके अलावा, startedAfter को पिछले पेज के आखिरी आइटम के startTime पर सेट करें.
पैरामीटर
-
क्वेरी
रिटर्न
-
Promise<DownloadItem[]>
Chrome 96 और इसके बाद के वर्शन
setShelfEnabled()
chrome.downloads.setShelfEnabled(
enabled: boolean,
): void
इसके बजाय, setUiOptions का इस्तेमाल करें.
इससे, मौजूदा ब्राउज़र प्रोफ़ाइल से जुड़ी हर विंडो में सबसे नीचे मौजूद ग्रे शेल्फ़ को चालू या बंद किया जा सकता है. जब तक कम से कम एक एक्सटेंशन ने इसे बंद किया है, तब तक शेल्फ़ बंद रहेगी. अगर कम से कम एक अन्य एक्सटेंशन ने शेल्फ़ को बंद कर दिया है, तो उसे चालू करने पर runtime.lastError के ज़रिए गड़बड़ी का मैसेज दिखेगा. इसके लिए, "downloads" अनुमति के साथ-साथ "downloads.shelf" अनुमति भी ज़रूरी है.
पैरामीटर
-
चालू किया गया
बूलियन
setUiOptions()
chrome.downloads.setUiOptions(
options: UiOptions,
): Promise<void>
मौजूदा ब्राउज़र प्रोफ़ाइल से जुड़ी हर विंडो के डाउनलोड यूज़र इंटरफ़ेस (यूआई) को बदलता है. जब तक कम से कम एक एक्सटेंशन के लिए UiOptions.enabled की वैल्यू false पर सेट है, तब तक डाउनलोड यूज़र इंटरफ़ेस (यूआई) छिपा रहेगा. अगर कम से कम एक अन्य एक्सटेंशन ने इसे बंद कर दिया है, तो UiOptions.enabled को true पर सेट करने से, runtime.lastError के ज़रिए गड़बड़ी का मैसेज दिखेगा. इसके लिए, "downloads" अनुमति के साथ-साथ "downloads.ui" अनुमति भी ज़रूरी है.
पैरामीटर
-
विकल्प
डाउनलोड यूज़र इंटरफ़ेस (यूआई) में हुए बदलाव को शामिल करता है.
रिटर्न
-
Promise<void>
यह एक प्रॉमिस दिखाता है. यूज़र इंटरफ़ेस (यूआई) अपडेट होने के बाद, यह प्रॉमिस रिज़ॉल्व हो जाता है.
show()
chrome.downloads.show(
downloadId: number,
): void
डाउनलोड की गई फ़ाइल को फ़ाइल मैनेजर में उसके फ़ोल्डर में दिखाओ.
पैरामीटर
-
downloadId
संख्या
डाउनलोड की गई फ़ाइल के लिए आइडेंटिफ़ायर.
showDefaultFolder()
chrome.downloads.showDefaultFolder(): void
फ़ाइल मैनेजर में, डिफ़ॉल्ट डाउनलोड फ़ोल्डर दिखाओ.
इवेंट
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 को अपने-आप कॉल किया जाएगा. सभी लिसनर के suggest को कॉल करने तक, DownloadItem पूरा नहीं होगा. फ़ाइल का downloadItem.filename नाम तय करने के लिए, डाउनलोड करने की अनुमति देने वाला suggest बिना किसी तर्क के कॉल किया जा सकता है. इसके अलावा, टारगेट फ़ाइल के नाम को बदलने के लिए, suggest को suggestion ऑब्जेक्ट पास किया जा सकता है. अगर एक से ज़्यादा एक्सटेंशन, फ़ाइल के नाम को बदल देते हैं, तो उस एक्सटेंशन को प्राथमिकता दी जाएगी जिसे सबसे आखिर में इंस्टॉल किया गया है और जिसका लिसनर, suggestion ऑब्जेक्ट को suggest में पास करता है. उपयोगकर्ताओं को ऐसे एक्सटेंशन इंस्टॉल नहीं करने चाहिए जो एक-दूसरे के साथ काम नहीं करते. इससे यह तय करने में आसानी होगी कि कौनसे एक्सटेंशन का इस्तेमाल किया जाएगा. अगर डाउनलोड की प्रोसेस download शुरू करता है और एमआईएमई टाइप और फ़ाइल के संभावित नाम का पता चलने से पहले ही टारगेट फ़ाइल का नाम पता चल जाता है, तो 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
संख्या
-