chrome.downloads

refresh date: 2026-09-25 robots: noindex

इस अनुमति से चेतावनी मिलती है

ब्यौरा

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

अनुमतियां

downloads

मेनिफ़ेस्ट

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

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

उदाहरण

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

टाइप

BooleanDelta

प्रॉपर्टी

  • जो मौजूदा

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

  • पीछे जाएं

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

DangerType

Enum

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

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

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

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

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

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

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

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

"allowlistedByPolicy"
Enterprise-related values.

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

"forceSaveToGdrive"
इसका इस्तेमाल Secure Enterprise Browser एक्सटेंशन करता है. ज़रूरत पड़ने पर, Chrome डिस्क में डाउनलोड करने की सुविधा को ब्लॉक कर देगा और फ़ाइल को सीधे Google Drive में डाउनलोड कर देगा.

"forceSaveToOnedrive"
इसका इस्तेमाल Secure Enterprise Browser एक्सटेंशन करता है. ज़रूरत पड़ने पर, Chrome डिस्क में डाउनलोड होने वाली फ़ाइल को ब्लॉक कर देगा और उसे सीधे OneDrive में डाउनलोड कर देगा.

DoubleDelta

प्रॉपर्टी

  • जो मौजूदा

    number 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 में कोई बदलाव हुआ है, तो उसकी जानकारी.

  • id

    संख्या

    बदले गए 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 या इसके बाद का वर्शन

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

  • id

    संख्या

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

  • गुप्त

    बूलियन

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

  • माइम

    स्ट्रिंग

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

  • रोका गया

    बूलियन

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

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

    स्ट्रिंग

    संपूर्ण यूआरएल.

  • startTime

    स्ट्रिंग

    आईएसओ 8601 फ़ॉर्मैट में, डाउनलोड शुरू होने का समय. इसे सीधे तौर पर Date कंस्ट्रक्टर को पास किया जा सकता है: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

  • राज्य

    राज्य

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

  • totalBytes

    संख्या

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

  • url

    स्ट्रिंग

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

DownloadOptions

प्रॉपर्टी

  • body

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

    पोस्ट का मुख्य हिस्सा.

  • conflictAction

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

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

  • filename

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

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

  • हेडर

    HeaderNameValuePair[] optional

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

  • तरीका

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

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

  • saveAs

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

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

  • url

    स्ट्रिंग

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

DownloadQuery

प्रॉपर्टी

  • bytesReceived

    number optional

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

  • खतरा

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

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

  • endTime

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

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

  • endedAfter

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

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

  • endedBefore

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

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

  • गड़बड़ी

    InterruptReason optional

    डाउनलोड की प्रोसेस क्यों रुक गई.

  • मौजूद है

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

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

  • fileSize

    number optional

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

  • filename

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

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

  • filenameRegex

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

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

  • finalUrl

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

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

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

  • finalUrlRegex

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

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

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

  • id

    number optional

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

  • सीमा

    number optional

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

  • माइम

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

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

  • orderBy

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

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

  • रोका गया

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

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

  • क्वेरी

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

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

  • startTime

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

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

  • startedAfter

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

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

  • startedBefore

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

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

  • राज्य

    State ज़रूरी नहीं

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

  • totalBytes

    number optional

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

  • totalBytesGreater

    number optional

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

  • totalBytesLess

    number optional

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

  • url

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

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

  • urlRegex

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

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

FilenameConflictAction

uniquify

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

ओवरराइट करें

मौजूदा फ़ाइल को नई फ़ाइल से बदल दिया जाएगा.

प्रॉम्प्ट

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

Enum

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

प्रॉपर्टी

  • conflictAction

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

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

  • filename

    स्ट्रिंग

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

GetFileIconOptions

प्रॉपर्टी

  • साइज़

    number 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()

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

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

पैरामीटर

  • downloadId

    संख्या

    DownloadItem के लिए आइडेंटिफ़ायर.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

    यह एक प्रॉमिस दिखाता है. जब खतरे की चेतावनी वाला डायलॉग बॉक्स बंद हो जाता है, तब यह प्रॉमिस रिज़ॉल्व हो जाता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

cancel()

Promise 
chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
): Promise<void>

डाउनलोड रद्द करना. callback चलाने पर, डाउनलोड रद्द हो जाता है, पूरा हो जाता है, रुक जाता है या अब मौजूद नहीं रहता.

पैरामीटर

  • downloadId

    संख्या

    डाउनलोड रद्द करने का आईडी.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

    यह एक प्रॉमिस दिखाता है. सदस्यता रद्द करने का अनुरोध पूरा होने पर, यह प्रॉमिस रिज़ॉल्व हो जाता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

download()

Promise 
chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
): Promise<number>

किसी यूआरएल को डाउनलोड करें. अगर यूआरएल में एचटीटीपी[एस] प्रोटोकॉल का इस्तेमाल किया जाता है, तो अनुरोध में उसके होस्टनेम के लिए सेट की गई सभी कुकी शामिल होंगी. अगर filename और saveAs, दोनों तय किए गए हैं, तो 'इस नाम से सेव करें' डायलॉग दिखेगा. इसमें filename की तय की गई वैल्यू पहले से भरी होगी. अगर डाउनलोड शुरू हो जाता है, तो callback को नए DownloadItem के downloadId के साथ कॉल किया जाएगा. अगर डाउनलोड शुरू करने में कोई गड़बड़ी हुई है, तो callback को downloadId=undefined के साथ कॉल किया जाएगा. साथ ही, runtime.lastError में जानकारी देने वाली स्ट्रिंग शामिल होगी. यह ज़रूरी नहीं है कि रिलीज़ के बीच, गड़बड़ी वाली स्ट्रिंग पुराने सिस्टम के साथ काम करती रहें. एक्सटेंशन को इसे पार्स नहीं करना चाहिए.

पैरामीटर

  • विकल्प

    DownloadOptions

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    (downloadId: number) => void

    • downloadId

      संख्या

रिटर्न

  • Promise<number>

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

    यह एक प्रॉमिस दिखाता है. यह प्रॉमिस, नए DownloadItem के आईडी के साथ रिज़ॉल्व होता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

erase()

Promise 
chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
): Promise<number[]>

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

पैरामीटर

  • क्वेरी

    DownloadQuery

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    (erasedIds: number[]) => void

    • erasedIds

      number[]

रिटर्न

  • Promise<number[]>

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

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

getFileIcon()

Promise 
chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
  callback?: function,
): Promise<string | undefined>

डाउनलोड किए गए किसी आइटम के लिए आइकॉन वापस पाएं. नए डाउनलोड के लिए, फ़ाइल के आइकॉन तब उपलब्ध होते हैं, जब onCreated इवेंट मिल जाता है. डाउनलोड के दौरान, इस फ़ंक्शन से मिली इमेज, डाउनलोड पूरा होने के बाद मिली इमेज से अलग हो सकती है. प्लैटफ़ॉर्म के आधार पर, आइकॉन को वापस पाने के लिए, ऑपरेटिंग सिस्टम या टूलकिट से क्वेरी की जाती है. इसलिए, दिखाया गया आइकॉन कई बातों पर निर्भर करेगा. जैसे, डाउनलोड की स्थिति, प्लैटफ़ॉर्म, रजिस्टर किए गए फ़ाइल टाइप, और विज़ुअल थीम. अगर फ़ाइल के आइकॉन का पता नहीं लगाया जा सकता, तो runtime.lastError में गड़बड़ी का मैसेज दिखेगा.

पैरामीटर

  • downloadId

    संख्या

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

  • विकल्प

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    (iconURL?: string) => void

    • iconURL

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

रिटर्न

  • Promise<string | undefined>

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

    यह एक प्रॉमिस दिखाता है. यह प्रॉमिस, डाउनलोड को दिखाने वाली इमेज के यूआरएल के साथ रिज़ॉल्व होता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

open()

Promise 
chrome.downloads.open(
  downloadId: number,
  callback?: function,
): Promise<void>

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

पैरामीटर

  • downloadId

    संख्या

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

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

    () => void

रिटर्न

  • Promise<void>

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

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

pause()

Promise 
chrome.downloads.pause(
  downloadId: number,
  callback?: function,
): Promise<void>

डाउनलोड रोकें. अगर अनुरोध पूरा हो गया है, तो डाउनलोड रुक जाएगा. अगर ऐसा नहीं है, तो runtime.lastError में गड़बड़ी का मैसेज होता है. अगर डाउनलोड चालू नहीं है, तो अनुरोध पूरा नहीं किया जा सकेगा.

पैरामीटर

  • downloadId

    संख्या

    डाउनलोड को रोकने के लिए आईडी.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

    यह एक प्रॉमिस दिखाता है. जब वीडियो रोकने का अनुरोध पूरा हो जाता है, तब यह प्रॉमिस रिज़ॉल्व हो जाता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

removeFile()

Promise 
chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
): Promise<void>

अगर डाउनलोड की गई फ़ाइल मौजूद है और DownloadItem पूरा हो गया है, तो उसे हटा दें. ऐसा न होने पर, runtime.lastError के ज़रिए गड़बड़ी की जानकारी दें.

पैरामीटर

  • downloadId

    संख्या

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

resume()

Promise 
chrome.downloads.resume(
  downloadId: number,
  callback?: function,
): Promise<void>

रोके गए डाउनलोड को फिर से शुरू करें. अगर अनुरोध पूरा हो गया है, तो डाउनलोड जारी रहेगा और उसे रोका नहीं जाएगा. अगर ऐसा नहीं है, तो runtime.lastError में गड़बड़ी का मैसेज होता है. अगर डाउनलोड चालू नहीं है, तो अनुरोध पूरा नहीं किया जा सकेगा.

पैरामीटर

  • downloadId

    संख्या

    उस डाउनलोड का आईडी जिसे फिर से शुरू करना है.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

    यह एक प्रॉमिस दिखाता है. जब फिर से शुरू करने का अनुरोध पूरा हो जाता है, तब यह प्रॉमिस रिज़ॉल्व हो जाता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

Promise 
chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
): Promise<DownloadItem[]>

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

पैरामीटर

  • क्वेरी

    DownloadQuery

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    (results: DownloadItem[]) => void

रिटर्न

  • Promise<DownloadItem[]>

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

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

setShelfEnabled()

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

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

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

पैरामीटर

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

    बूलियन

setUiOptions()

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

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

पैरामीटर

  • विकल्प

    UiOptions

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

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

      संख्या