browser.downloads

ब्यौरा

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

अनुमतियां

downloads

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

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

उदाहरण

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

टाइप

BooleanDelta

प्रॉपर्टी

  • जो मौजूदा

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

  • पीछे जाएं

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

DangerType

Enum

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

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

"content"
डाउनलोड की गई फ़ाइल के बारे में पता चला है कि यह नुकसान पहुंचाने वाली फ़ाइल है.

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

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

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

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

"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 optional

  • पीछे जाएं

    number optional

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

    बूलियन

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

  • खतरा

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

    आईएसओ 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 ज़रूरी नहीं है

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

  • हेडर

    HeaderNameValuePair[] optional

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

  • तरीका

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

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

  • saveAs

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

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

  • url

    स्ट्रिंग

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

DownloadQuery

प्रॉपर्टी

  • bytesReceived

    number optional

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

  • खतरा

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

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

  • endTime

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

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

  • endedAfter

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

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

  • endedBefore

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

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

  • गड़बड़ी

    InterruptReason optional

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

  • मौजूद है

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

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

  • fileSize

    number optional

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

  • filename

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

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

  • filenameRegex

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

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

  • finalUrl

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

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

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

  • finalUrlRegex

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

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

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

  • आईडी

    number optional

    क्वेरी करने के लिए, DownloadItem का id.

  • सीमा

    number optional

    मिलते-जुलते DownloadItem की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट रूप से, यह वैल्यू 1,000 पर सेट होती है. मेल खाने वाले सभी DownloadItem वापस पाने के लिए, इसे 0 पर सेट करें. नतीजों को पेज के हिसाब से देखने के लिए, search पर जाएं.

  • माइम

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

    फ़ाइल का एमआईएमई टाइप.

  • orderBy

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

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

  • रोका गया

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

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

  • क्वेरी

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

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

  • startTime

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

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

  • startedAfter

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

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

  • startedBefore

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

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

  • राज्य

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

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

  • totalBytes

    number optional

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

  • totalBytesGreater

    number optional

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

  • totalBytesLess

    number optional

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

  • url

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

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

  • urlRegex

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

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

FilenameConflictAction

यूनिक बनाना

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

ओवरराइट करें

मौजूदा फ़ाइल की जगह नई फ़ाइल का इस्तेमाल किया जाएगा.

प्रॉम्प्ट

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

Enum

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

प्रॉपर्टी

  • conflictAction

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

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

  • filename

    स्ट्रिंग

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

GetFileIconOptions

प्रॉपर्टी

  • साइज़

    number optional

    दिखाए गए आइकॉन का साइज़. आइकॉन स्क्वेयर (वर्गाकार) होगा. इसका डाइमेंशन, साइज़ * साइज़ पिक्सल होगा. आइकॉन का डिफ़ॉल्ट और सबसे बड़ा साइज़ 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 और इसके बाद के वर्शन

    यह एक प्रॉमिस दिखाता है. यह प्रॉमिस, नए 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>

चुने गए डाउनलोड के लिए आइकॉन वापस पाएं. नए डाउनलोड के लिए, 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,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

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

onErased

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (downloadId: number) => void

    • downloadId

      संख्या