chrome.downloads

ब्यौरा

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

अनुमतियां

downloads

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

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

उदाहरण

examples/api/downloads डायरेक्ट्री में, chrome.downloads एपीआई के इस्तेमाल के आसान उदाहरण देखे जा सकते हैं. अन्य उदाहरणों और सोर्स कोड देखने में मदद पाने के लिए, सैंपल देखें.

टाइप

BooleanDelta

प्रॉपर्टी

  • जो मौजूदा

    बूलियन ज़रूरी नहीं है

  • पीछे जाएं

    बूलियन ज़रूरी नहीं है

DangerType

फ़ाइल

डाउनलोड की गई फ़ाइल का नाम संदिग्ध है.

url

डाउनलोड करने के यूआरएल में नुकसान पहुंचाने वाला कॉन्टेंट मौजूद है.

कॉन्टेंट

डाउनलोड की गई फ़ाइल में नुकसान पहुंचाने वाली चीज़ें मौजूद हैं.

अनकॉमन

डाउनलोड का यूआरएल आम तौर पर डाउनलोड नहीं किया जाता है और यह खतरनाक हो सकता है.

होस्ट

यह डाउनलोड, नुकसान पहुंचाने वाले बाइनरी फ़ाइलें डिस्ट्रिब्यूट करने वाली होस्ट से आया है. इसलिए, यह खतरनाक हो सकता है.

अनचाहे

डाउनलोड की गई फ़ाइल शायद अनचाही है या सुरक्षित नहीं है. उदाहरण के लिए, यह ब्राउज़र या कंप्यूटर की सेटिंग में बदलाव कर सकता है.

सुरक्षित

डाउनलोड करने से, उपयोगकर्ता के कंप्यूटर को कोई खतरा नहीं होता.

स्‍वीकृत

उपयोगकर्ता ने खतरनाक डाउनलोड स्वीकार कर लिया है.

Enum

"file"

"url"

"content"

"uncommon"

"host"

"unwanted"

"safe"

"accepted"

"allowlistedByPolicy"

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

DoubleDelta

प्रॉपर्टी

  • जो मौजूदा

    number ज़रूरी नहीं

  • पीछे जाएं

    number ज़रूरी नहीं

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

    string ज़रूरी नहीं है

    अगर इस डाउनलोड को किसी एक्सटेंशन ने शुरू किया है, तो इस डाउनलोड को शुरू करने वाले एक्सटेंशन का आइडेंटिफ़ायर. इसे सेट करने के बाद बदला नहीं जा सकता.

  • byExtensionName

    string ज़रूरी नहीं है

    अगर इस डाउनलोड को किसी एक्सटेंशन ने शुरू किया है, तो इस डाउनलोड को शुरू करने वाले एक्सटेंशन का स्थानीय नाम. एक्सटेंशन का नाम बदलने या उपयोगकर्ता के स्थान-भाषा बदलने पर, यह कुकी बदल सकती है.

  • bytesReceived

    संख्या

    होस्ट से अब तक मिले बाइट की संख्या. इसमें फ़ाइल कंप्रेस करने की सुविधा को शामिल नहीं किया गया है.

  • canResume

    बूलियन

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

  • खतरा

    DangerType

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

  • 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 ज़रूरी नहीं है

    ISO 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.

  • फ़ाइल का नाम

    स्ट्रिंग

    ऐब्सलूट लोकल पाथ.

  • finalUrl

    स्ट्रिंग

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

    यह वह पूरा यूआरएल होता है जिससे यह डाउनलोड किया जा रहा है. यह सभी रीडायरेक्ट के बाद का यूआरएल होता है.

  • आईडी

    संख्या

    यह एक ऐसा आइडेंटिफ़ायर है जो ब्राउज़र के सभी सेशन में बना रहता है.

  • गुप्त

    बूलियन

    अगर यह डाउनलोड इतिहास में रिकॉर्ड किया गया है, तो इसकी वैल्यू False होगी. अगर यह रिकॉर्ड नहीं किया गया है, तो इसकी वैल्यू True होगी.

  • माइम

    स्ट्रिंग

    फ़ाइल का MIME टाइप.

  • रोका गया

    बूलियन

    अगर डाउनलोड की प्रोसेस में होस्ट से डेटा पढ़ना बंद कर दिया गया है, लेकिन कनेक्शन खुला रखा गया है, तो यह वैल्यू सही होती है.

  • रेफ़रल देने वाला

    स्ट्रिंग

    ऐब्सलूट यूआरएल.

  • 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 पहले से मौजूद है, तो की जाने वाली कार्रवाई.

  • फ़ाइल का नाम

    string ज़रूरी नहीं है

    डाउनलोड की गई फ़ाइल को सेव करने के लिए, Downloads डायरेक्ट्री के हिसाब से फ़ाइल पाथ. इसमें सबडायरेक्ट्री भी शामिल हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और ".." वाले बैक-रेफ़रंस वाले पाथ से गड़बड़ी होगी. onDeterminingFilename की मदद से, फ़ाइल का MIME टाइप और फ़ाइल का संभावित नाम तय होने के बाद, फ़ाइल का नाम सुझाया जा सकता है.

  • हेडर

    HeaderNameValuePair[] optional

    अगर यूआरएल, एचटीटीपी[एस] प्रोटोकॉल का इस्तेमाल करता है, तो अनुरोध के साथ भेजे जाने वाले अतिरिक्त एचटीटीपी हेडर. हर हेडर को एक डिक्शनरी के तौर पर दिखाया जाता है. इसमें name और value या binaryValue कुंजियां होती हैं. ये कुंजियां, XMLHttpRequest की अनुमति वाली कुंजियों तक ही सीमित होती हैं.

  • तरीका

    HttpMethod ज़रूरी नहीं है

    अगर यूआरएल में एचटीटीपी[एस] प्रोटोकॉल का इस्तेमाल किया जाता है, तो एचटीटीपी तरीके का इस्तेमाल करें.

  • saveAs

    बूलियन ज़रूरी नहीं है

    फ़ाइल चुनने वाले टूल का इस्तेमाल करें, ताकि उपयोगकर्ता फ़ाइल का नाम चुन सके. इससे कोई फ़र्क़ नहीं पड़ता कि filename सेट है या पहले से मौजूद है.

  • url

    स्ट्रिंग

    डाउनलोड करने के लिए यूआरएल.

DownloadQuery

प्रॉपर्टी

  • bytesReceived

    number ज़रूरी नहीं

    होस्ट से अब तक मिले बाइट की संख्या. इसमें फ़ाइल कंप्रेस करने की सुविधा को शामिल नहीं किया गया है.

  • खतरा

    DangerType optional

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

  • endTime

    string ज़रूरी नहीं है

    आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड खत्म होने का समय.

  • endedAfter

    string ज़रूरी नहीं है

    नतीजों को DownloadItem तक सीमित करता है. यह DownloadItem, ISO 8601 फ़ॉर्मैट में दिए गए मिलीसेकंड के बाद खत्म हुआ था

  • endedBefore

    string ज़रूरी नहीं है

    नतीजों को DownloadItem तक सीमित करता है. यह DownloadItem, ISO 8601 फ़ॉर्मैट में दिए गए मिलीसेकंड से पहले खत्म हो गया था.

  • गड़बड़ी

    InterruptReason optional

    डाउनलोड में रुकावट क्यों आई.

  • मौजूद है

    बूलियन ज़रूरी नहीं है

    डाउनलोड की गई फ़ाइल मौजूद है या नहीं;

  • fileSize

    number ज़रूरी नहीं

    डिकंप्रेशन के बाद पूरी फ़ाइल में बाइट की संख्या या अगर यह जानकारी उपलब्ध नहीं है, तो -1.

  • फ़ाइल का नाम

    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 ज़रूरी नहीं है

    फ़ाइल का MIME टाइप.

  • orderBy

    string[] ज़रूरी नहीं है

    खोज के नतीजों को क्रम से लगाने के लिए, इस ऐरे के एलिमेंट को DownloadItem प्रॉपर्टी पर सेट करें. उदाहरण के लिए, orderBy=['startTime'] सेट करने पर, DownloadItem को उनके शुरू होने के समय के हिसाब से बढ़ते क्रम में लगाया जाता है. घटते क्रम में जानकारी देने के लिए, हाइफ़न का इस्तेमाल करें: '-startTime'.

  • रोका गया

    बूलियन ज़रूरी नहीं है

    अगर डाउनलोड की प्रोसेस में होस्ट से डेटा पढ़ना बंद कर दिया गया है, लेकिन कनेक्शन खुला रखा गया है, तो यह वैल्यू सही होती है.

  • क्वेरी

    string[] ज़रूरी नहीं है

    खोज के लिए इस्तेमाल हुए शब्दों की इस कैटगरी में, नतीजे सिर्फ़ DownloadItem के लिए सीमित होते हैं. filename या url या finalUrl में, डैश '-' से शुरू न होने वाले खोज के लिए इस्तेमाल हुए सभी शब्द शामिल होते हैं. साथ ही, इसमें डैश से शुरू होने वाले खोज के लिए इस्तेमाल हुए कोई भी शब्द शामिल नहीं होते.

  • startTime

    string ज़रूरी नहीं है

    आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड शुरू होने का समय.

  • startedAfter

    string ज़रूरी नहीं है

    इस पैरामीटर का इस्तेमाल करके, नतीजे सिर्फ़ उन DownloadItem के लिए दिखाए जाते हैं जो ISO 8601 फ़ॉर्मैट में दिए गए समय के बाद शुरू हुए थे.

  • startedBefore

    string ज़रूरी नहीं है

    नतीजों को DownloadItem तक सीमित करता है. यह DownloadItem, ISO 8601 फ़ॉर्मैट में दिए गए ms से पहले शुरू हुआ था.

  • राज्य

    State ज़रूरी नहीं है

    इससे पता चलता है कि डाउनलोड की प्रोसेस चल रही है, रुक गई है या पूरी हो गई है.

  • totalBytes

    number ज़रूरी नहीं

    पूरी फ़ाइल में बाइट की संख्या. इसमें फ़ाइल कंप्रेस करने की सुविधा को शामिल नहीं किया जाता. अगर यह जानकारी उपलब्ध नहीं है, तो वैल्यू -1 होती है.

  • totalBytesGreater

    number ज़रूरी नहीं

    नतीजों को DownloadItem तक सीमित करता है. इनमें totalBytes की वैल्यू, दी गई पूर्णांक संख्या से ज़्यादा होती है.

  • totalBytesLess

    number ज़रूरी नहीं

    नतीजों को उन DownloadItem तक सीमित करता है जिनका totalBytes, दिए गए पूर्णांक से कम है.

  • url

    string ज़रूरी नहीं है

    यह वह ऐब्सलूट यूआरएल है जिससे रीडायरेक्ट होने से पहले, यह डाउनलोड शुरू हुआ था.

  • urlRegex

    string ज़रूरी नहीं है

    नतीजों को उन DownloadItem तक सीमित करता है जिनकी url, दिए गए रेगुलर एक्सप्रेशन से मेल खाती है.

FilenameConflictAction

यूनिक बनाना

डुप्लीकेट होने से बचाने के लिए, filename को बदलकर फ़ाइल नाम के एक्सटेंशन से पहले काउंटर शामिल किया जाता है.

ओवरराइट करें

मौजूदा फ़ाइल की जगह नई फ़ाइल सेव हो जाएगी.

prompt

उपयोगकर्ता को फ़ाइल चुनने का डायलॉग दिखेगा.

Enum

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

प्रॉपर्टी

  • conflictAction

    FilenameConflictAction ज़रूरी नहीं है

    अगर filename पहले से मौजूद है, तो की जाने वाली कार्रवाई.

  • फ़ाइल का नाम

    स्ट्रिंग

    DownloadItem का नया टारगेट DownloadItem.filename. यह उपयोगकर्ता की डिफ़ॉल्ट डाउनलोड डायरेक्ट्री के हिसाब से पाथ होता है. इसमें सबडायरेक्ट्री भी हो सकती हैं. ऐब्सलूट पाथ, खाली पाथ, और बैक-रेफ़रंस ".." वाले पाथ को अनदेखा कर दिया जाएगा. अगर किसी एक्सटेंशन ने कोई onDeterminingFilename लिसनर रजिस्टर किया है, तो filename को अनदेखा कर दिया जाता है.

GetFileIconOptions

प्रॉपर्टी

  • साइज़

    number ज़रूरी नहीं

    दिखाए गए आइकॉन का साइज़. आइकॉन स्क्वेयर (वर्गाकार) होगा. इसका डाइमेंशन, साइज़ * साइज़ पिक्सल होगा. आइकॉन का डिफ़ॉल्ट और सबसे बड़ा साइज़ 32x32 पिक्सल होता है. सिर्फ़ 16 और 32 साइज़ का इस्तेमाल किया जा सकता है. कोई अन्य साइज़ तय करना एक गड़बड़ी है.

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

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

प्रॉपर्टी

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

    बूलियन

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

तरीके

acceptDanger()

chrome.downloads.acceptDanger(
  downloadId: number,
): Promise<void>

उपयोगकर्ता को खतरनाक डाउनलोड स्वीकार करने के लिए सूचना दें. इसे सिर्फ़ ऐसे कॉन्टेक्स्ट से कॉल किया जा सकता है जो दिखता हो. जैसे, टैब, विंडो या पेज/ब्राउज़र ऐक्शन पॉप-अप. यह मोड, नुकसान पहुंचाने वाले डाउनलोड को अपने-आप स्वीकार नहीं करता. अगर डाउनलोड स्वीकार किया जाता है, तो onChanged इवेंट ट्रिगर होगा. ऐसा न होने पर, कुछ नहीं होगा. जब सारा डेटा किसी अस्थायी फ़ाइल में फ़ेच हो जाता है और डाउनलोड सुरक्षित होता है या खतरे को स्वीकार कर लिया जाता है, तब अस्थायी फ़ाइल का नाम बदलकर टारगेट फ़ाइल का नाम कर दिया जाता है. साथ ही, state की स्थिति बदलकर 'पूरा हुआ' हो जाती है और 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 में गड़बड़ी की जानकारी देने वाली स्ट्रिंग शामिल होगी. यह ज़रूरी नहीं है कि रिलीज़ के बीच, गड़बड़ी की स्ट्रिंग पुराने सिस्टम के साथ काम करती रहें. एक्सटेंशन को इसे पार्स नहीं करना चाहिए.

पैरामीटर

  • विकल्प

    DownloadOptions

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

रिटर्न

  • Promise<number>

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

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>

चुने गए डाउनलोड के लिए आइकॉन वापस पाएं. नए डाउनलोड के लिए, onCreated इवेंट मिलने के बाद फ़ाइल के आइकॉन उपलब्ध होते हैं. डाउनलोड के दौरान, इस फ़ंक्शन से मिली इमेज, डाउनलोड पूरा होने के बाद मिली इमेज से अलग हो सकती है. प्लैटफ़ॉर्म के हिसाब से, आइकॉन को वापस पाने की प्रोसेस, ऑपरेटिंग सिस्टम या टूलकिट से क्वेरी करके पूरी की जाती है. इसलिए, दिखाया गया आइकॉन कई बातों पर निर्भर करेगा. जैसे, डाउनलोड की स्थिति, प्लैटफ़ॉर्म, रजिस्टर किए गए फ़ाइल टाइप, और विज़ुअल थीम. अगर फ़ाइल के आइकॉन का पता नहीं लगाया जा सकता, तो 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 और इसके बाद के वर्शन 
chrome.downloads.search(
  query: DownloadQuery,
): Promise<DownloadItem[]>

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

पैरामीटर

रिटर्न

  • Promise<DownloadItem[]>

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

setShelfEnabled()

Chrome 117 से बंद कर दिया गया है
chrome.downloads.setShelfEnabled(
  enabled: boolean,
): void

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

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

पैरामीटर

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

    बूलियन

setUiOptions()

Chrome 105 या इसके बाद का वर्शन 
chrome.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

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

पैरामीटर

  • विकल्प

    UiOptions

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

रिटर्न

  • Promise<void>

show()

chrome.downloads.show(
  downloadId: number,
): void

डाउनलोड की गई फ़ाइल को फ़ाइल मैनेजर में उसके फ़ोल्डर में दिखाएं.

पैरामीटर

  • downloadId

    संख्या

    डाउनलोड की गई फ़ाइल के लिए आइडेंटिफ़ायर.

showDefaultFolder()

chrome.downloads.showDefaultFolder(): void

फ़ाइल मैनेजर में, डिफ़ॉल्ट डाउनलोड फ़ोल्डर दिखाएं.

इवेंट

onChanged

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

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

onErased

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

यह इवेंट, downloadId के साथ तब ट्रिगर होता है, जब डाउनलोड किए गए किसी आइटम को इतिहास से मिटाया जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (downloadId: number) => void

    • downloadId

      संख्या