chrome.downloads

ब्यौरा

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

अनुमतियां

downloads

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

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

उदाहरण

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

टाइप

BooleanDelta

प्रॉपर्टी

• जो मौजूदा

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

• पीछे जाएं

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

DangerType

फ़ाइल

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

यूआरएल

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

वीडियो

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

असामान्य

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

होस्ट

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

अनचाही

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

सुरक्षित

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

स्वीकार की गई

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

Enum

"asyncLocalPasswordScanning"

"passwordProtected"

"sensitiveContentWarning"

"sensitiveContentBlock"

"promptForScanning"

"promptForLocalPasswordScanning"

DoubleDelta

प्रॉपर्टी

• जो मौजूदा

  नंबर ज़रूरी नहीं

• पीछे जाएं

  नंबर ज़रूरी नहीं

DownloadDelta

प्रॉपर्टी

• canResume

  BooleanDelta ज़रूरी नहीं

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

• खतरा

  StringDelta ज़रूरी नहीं

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

• endTime

  StringDelta ज़रूरी नहीं

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

• गड़बड़ी

  StringDelta ज़रूरी नहीं

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

• मौजूद है

  BooleanDelta ज़रूरी नहीं

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

• fileSize

  DoubleDelta ज़रूरी नहीं

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

• फ़ाइल का नाम

  StringDelta ज़रूरी नहीं

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

• finalUrl

  StringDelta ज़रूरी नहीं

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

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

• id

  नंबर

  DownloadItem का id, जिसमें बदलाव हुआ है.

• माइम

  StringDelta ज़रूरी नहीं

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

• रोका गया

  BooleanDelta ज़रूरी नहीं

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

• startTime

  StringDelta ज़रूरी नहीं

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

• state

  StringDelta ज़रूरी नहीं

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

• totalBytes

  DoubleDelta ज़रूरी नहीं

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

• यूआरएल

  StringDelta ज़रूरी नहीं

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

DownloadItem

प्रॉपर्टी

• byExtensionId

  स्ट्रिंग ज़रूरी नहीं

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

• byExtensionName

  स्ट्रिंग ज़रूरी नहीं

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

• bytesReceived

  नंबर

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

• canResume

  boolean

  अगर डाउनलोड प्रगति में है और रुका हुआ है, तो सही.

• खतरा

  DangerType

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

• endTime

  स्ट्रिंग ज़रूरी नहीं

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

• गड़बड़ी

  InterruptReason ज़रूरी नहीं

  डाउनलोड क्यों रोका गया था. कई तरह की एचटीटीपी गड़बड़ियों को, SERVER_ से शुरू होने वाली किसी एक गड़बड़ी में शामिल किया जा सकता है. नेटवर्क से जुड़ी गड़बड़ियां NETWORK_ से शुरू होती हैं, फ़ाइल सिस्टम पर फ़ाइल लिखने की प्रोसेस से जुड़ी गड़बड़ियां FILE_ से शुरू होती हैं और उपयोगकर्ता की ओर से शुरू की गई रुकावटें USER_ से शुरू होती हैं.

• estimatedEndTime

  स्ट्रिंग ज़रूरी नहीं

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

• मौजूद है

  boolean

  क्या डाउनलोड की गई फ़ाइल अब भी मौजूद है. यह जानकारी पुरानी हो सकती है, क्योंकि Chrome अपने-आप फ़ाइल हटाने का अनुरोध नहीं करता. फ़ाइल मौजूद है या नहीं, इसकी जांच करने के लिए, search() को कॉल करें. मौजूदगी की जांच पूरी होने पर, अगर फ़ाइल मिटा दी गई है, तो onChanged इवेंट फ़ायर होगा. ध्यान दें कि search(), मौजूद होने की जांच के खत्म होने का इंतज़ार नहीं करता. इसलिए, हो सकता है कि search() से मिलने वाले नतीजे, फ़ाइल सिस्टम को सही तरीके से न दिखाएं. search() को ज़रूरत के मुताबिक कई बार कॉल किया जा सकता है. हालांकि, यह हर 10 सेकंड से ज़्यादा बार, फ़ाइल मौजूद होने की जांच नहीं करेगा.

• fileSize

  नंबर

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

• फ़ाइल का नाम

  स्ट्रिंग

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

• finalUrl

  स्ट्रिंग

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

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

• id

  नंबर

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

• गुप्त मोड

  boolean

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

• माइम

  स्ट्रिंग

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

• रोका गया

  boolean

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

• referrer

  स्ट्रिंग

  कुल यूआरएल.

• startTime

  स्ट्रिंग

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

• state

  राज्य

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

• totalBytes

  नंबर

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

• यूआरएल

  स्ट्रिंग

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

DownloadOptions

प्रॉपर्टी

• body

  स्ट्रिंग ज़रूरी नहीं

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

• conflictAction

  FilenameConflictAction ज़रूरी नहीं

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

• फ़ाइल का नाम

  स्ट्रिंग ज़रूरी नहीं

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

• headers

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

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

• method

  HttpMethod ज़रूरी नहीं

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

• saveAs

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

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

• यूआरएल

  स्ट्रिंग

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

DownloadQuery

प्रॉपर्टी

• bytesReceived

  नंबर ज़रूरी नहीं

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

• खतरा

  DangerType ज़रूरी नहीं

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

• endTime

  स्ट्रिंग ज़रूरी नहीं

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

• endedAfter

  स्ट्रिंग ज़रूरी नहीं

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

• endedBefore

  स्ट्रिंग ज़रूरी नहीं

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

• गड़बड़ी

  InterruptReason ज़रूरी नहीं

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

• मौजूद है

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

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

• fileSize

  नंबर ज़रूरी नहीं

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

• फ़ाइल का नाम

  स्ट्रिंग ज़रूरी नहीं

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

• filenameRegex

  स्ट्रिंग ज़रूरी नहीं

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

• finalUrl

  स्ट्रिंग ज़रूरी नहीं

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

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

• finalUrlRegex

  स्ट्रिंग ज़रूरी नहीं

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

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

• id

  नंबर ज़रूरी नहीं

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

• सीमा

  नंबर ज़रूरी नहीं

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

• माइम

  स्ट्रिंग ज़रूरी नहीं

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

• orderBy

  स्ट्रिंग[] ज़रूरी नहीं है

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

• रोका गया

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

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

• query

  स्ट्रिंग[] ज़रूरी नहीं है

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

• startTime

  स्ट्रिंग ज़रूरी नहीं

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

• startedAfter

  स्ट्रिंग ज़रूरी नहीं

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

• startedBefore

  स्ट्रिंग ज़रूरी नहीं

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

• state

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

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

• totalBytes

  नंबर ज़रूरी नहीं

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

• totalBytesGreater

  नंबर ज़रूरी नहीं

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

• totalBytesLess

  नंबर ज़रूरी नहीं

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

• यूआरएल

  स्ट्रिंग ज़रूरी नहीं

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

• urlRegex

  स्ट्रिंग ज़रूरी नहीं

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

FilenameConflictAction

एक जैसा

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

ओवरराइट करें

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

मैसेज

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

Enum

FilenameSuggestion

प्रॉपर्टी

• conflictAction

  FilenameConflictAction ज़रूरी नहीं

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

• फ़ाइल का नाम

  स्ट्रिंग

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

GetFileIconOptions

प्रॉपर्टी

• साइज़

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

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

HeaderNameValuePair

प्रॉपर्टी

• नाम

  स्ट्रिंग

  एचटीटीपी हेडर का नाम.

• value

  स्ट्रिंग

  एचटीटीपी हेडर की वैल्यू.

HttpMethod

Enum

"GET"

InterruptReason

Enum

"FILE_FAILED"

"FILE_ACCESS_DENIED"

"FILE_NO_SPACE"

"FILE_TOO_LARGE"

"FILE_VIRUS_INFECTED"

"FILE_TRANSIENT_ERROR"

"FILE_BLOCKED"

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

"USER_CANCELED"

"USER_SHUTDOWN"

State

in_progress

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

रुका हुआ है

किसी गड़बड़ी की वजह से, फ़ाइल होस्ट से कनेक्शन टूट गया है.

पूरा हो गया

डाउनलोड हो गया.

Enum

"in_progress"

StringDelta

प्रॉपर्टी

• जो मौजूदा

  स्ट्रिंग ज़रूरी नहीं

• पीछे जाएं

  स्ट्रिंग ज़रूरी नहीं

UiOptions

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

प्रॉपर्टी

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

  boolean

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

तरीके

acceptDanger()

वादा

chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
)

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

पैरामीटर

• downloadId

  नंबर

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

• कॉलबैक

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

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

  ()=>void

रिटर्न

• Promise<void>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

cancel()

वादा

chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
)

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

पैरामीटर

• downloadId

  नंबर

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

• कॉलबैक

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

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

  ()=>void

रिटर्न

• Promise<void>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

download()

वादा

chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
)

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

पैरामीटर

• विकल्प

  DownloadOptions

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

• कॉलबैक

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

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

  (downloadId: number)=>void

  • downloadId

    नंबर

रिटर्न

• वादा<number>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

erase()

वादा

chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
)

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

पैरामीटर

• query

  DownloadQuery

• कॉलबैक

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

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

  (erasedIds: number[])=>void

  • erasedIds

    नंबर[]

रिटर्न

• वादा करें<number[]>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

getFileIcon()

वादा

chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
  callback?: function,
)

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

पैरामीटर

• downloadId

  नंबर

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

• विकल्प

  GetFileIconOptions ज़रूरी नहीं

• कॉलबैक

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

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

  (iconURL?: string)=>void

  • iconURL

    स्ट्रिंग ज़रूरी नहीं

रिटर्न

• प्रॉमिस<string|undefined>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

open()

वादा

chrome.downloads.open(
  downloadId: number,
  callback?: function,
)

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

पैरामीटर

• downloadId

  नंबर

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

• कॉलबैक

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

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

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

  ()=>void

रिटर्न

• Promise<void>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

pause()

वादा

chrome.downloads.pause(
  downloadId: number,
  callback?: function,
)

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

पैरामीटर

• downloadId

  नंबर

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

• कॉलबैक

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

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

  ()=>void

रिटर्न

• Promise<void>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

removeFile()

वादा

chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
)

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

पैरामीटर

• downloadId

  नंबर

• कॉलबैक

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

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

  ()=>void

रिटर्न

• Promise<void>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

resume()

वादा

chrome.downloads.resume(
  downloadId: number,
  callback?: function,
)

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

पैरामीटर

• downloadId

  नंबर

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

• कॉलबैक

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

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

  ()=>void

रिटर्न

• Promise<void>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

search()

वादा

chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
)

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

पैरामीटर

• query

  DownloadQuery

• कॉलबैक

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

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

  (results: DownloadItem[])=>void

  • नतीजे

    DownloadItem[]

रिटर्न

• Promise<DownloadItem[]>

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

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

setShelfEnabled()

Chrome 117 के बाद से अब सेवा में नहीं है

chrome.downloads.setShelfEnabled(
  enabled: boolean,
)

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

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

पैरामीटर

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

  boolean

setUiOptions()

प्रॉमिस Chrome 105+

chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
)

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

पैरामीटर

• विकल्प

  UiOptions

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

• कॉलबैक

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

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

  ()=>void

रिटर्न

• Promise<void>

  प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

show()

chrome.downloads.show(
  downloadId: number,
)

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

पैरामीटर

• downloadId

  नंबर

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

showDefaultFolder()

chrome.downloads.showDefaultFolder()

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

इवेंट

onChanged

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (downloadDelta: DownloadDelta)=>void

  • downloadDelta

    DownloadDelta

onCreated

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (downloadItem: DownloadItem)=>void

  • downloadItem

    DownloadItem

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 से शुरू हो जाता है और MIME टाइप और संभावित फ़ाइल नाम तय होने से पहले ही टारगेट फ़ाइल का नाम पता चल जाता है, तो filename को download पर पास करें.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

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

  • downloadItem

    DownloadItem

  • सुझाव

    फ़ंक्शन

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

    (suggestion?: FilenameSuggestion)=>void

    • सुझाव

      FilenameSuggestion ज़रूरी नहीं

onErased

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (downloadId: number)=>void

  • downloadId

    नंबर