chrome.downloads

ब्यौरा

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

अनुमतियां

downloads

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

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

उदाहरण

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

टाइप

BooleanDelta

प्रॉपर्टी

  • जो मौजूदा

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

  • पीछे जाएं

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

DangerType

Enum

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

"url"
डाउनलोड करने के लिए दिए गए यूआरएल को नुकसान पहुंचाने वाला माना जाता है.

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

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

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

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

"सुरक्षित"
इस डाउनलोड से उपयोगकर्ता के कंप्यूटर को कोई खतरा नहीं है.

"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 में डाउनलोड कर देगा.

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 फ़ॉर्मैट में दिए गए ms के बाद खत्म हुआ था

  • 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 के लिए सीमित होते हैं. इनमें ऐसे सभी शब्द शामिल होते हैं जो डैश '-' से शुरू नहीं होते हैं. साथ ही, इनमें ऐसे कोई भी शब्द शामिल नहीं होते हैं जो डैश से शुरू होते हैं.filenameurlfinalUrl

  • startTime

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

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

  • startedAfter

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

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

  • startedBefore

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

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

  • राज्य

    राज्य ज़रूरी नहीं है

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

  • 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

फ़िलहाल, डाउनलोड को सर्वर से डेटा मिल रहा है.

इंटरप्ट किया गया

फ़ाइल होस्ट करने वाली सेवा से कनेक्शन टूट गया है.

complete

डाउनलोड पूरा हो गया है.

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

      संख्या