chrome.downloads

ब्यौरा

प्रोग्राम के हिसाब से, डाउनलोड शुरू करने, उनकी निगरानी करने, उनमें बदलाव करने, और उन्हें खोजने के लिए, chrome.downloads API का इस्तेमाल करें.

अनुमतियां

downloads

इस एपीआई का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "downloads" अनुमति का एलान करना होगा.

{
  "name": "My extension",
  ...
  "permissions": [
    "downloads"
  ],
}

उदाहरण

chrome.downloads एपीआई को इस्तेमाल करने के आसान उदाहरण, 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

    बूलियन

    अगर डाउनलोड जारी है और रुक गया है, तो यह 'सही' होगा. इसके अलावा, अगर डाउनलोड रुक गया है, तो उसे वहीं से शुरू किया जा सकता है जहां उसे रोका गया था.

  • खतरा

    DangerType

    इससे यह पता चलता है कि डाउनलोड किया गया कॉन्टेंट सुरक्षित है या संदिग्ध.

  • 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

Chrome 105 और उसके बाद वाले वर्शन

प्रॉपर्टी

  • चालू किया गया

    बूलियन

    डाउनलोड यूज़र इंटरफ़ेस (यूआई) को चालू या बंद करें.

तरीके

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 में जानकारी देने वाली स्ट्रिंग होगी. इस बात की कोई गारंटी नहीं है कि गड़बड़ी वाली स्ट्रिंग, रिलीज़ के बीच पुराने सिस्टम के साथ काम करती रहेंगी. एक्सटेंशन को इसे पार्स नहीं करना चाहिए.

पैरामीटर

  • विकल्प

    DownloadOptions

    क्या डाउनलोड करना है और कैसे करना है.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है: 

    (downloadId: number) => void

    • downloadId

      संख्या

रिटर्न

  • Promise<number>

    Chrome 96 या इसके बाद के वर्शन

    मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

erase()

प्रॉमिस 
chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
)

डाउनलोड की गई फ़ाइल मिटाए बिना, मिलान करने वाले DownloadItem को इतिहास से हमेशा के लिए मिटाएं. query से मैच करने वाले हर DownloadItem इवेंट के लिए, एक onErased इवेंट ट्रिगर होगा. इसके बाद, callback को कॉल किया जाएगा.

पैरामीटर

  • क्वेरी

    DownloadQuery

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    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 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

प्रॉमिस 
chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
)

DownloadItem को ढूंढें. सभी DownloadItem पाने के लिए, query को खाली ऑब्जेक्ट पर सेट करें. कोई खास DownloadItem पाने के लिए, सिर्फ़ id फ़ील्ड सेट करें. आइटम की बड़ी संख्या को पेज करने के लिए, orderBy: ['-startTime'] को सेट करें, हर पेज पर आइटम की संख्या के लिए limit सेट करें, और आखिरी पेज के आखिरी आइटम के लिए startedAfter को startTime पर सेट करें.

पैरामीटर

  • क्वेरी

    DownloadQuery

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है: 

    (results: DownloadItem[]) => void

रिटर्न

  • Promise<DownloadItem[]>

    Chrome 96 या इसके बाद के वर्शन

    मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setShelfEnabled()

Chrome 117 के बाद से अब तक काम नहीं करता
chrome.downloads.setShelfEnabled(
  enabled: boolean,
)

इसके बजाय, setUiOptions का इस्तेमाल करें.

मौजूदा ब्राउज़र प्रोफ़ाइल से जुड़ी हर विंडो के नीचे मौजूद स्लेटी शेल्फ़ को चालू या बंद करें. शेल्फ़ तब तक बंद रहेगा, जब तक कम से कम एक एक्सटेंशन उसे बंद नहीं कर देता. अगर कम से कम एक और एक्सटेंशन के बंद होने पर शेल्फ़ को चालू किया जाता है, तो runtime.lastError के ज़रिए आपको गड़बड़ी का मैसेज दिखेगा. "downloads" अनुमति के साथ-साथ, "downloads.shelf" अनुमति की ज़रूरत है.

पैरामीटर

  • चालू किया गया

    बूलियन

setUiOptions()

प्रॉमिस Chrome 105 और उसके बाद वाले वर्शन के लिए 
chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
)

मौजूदा ब्राउज़र प्रोफ़ाइल से जुड़ी हर विंडो के लिए, डाउनलोड यूज़र इंटरफ़ेस (यूआई) बदलें. जब तक कम से कम एक एक्सटेंशन ने UiOptions.enabled को 'गलत है' पर सेट किया है, तब तक डाउनलोड यूज़र इंटरफ़ेस (यूआई) छिपा रहेगा. UiOptions.enabled को 'सही' पर सेट किया गया है, जबकि कम से कम एक अन्य एक्सटेंशन ने इसे बंद कर दिया है. इससे runtime.lastError के ज़रिए गड़बड़ी का मैसेज मिलेगा. "downloads" अनुमति के साथ-साथ, "downloads.ui" अनुमति की ज़रूरत है.

पैरामीटर

  • विकल्प

    UiOptions

    डाउनलोड यूज़र इंटरफ़ेस (यूआई) में बदलाव को इनकैप्सुलेट करें.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    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

onCreated

chrome.downloads.onCreated.addListener(
  callback: function,
)

डाउनलोड शुरू होने पर, यह इवेंट DownloadItem ऑब्जेक्ट के साथ फ़ायर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (downloadItem: DownloadItem) => void

onDeterminingFilename

chrome.downloads.onDeterminingFilename.addListener(
  callback: function,
)

फ़ाइल का नाम तय करने की प्रोसेस के दौरान, एक्सटेंशन को टारगेट DownloadItem.filename को बदलने का मौका दिया जाएगा. हर एक्सटेंशन इस इवेंट के लिए एक से ज़्यादा लिसनर रजिस्टर नहीं कर सकता. हर लिसनर को suggest को सिर्फ़ एक बार, सिंक्रोनस या एसिंक्रोनस तरीके से कॉल करना चाहिए. अगर सुनने वाला व्यक्ति suggest को एसिंक्रोनस तरीके से कॉल करता है, तो उसे true देना होगा. अगर लिसनर न तो suggest को सिंक करके कॉल करता है और न ही true का जवाब देता है, तो suggest अपने-आप कॉल हो जाएगा. जब तक सभी श्रोता suggest पर कॉल नहीं करते, तब तक DownloadItem पूरा नहीं होगा. उपयोगकर्ता, suggest को बिना किसी आर्ग्युमेंट के कॉल कर सकते हैं, ताकि डाउनलोड अपने फ़ाइल नाम के लिए downloadItem.filename का इस्तेमाल कर सके. इसके अलावा, टारगेट फ़ाइल नाम को बदलने के लिए, suggest को suggestion ऑब्जेक्ट पास किया जा सकता है. अगर एक से ज़्यादा एक्सटेंशन, फ़ाइल नाम को बदल देते हैं, तो आखिरी बार इंस्टॉल किया गया एक्सटेंशन जिसका लिसनर, suggest को suggestion ऑब्जेक्ट पास करता है उसे जीतता है. कौनसा एक्सटेंशन काम करेगा, इस बारे में भ्रम की स्थिति से बचने के लिए, उपयोगकर्ताओं को ऐसे एक्सटेंशन इंस्टॉल नहीं करने चाहिए जिनके बीच टकराव हो सकता है. अगर download से डाउनलोड शुरू किया जाता है और टारगेट फ़ाइल का नाम, MIME टाइप और संभावित फ़ाइल नाम तय होने से पहले ही पता चल जाता है, तो इसके बजाय filename को download पर पास करें.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (downloadItem: DownloadItem, suggest: function) => void

    • downloadItem

      DownloadItem

    • सुझाव दो

      फ़ंक्शन

      suggest पैरामीटर ऐसा दिखता है: 

      (suggestion?: FilenameSuggestion) => void

onErased

chrome.downloads.onErased.addListener(
  callback: function,
)

जब किसी डाउनलोड को इतिहास से मिटा दिया जाता है, तो downloadId से सक्रिय होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (downloadId: number) => void

    • downloadId

      संख्या