browser.downloads

ब्यौरा

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

अनुमतियां

downloads

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

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

उदाहरण

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

टाइप

BooleanDelta

प्रॉपर्टी

• जो मौजूदा

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

• पीछे जाएं

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

DangerType

Enum

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

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

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

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

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

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

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

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

"allowlistedByPolicy"
एंटरप्राइज़ से जुड़ी वैल्यू.

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

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

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

DoubleDelta

प्रॉपर्टी

• जो मौजूदा

  number ज़रूरी नहीं

• पीछे जाएं

  number ज़रूरी नहीं

DownloadDelta

प्रॉपर्टी

• canResume

  BooleanDelta ज़रूरी नहीं

  canResume में हुआ बदलाव, अगर कोई है.

• खतरा

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

  danger में हुआ बदलाव, अगर कोई है.

• endTime

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

  endTime में हुआ बदलाव, अगर कोई है.

• गड़बड़ी

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

  error में हुआ बदलाव, अगर कोई है.

• मौजूद है

  BooleanDelta ज़रूरी नहीं

  exists में हुआ बदलाव, अगर कोई है.

• fileSize

  DoubleDelta ज़रूरी नहीं

  fileSize में हुआ बदलाव, अगर कोई है.

• filename

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

  filename में हुआ बदलाव, अगर कोई है.

• finalUrl

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

  Chrome 54+ browser.* Chrome 148 से

  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

  बूलियन

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

• खतरा

  DangerType

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

• endTime

  string ज़रूरी नहीं

  ISO 8601 फ़ॉर्मैट में, डाउनलोड खत्म होने का समय. इसे सीधे Date कंस्ट्रक्टर को पास किया जा सकता है: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

• गड़बड़ी

  InterruptReason ज़रूरी नहीं

  फ़ाइल को डाउनलोड होने से क्यों रोका गया था. कई तरह की एचटीटीपी गड़बड़ियों को, 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+ browser.* Chrome 148 से

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

• आईडी

  संख्या

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

• गुप्त मोड

  बूलियन

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

• माइम

  स्ट्रिंग

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

• रोका गया

  बूलियन

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

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

  स्ट्रिंग

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

• startTime

  स्ट्रिंग

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

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

• तरीका

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

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

• saveAs

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

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

• url

  स्ट्रिंग

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

DownloadQuery

प्रॉपर्टी

• bytesReceived

  number ज़रूरी नहीं

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

• खतरा

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

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

• endTime

  string ज़रूरी नहीं

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

• endedAfter

  string ज़रूरी नहीं

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

• endedBefore

  string ज़रूरी नहीं

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

• गड़बड़ी

  InterruptReason ज़रूरी नहीं

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

• मौजूद है

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

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

• fileSize

  number ज़रूरी नहीं

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

• filename

  string ज़रूरी नहीं

  लोकल पाथ.

• filenameRegex

  string ज़रूरी नहीं

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

• finalUrl

  string ज़रूरी नहीं

  Chrome 54+ browser.* Chrome 148 से

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

• finalUrlRegex

  string ज़रूरी नहीं

  Chrome 54+ browser.* Chrome 148 से

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

• आईडी

  number ज़रूरी नहीं

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

• सीमा

  number ज़रूरी नहीं

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

• माइम

  string ज़रूरी नहीं

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

• orderBy

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

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

• रोका गया

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

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

• क्वेरी

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

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

• startTime

  string ज़रूरी नहीं

  ISO 8601 फ़ॉर्मैट में, वह समय जब डाउनलोड शुरू हुआ.

• startedAfter

  string ज़रूरी नहीं

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

• startedBefore

  string ज़रूरी नहीं

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

• राज्य

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

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

• totalBytes

  number ज़रूरी नहीं

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

• totalBytesGreater

  number ज़रूरी नहीं

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

• totalBytesLess

  number ज़रूरी नहीं

  नतीजों को उन 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 ज़रूरी नहीं

  डेंसिटी-इंडिपेंडेंट पिक्सल (डीआईपी) में, दिखाए गए आइकॉन का साइज़. यह 16 या 32 होना चाहिए. डिफ़ॉल्ट रूप से, यह 32 पर सेट होता है. हाई-डीपीआई डिसप्ले पर, इमेज का साइज़ डिवाइस के स्केल फ़ैक्टर के हिसाब से बदलता है. उदाहरण के लिए, 2x डिसप्ले पर 32 साइज़ के लिए 64x64 पिक्सल. बैकग्राउंड में चलने वाले सर्विस वर्कर से किए जाने वाले कॉल, डिफ़ॉल्ट रूप से 1x स्केल पर होते हैं.

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+ Chrome 148 से browser.*

प्रॉपर्टी

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

  बूलियन

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

तरीके

acceptDanger()

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

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

पैरामीटर

• downloadId

  संख्या

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

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

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

cancel()

browser.downloads.cancel(
  downloadId: number,
): Promise<void>

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

पैरामीटर

• downloadId

  संख्या

  उस डाउनलोड का आईडी जिसे रद्द करना है.

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

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

download()

browser.downloads.download(
  options: DownloadOptions,
): Promise<number>

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

पैरामीटर

• विकल्प

  DownloadOptions

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

रिटर्न

• Promise<number>

  Chrome 96+ Chrome 148 से browser.*

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

erase()

browser.downloads.erase(
  query: DownloadQuery,
): Promise<number[]>

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

पैरामीटर

• क्वेरी

  DownloadQuery

रिटर्न

• Promise<number[]>

  Chrome 96+ Chrome 148 से browser.*

getFileIcon()

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

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

पैरामीटर

• downloadId

  संख्या

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

• विकल्प

  GetFileIconOptions ज़रूरी नहीं

रिटर्न

• Promise<string | undefined>

  Chrome 96+ Chrome 148 से browser.*

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

open()

browser.downloads.open(
  downloadId: number,
): Promise<void>

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

पैरामीटर

• downloadId

  संख्या

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

रिटर्न

• वादा<शून्य>

  Chrome 123+ Chrome 148 से browser.*

pause()

browser.downloads.pause(
  downloadId: number,
): Promise<void>

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

पैरामीटर

• downloadId

  संख्या

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

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

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

removeFile()

browser.downloads.removeFile(
  downloadId: number,
): Promise<void>

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

पैरामीटर

• downloadId

  संख्या

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

resume()

browser.downloads.resume(
  downloadId: number,
): Promise<void>

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

पैरामीटर

• downloadId

  संख्या

  डाउनलोड फिर से शुरू करने के लिए, डाउनलोड का आईडी.

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

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

search()

browser.downloads.search(
  query: DownloadQuery,
): Promise<DownloadItem[]>

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

पैरामीटर

• क्वेरी

  DownloadQuery

रिटर्न

• Promise<DownloadItem[]>

  Chrome 96+ Chrome 148 से browser.*

setShelfEnabled()

Chrome 117 के बाद से, इस सुविधा का इस्तेमाल नहीं किया जा सकता

browser.downloads.setShelfEnabled(
  enabled: boolean,
): void

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

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

पैरामीटर

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

  बूलियन

setUiOptions()

Chrome 105+ Chrome 148 से browser.*

browser.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

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

पैरामीटर

• विकल्प

  UiOptions

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

रिटर्न

• वादा<शून्य>

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

show()

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

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

पैरामीटर

• downloadId

  संख्या

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

showDefaultFolder()

browser.downloads.showDefaultFolder(): void

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

इवेंट

onChanged

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

जब bytesReceived और estimatedEndTime को छोड़कर, DownloadItem की किसी भी प्रॉपर्टी में बदलाव होता है, तो यह इवेंट downloadId और बदली गई प्रॉपर्टी वाले ऑब्जेक्ट के साथ ट्रिगर होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (downloadDelta: DownloadDelta) => void

  • downloadDelta

    DownloadDelta

onCreated

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (downloadItem: DownloadItem) => void

  • downloadItem

    DownloadItem

onDeterminingFilename

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

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

  • downloadItem

    DownloadItem

  • सुझाव दें

    फ़ंक्शन

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

    (suggestion?: FilenameSuggestion) => void

    • सुझाव

      FilenameSuggestion ज़रूरी नहीं

onErased

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (downloadId: number) => void

  • downloadId

    संख्या