chrome.downloads

রিফ্রেশ করার তারিখ: ২৫-০৯-২০২৬ রোবট: noindex

এই অনুমতি সতর্কতা ট্রিগার করে

বিবরণ

প্রোগ্র্যামাটিক্যালি ডাউনলোড শুরু, মনিটর, ম্যানিপুলেট ও সার্চ করতে chrome.downloads API ব্যবহার করুন।

অনুমতি

downloads

ম্যানিফেস্ট

এই API ব্যবহার করতে আপনাকে অবশ্যই এক্সটেনশন ম্যানিফেস্টে "downloads" সংক্রান্ত অনুমতি ঘোষণা করতে হবে।

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

উদাহরণ

examples/api/downloads ডিরেক্টরিতে chrome.downloads API ব্যবহারের সহজ উদাহরণ দেখতে পাবেন। অন্যান্য উদাহরণ ও সোর্স কোড দেখার ব্যাপারে সাহায্যের জন্য, স্যাম্পেল দেখুন।

ধরন

BooleanDelta

প্রপার্টি

  • বর্তমানে

    বুলিয়ান ঐচ্ছিক

  • আগের বোতাম

    বুলিয়ান ঐচ্ছিক

DangerType

Enum

"ফাইল"
ডাউনলোড করা ফাইলের নাম সন্দেহজনক।

"url"
ডাউনলোডের URL ক্ষতিকর বলে জানা গেছে।

"কন্টেন্ট"
ডাউনলোড করা ফাইলটি ক্ষতিকর বলে জানা গেছে।

"অপরিচিত"
ডাউনলোডের URL সাধারণত ডাউনলোড করা হয় না এবং বিপজ্জনক হতে পারে।

"হোস্ট"
যে হোস্ট থেকে ডাউনলোড করা হয়েছে সেটি ক্ষতিকর বাইনারি ডিস্ট্রিবিউট করার জন্য পরিচিত এবং এটি সম্ভবত বিপজ্জনক।

"অবাঞ্ছিত"
ডাউনলোডটি সম্ভাব্য অবাঞ্ছিত বা অসুরক্ষিত। যেমন, এটি ব্রাউজার বা কম্পিউটার সেটিংসে পরিবর্তন করতে পারে।

"নিরাপদ"
ডাউনলোড করলে ব্যবহারকারীর কম্পিউটারের কোনও ক্ষতি হবে না।

"সম্মতি দিয়েছেন"
ব্যবহারকারী বিপজ্জনক ডাউনলোড করার ব্যাপারে সম্মতি দিয়েছেন।

"allowlistedByPolicy"
এন্টারপ্রাইজ-সম্পর্কিত ভ্যালু।

"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

প্রপার্টি

  • বর্তমানে

    নম্বর ঐচ্ছিক

  • আগের বোতাম

    নম্বর ঐচ্ছিক

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-এ কোনও পরিবর্তন করা হলে।

  • রাজ্য

    StringDelta ঐচ্ছিক

    state-এ কোনও পরিবর্তন করা হলে।

  • totalBytes

    DoubleDelta ঐচ্ছিক

    totalBytes-এ কোনও পরিবর্তন করা হলে।

  • URL

    StringDelta ঐচ্ছিক

    url-এ কোনও পরিবর্তন করা হলে।

DownloadItem

প্রপার্টি

  • byExtensionId

    স্ট্রিং ঐচ্ছিক

    এই ডাউনলোড যদি কোনও এক্সটেনশন দ্বারা শুরু করা হয়, তাহলে এই ডাউনলোড শুরু করা এক্সটেনশনের শনাক্তকারী। সেট করা হয়ে গেলে এটি আর পরিবর্তন করা যায় না।

  • byExtensionName

    স্ট্রিং ঐচ্ছিক

    এই ডাউনলোডটি কোনও এক্সটেনশন দ্বারা শুরু করা হলে, এই ডাউনলোডটি শুরু করা এক্সটেনশনের লোকালাইজ করা নাম। এক্সটেনশন তার নাম পরিবর্তন করলে বা ব্যবহারকারী তার লোকেল পরিবর্তন করলে এটি পরিবর্তন হতে পারে।

  • bytesReceived

    নম্বর

    ফাইল কমপ্রেস করার বিষয়টি বিবেচনা না করে, হোস্ট থেকে এখনও পর্যন্ত পাওয়া বাইটের সংখ্যা।

  • canResume

    বুলিয়ান

    ডাউনলোড প্রসেস চলছে এবং পজ করা আছে অথবা বিঘ্নিত হয়েছে এবং যেখান থেকে বিঘ্নিত হয়েছে সেখান থেকে আবার শুরু করা যাবে, এমন হলে ট্রু হিসেবে বিবেচিত হয়।

  • বিপদ

    এই ডাউনলোডটি নিরাপদ বলে মনে করা হয় নাকি সন্দেহজনক বলে জানা যায়, সেই সংক্রান্ত ইঙ্গিত।

  • endTime

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে ডাউনলোড শেষ হওয়ার সময়। সরাসরি Date কনস্ট্রাক্টরে পাস করা হতে পারে: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

  • সমস্যা

    InterruptReason ঐচ্ছিক

    ডাউনলোড কেন বিঘ্নিত হয়েছে। SERVER_ দিয়ে শুরু হওয়া কোনও একটি সমস্যার অধীনে বিভিন্ন ধরনের HTTP সংক্রান্ত সমস্যা গ্রুপ করা হতে পারে। নেটওয়ার্ক সম্পর্কিত সমস্যা NETWORK_ দিয়ে শুরু হয়, ফাইল সিস্টেমে ফাইল লেখার প্রসেস সম্পর্কিত সমস্যা FILE_ দিয়ে শুরু হয় এবং ব্যবহারকারীর দ্বারা শুরু করা বাধা USER_ দিয়ে শুরু হয়।

  • estimatedEndTime

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে ডাউনলোড সম্পূর্ণ হওয়ার আনুমানিক সময়। সরাসরি Date কনস্ট্রাক্টরে পাস করা যেতে পারে: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

  • আছে

    বুলিয়ান

    ডাউনলোড করা ফাইলটি এখনও আছে কিনা। এই তথ্য পুরনো হতে পারে কারণ Chrome অটোমেটিক ফাইল মুছে ফেলা সংক্রান্ত তথ্য দেখে না। ফাইল আছে কিনা তা চেক করার জন্য search() কল করুন। ফাইলটি মুছে ফেলা হলে, অস্তিত্ব চেক করার প্রসেস সম্পূর্ণ হওয়ার পরে, একটি onChanged ইভেন্ট ট্রিগার হবে। মনে রাখবেন, search() রিটার্ন করার আগে অস্তিত্ব চেক করার জন্য অপেক্ষা করে না, তাই search() থেকে পাওয়া ফলাফল ফাইল সিস্টেমকে সঠিকভাবে নাও দেখাতে পারে। এছাড়াও, search() যতবার প্রয়োজন ততবার কল করা হতে পারে, তবে প্রতি ১০ সেকেন্ডে একবারের বেশি ফাইল আছে কিনা চেক করা হবে না।

  • fileSize

    নম্বর

    ডিকম্প্রেশনের পরে সম্পূর্ণ ফাইলে বাইটের সংখ্যা, অথবা অজানা হলে -১।

  • ফাইলের নাম

    স্ট্রিং

    সম্পূর্ণ লোকাল পাথ।

  • finalUrl

    স্ট্রিং

    Chrome 54+

    সব রিডাইরেক্টের পরে, এই ডাউনলোডটি যে অ্যাবসলিউট URL থেকে করা হচ্ছে।

  • id

    নম্বর

    ব্রাউজার সেশন জুড়ে পার্সিস্টেন্ট থাকে এমন শনাক্তকারী।

  • ছদ্মবেশী মোড

    বুলিয়ান

    ইতিহাসে এই ডাউনলোড রেকর্ড করা থাকলে False, রেকর্ড করা না থাকলে True।

  • মূকাভিনয়

    স্ট্রিং

    ফাইলের MIME-এর প্রকার।

  • বিরাম দেওয়া হয়েছে

    বুলিয়ান

    হোস্ট থেকে ডেটা পড়া বন্ধ হয়ে গেলে, কিন্তু কানেকশন খোলা থাকলে, এটি 'ট্রু' হয়।

  • রেফারার

    স্ট্রিং

    অ্যাবসোলিউট URL।

  • startTime

    স্ট্রিং

    ISO 8601 ফর্ম্যাটে ডাউনলোড শুরু হওয়ার সময়। সরাসরি Date কনস্ট্রাক্টরে পাস করা হতে পারে: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

  • রাজ্য

    ডাউনলোড প্রসেস চলছে, বাধাগ্রস্ত হয়েছে নাকি সম্পূর্ণ হয়েছে তা দেখায়।

  • totalBytes

    নম্বর

    সম্পূর্ণ ফাইলের বাইটের সংখ্যা, ফাইল কম্প্রেশন বিবেচনা না করে অথবা -১ যদি অজানা হয়।

  • URL

    স্ট্রিং

    কোনও রিডাইরেক্টের আগে, এই ডাউনলোড যে URL থেকে শুরু হয়েছে।

DownloadOptions

প্রপার্টি

  • body

    স্ট্রিং ঐচ্ছিক

    পোস্টের মূল অংশ।

  • conflictAction

    FilenameConflictAction ঐচ্ছিক

    filename আগে থেকেই থাকলে যে অ্যাকশন নেওয়া হবে।

  • ফাইলের নাম

    স্ট্রিং ঐচ্ছিক

    ডাউনলোড করা ফাইলটি রাখার জন্য ডাউনলোড ডিরেক্টরির সাথে সম্পর্কিত একটি ফাইল পাথ, সম্ভবত সাবডিরেক্টরি সহ। অ্যাবসলিউট পাথ, খালি পাথ এবং ব্যাক-রেফারেন্স ".." থাকা পাথ সমস্যার কারণ হবে। ফাইলের MIME টাইপ এবং সম্ভাব্য ফাইলের নাম নির্ধারণ করার পরে onDeterminingFilename ফাইলের নাম সাজেস্ট করার অনুমতি দেয়।

  • হেডার

    HeaderNameValuePair[] ঐচ্ছিক

    URL, HTTP[s] প্রোটোকল ব্যবহার করলে, অনুরোধের সাথে পাঠানোর জন্য অতিরিক্ত HTTP হেডার। প্রতিটি হেডারকে একটি অভিধান হিসেবে দেখানো হয়, যার মধ্যে name এবং value অথবা binaryValue কী থাকে। এগুলি XMLHttpRequest-এর মাধ্যমে অনুমোদিত হতে হবে।

  • মেথড

    HttpMethod ঐচ্ছিক

    URL যদি HTTP[S] প্রোটোকল ব্যবহার করে, তাহলে HTTP পদ্ধতি ব্যবহার করতে হবে।

  • saveAs

    বুলিয়ান ঐচ্ছিক

    filename সেট করা আছে বা আগে থেকেই আছে কিনা তা নির্বিশেষে ব্যবহারকারীকে ফাইলের নাম বেছে নেওয়ার অনুমতি দিতে ফাইল-বেছে নেওয়ার বিকল্প ব্যবহার করুন।

  • URL

    স্ট্রিং

    ডাউনলোড করার URL।

DownloadQuery

প্রপার্টি

  • bytesReceived

    নম্বর ঐচ্ছিক

    ফাইল কমপ্রেস করার বিষয়টি বিবেচনা না করে, হোস্ট থেকে এখনও পর্যন্ত পাওয়া বাইটের সংখ্যা।

  • বিপদ

    DangerType ঐচ্ছিক

    এই ডাউনলোডটি নিরাপদ বলে মনে করা হচ্ছে নাকি সন্দেহজনক বলে জানা গেছে তার ইঙ্গিত।

  • endTime

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে ডাউনলোড শেষ হওয়ার সময়।

  • endedAfter

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে প্রদত্ত ms-এর পরে শেষ হওয়া DownloadItem-এ ফলাফল সীমিত করে

  • endedBefore

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে প্রদত্ত মিলি সেকেন্ডের আগে শেষ হওয়া DownloadItem-এ ফলাফল সীমিত করে।

  • সমস্যা

    InterruptReason ঐচ্ছিক

    কেন ডাউনলোড করার সময় বাধা সৃষ্টি হয়েছে।

  • এগজিস্টস

    বুলিয়ান ঐচ্ছিক

    ডাউনলোড করা ফাইলটি আছে কিনা;

  • fileSize

    নম্বর ঐচ্ছিক

    ডিকম্প্রেশনের পরে সম্পূর্ণ ফাইলে বাইটের সংখ্যা, অথবা অজানা হলে -১।

  • ফাইলের নাম

    স্ট্রিং ঐচ্ছিক

    অ্যাবসোলিউট লোকাল পাথ।

  • filenameRegex

    স্ট্রিং ঐচ্ছিক

    ফলাফল DownloadItem-এ সীমিত করে যার filename প্রদত্ত রেগুলার এক্সপ্রেশনের সাথে মেলে।

  • finalUrl

    স্ট্রিং ঐচ্ছিক

    Chrome 54+

    সব রিডাইরেক্টের পরে, যে অ্যাবসোলিউট URL থেকে এই ডাউনলোড করা হচ্ছে।

  • finalUrlRegex

    স্ট্রিং ঐচ্ছিক

    Chrome 54+

    DownloadItem-এর ফলাফল সীমিত করে, যার finalUrl প্রদত্ত রেগুলার এক্সপ্রেশনের সাথে ম্যাচ করে।

  • id

    নম্বর ঐচ্ছিক

    কোয়েরি করার জন্য DownloadItem-এর id।

  • সীমা

    নম্বর ঐচ্ছিক

    সর্বাধিক সংখ্যক ম্যাচিং DownloadItem রিটার্ন করা হয়েছে। ডিফল্ট হিসেবে ১০০০ সেট করা থাকে। সব ম্যাচিং DownloadItem ফিরিয়ে আনতে ০-তে সেট করুন। ফলাফলের মাধ্যমে কীভাবে পৃষ্ঠা দেখতে হয় তা জানতে search দেখুন।

  • মূকাভিনয়

    স্ট্রিং ঐচ্ছিক

    ফাইলের MIME-এর প্রকার।

  • orderBy

    string[] ঐচ্ছিক

    সার্চ ফলাফল সাজাতে এই অ্যারের এলিমেন্টকে DownloadItem প্রপার্টিতে সেট করুন। যেমন, orderBy=['startTime'] সেট করলে DownloadItem শুরুর সময় অনুযায়ী ছোট থেকে বড় ক্রমে সাজানো হয়। বড় থেকে ছোট ক্রমে সাজাতে, হাইফেন দিয়ে শুরু করুন: '-startTime'।

  • বিরাম দেওয়া হয়েছে

    বুলিয়ান ঐচ্ছিক

    হোস্ট থেকে ডেটা পড়া বন্ধ হয়ে গেলে, কিন্তু কানেকশন খোলা থাকলে, এটি 'ট্রু' হয়।

  • কোয়েরি

    string[] ঐচ্ছিক

    সার্চ করা শব্দের এই অ্যারে ফলাফলকে DownloadItem-এ সীমাবদ্ধ করে যার filename বা url বা finalUrl-এ এমন সব সার্চ করা শব্দ থাকে যা ড্যাশ '-' দিয়ে শুরু হয় না এবং ড্যাশ দিয়ে শুরু হয় এমন কোনও সার্চ করা শব্দ থাকে না।

  • startTime

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে ডাউনলোড শুরু হওয়ার সময়।

  • startedAfter

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে প্রদত্ত মিলি সেকেন্ডের পরে শুরু হওয়া DownloadItem-এ ফলাফল সীমিত করে।

  • startedBefore

    স্ট্রিং ঐচ্ছিক

    ISO 8601 ফর্ম্যাটে দেওয়া ms-এর আগে শুরু হওয়া DownloadItem-এর মধ্যে ফলাফল সীমিত করে।

  • রাজ্য

    রাজ্য ঐচ্ছিক

    ডাউনলোড প্রসেস চলছে, বাধা পেয়েছে নাকি সম্পূর্ণ হয়েছে তা জানায়।

  • totalBytes

    নম্বর ঐচ্ছিক

    সম্পূর্ণ ফাইলের বাইটের সংখ্যা, ফাইল কম্প্রেশন বিবেচনা না করে অথবা -১ যদি অজানা হয়।

  • totalBytesGreater

    নম্বর ঐচ্ছিক

    DownloadItem-এর ফলাফল সীমিত করে যার totalBytes প্রদত্ত পূর্ণসংখ্যার চেয়ে বেশি।

  • totalBytesLess

    নম্বর ঐচ্ছিক

    DownloadItem-এ ফলাফল সীমিত করে যার totalBytes প্রদত্ত পূর্ণসংখ্যার চেয়ে কম।

  • URL

    স্ট্রিং ঐচ্ছিক

    কোনও রিডাইরেক্টের আগে, এই ডাউনলোড যে URL থেকে শুরু হয়েছে।

  • urlRegex

    স্ট্রিং ঐচ্ছিক

    ফলাফল DownloadItem-এ সীমিত করে যার url প্রদত্ত রেগুলার এক্সপ্রেশনের সাথে মেলে।

FilenameConflictAction

ইউনিক করুন

ডুপ্লিকেট এড়াতে, filename পরিবর্তন করে ফাইলের নামের এক্সটেনশনের আগে একটি কাউন্টার যোগ করা হয়।

ওভাররাইট করুন

নতুন ফাইল দিয়ে আগে থেকে থাকা ফাইল ওভাররাইট করা হবে।

প্রম্পট

ব্যবহারকারীকে ফাইল বেছে নেওয়ার ডায়ালগ দেখানো হবে।

Enum

"uniquify"

"ওভাররাইট"

"প্রম্পট"

FilenameSuggestion

প্রপার্টি

  • conflictAction

    FilenameConflictAction ঐচ্ছিক

    filename আগে থেকেই থাকলে কী অ্যাকশন নিতে হবে।

  • ফাইলের নাম

    স্ট্রিং

    DownloadItem-এর নতুন টার্গেট DownloadItem.filename, ব্যবহারকারীর ডিফল্ট ডাউনলোড ডিরেক্টরির সাথে সম্পর্কিত পাথ হিসেবে, সম্ভবত সাবডিরেক্টরি সহ। সম্পূর্ণ পাথ, খালি পাথ এবং ব্যাক-রেফারেন্স ".." সহ পাথ উপেক্ষা করা হবে। কোনও এক্সটেনশন দ্বারা রেজিস্টার করা কোনও onDeterminingFilename শ্রোতা থাকলে filename উপেক্ষা করা হয়।

GetFileIconOptions

প্রপার্টি

  • সাইজ

    নম্বর ঐচ্ছিক

    ঘনত্ব-নিরপেক্ষ পিক্সেল (DIP)-এ রিটার্ন করা আইকনের সাইজ। ১৬ বা ৩২ হতে হবে (ডিফল্ট হিসেবে ৩২ থাকে)। হাই-DPI ডিসপ্লেতে, রিটার্ন করা ছবির স্কেল ডিভাইসের স্কেল ফ্যাক্টর অনুযায়ী হয় (যেমন, 2x ডিসপ্লেতে ৩২ সাইজের জন্য ৬৪x৬৪ পিক্সেল)। ব্যাকগ্রাউন্ড পরিষেবা কর্মীদের কল ডিফল্ট হিসেবে ১x স্কেলে থাকে।

HeaderNameValuePair

প্রপার্টি

  • নাম

    স্ট্রিং

    HTTP হেডারের নাম।

  • মান

    স্ট্রিং

    HTTP হেডারের ভ্যালু।

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"

"ক্র্যাশ"

State

in_progress

ডাউনলোড প্রসেস বর্তমানে সার্ভার থেকে ডেটা পাচ্ছে।

বাধাপ্রাপ্ত

সমস্যার কারণে ফাইল হোস্টের সাথে কানেকশন বিচ্ছিন্ন হয়ে গেছে।

সম্পূর্ণ করুন

ডাউনলোড সম্পূর্ণ হয়েছে।

Enum

"in_progress"

"বাধাগ্রস্ত"

"সম্পূর্ণ"

StringDelta

প্রপার্টি

  • বর্তমানে

    স্ট্রিং ঐচ্ছিক

  • আগের বোতাম

    স্ট্রিং ঐচ্ছিক

UiOptions

Chrome 105+

প্রপার্টি

  • সক্ষমিত

    বুলিয়ান

    ডাউনলোড UI চালু বা বন্ধ করুন।

পদ্ধতি

acceptDanger()

প্রতিশ্রুতি
chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
)
: Promise<void>

ব্যবহারকারীকে বিপজ্জনক ডাউনলোড গ্রহণ করার জন্য প্রম্পট করুন। শুধুমাত্র দৃশ্যমান কনটেক্সট (ট্যাব, উইন্ডো বা পৃষ্ঠা/ব্রাউজার অ্যাকশন পপ-আপ) থেকে কল করা যাবে। বিপজ্জনক ডাউনলোড অটোমেটিক গ্রহণ করে না। ডাউনলোড করার অনুরোধ গ্রহণ করা হলে, একটি onChanged ইভেন্ট ফায়ার হবে, অন্যথায় কিছুই হবে না। সব ডেটা একটি অস্থায়ী ফাইলে ফেচ করা হলে এবং ডাউনলোডটি বিপজ্জনক না হলে অথবা বিপদ মেনে নেওয়া হলে, অস্থায়ী ফাইলটির নাম পরিবর্তন করে টার্গেট ফাইলের নাম রাখা হয়, state পরিবর্তন করে 'সম্পূর্ণ' করা হয় এবং onChanged ফায়ার করে।

প্যারামিটারগুলি

  • downloadId

    নম্বর

    DownloadItem-এর শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    () =& gt;void

রিটার্ন

  • Promise<void>

    Chrome 96+

    বিপদ সংক্রান্ত প্রম্পট ডায়ালগ বন্ধ হয়ে গেলে, একটি প্রমিস রিটার্ন করে যা সমাধান করে।

    Manifest V3 এবং তার পরবর্তী ভার্সনে শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হয়।

cancel()

প্রতিশ্রুতি
chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
)
: Promise<void>

ডাউনলোড বাতিল করা। callback রান করার সময়, ডাউনলোড বাতিল, সম্পূর্ণ, বাধাগ্রস্ত হয়েছে অথবা আর নেই।

প্যারামিটারগুলি

  • downloadId

    নম্বর

    ডাউনলোড বাতিল করার আইডি।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    () =& gt;void

রিটার্ন

  • Promise<void>

    Chrome 96+

    বাতিল করার অনুরোধ সম্পূর্ণ হলে, একটি Promise রিটার্ন করে যা সমাধান করা হয়।

    Manifest V3 ও তার পরবর্তী ভার্সনের ক্ষেত্রেই শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হয়।

download()

প্রতিশ্রুতি
chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
)
: Promise<number>

URL ডাউনলোড করুন। URL-এ HTTP[S] প্রোটোকল ব্যবহার করা হলে, অনুরোধে সেটির হোস্টনেমের জন্য বর্তমানে সেট করা সব কুকি অন্তর্ভুক্ত থাকবে। filename এবং saveAs, দুটিই নির্দিষ্ট করা থাকলে, 'এই নামে সেভ করুন' ডায়ালগ দেখানো হবে, যা নির্দিষ্ট করা filename-এর সাথে অটো-ফিল করা থাকবে। ডাউনলোড সফলভাবে শুরু হলে, নতুন DownloadItem-এর downloadId সহ callback কল করা হবে। ডাউনলোড শুরু করার সময় কোনও সমস্যা হলে, callback-কে downloadId=undefined-এর সাথে কল করা হবে এবং runtime.lastError-এ একটি বর্ণনামূলক স্ট্রিং থাকবে। রিলিজের মধ্যে, সমস্যা সংক্রান্ত স্ট্রিং যে আগের ভার্সনের সাথে মানানসই হবেই, এমন কোনও গ্যারান্টি নেই। এক্সটেনশনকে এটি পার্স করলে চলবে না।

প্যারামিটারগুলি

  • বিকল্প

    কী ডাউনলোড করতে হবে এবং কীভাবে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    (downloadId: number) =& gt;void

    • downloadId

      নম্বর

রিটার্ন

  • Promise<number>

    Chrome 96+

    একটি Promise রিটার্ন করে যা নতুন DownloadItem-এর আইডি দিয়ে সমাধান করে।

    Manifest V3 ও তার পরবর্তী ভার্সনের ক্ষেত্রেই শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হয়।

erase()

প্রতিশ্রুতি
chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
)
: Promise<number[]>

ডাউনলোড করা ফাইল না মুছে ইতিহাস থেকে মিলে যাওয়া DownloadItem মুছে দিন। query-এর সাথে ম্যাচ করা প্রতিটি DownloadItem-এর জন্য একটি onErased ইভেন্ট ফায়ার করা হবে, তারপরে callback কল করা হবে।

প্যারামিটারগুলি

  • কোয়েরি
  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    (erasedIds: number[]) =& gt;void

    • erasedIds

      সংখ্যা[]

রিটার্ন

  • <number[]> প্রমিস

    Chrome 96+

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

getFileIcon()

প্রতিশ্রুতি
chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
  callback?: function,
)
: Promise<string | undefined>

নির্দিষ্ট ডাউনলোডের জন্য একটি আইকন ফিরিয়ে আনুন। নতুন ডাউনলোডের ক্ষেত্রে, ডাউনলোডের টার্গেট ফাইলের নাম নির্ধারণ করার পরে ফাইল আইকন উপলভ্য হয় (যেমন, onChanged filename পরিবর্তন সহ ফায়ার করলে)। ফাইলের নাম নির্ধারণ করার আগে আইকন রিট্রিভ করার চেষ্টা করলে runtime.lastError-এর মাধ্যমে একটি সমস্যা দেখা দেবে। ডাউনলোড চলাকালীন এই ফাংশন যে ছবি রিটার্ন করে তা ডাউনলোড সম্পূর্ণ হওয়ার পরে রিটার্ন করা ছবির থেকে আলাদা হতে পারে। প্ল্যাটফর্মের উপর নির্ভর করে অন্তর্নিহিত অপারেটিং সিস্টেম বা টুলকিট কোয়েরি করে আইকন রিট্রিভ করা হয়। তাই, ফিরে আসা আইকনটি ডাউনলোড, প্ল্যাটফর্ম, রেজিস্টার করা ফাইলের ধরন এবং ভিজ্যুয়াল থিম সহ বিভিন্ন বিষয়ের উপর নির্ভর করবে। ফাইল আইকন নির্ধারণ করা না গেলে, runtime.lastError-এ একটি সমস্যার মেসেজ থাকবে।

প্যারামিটারগুলি

  • downloadId

    নম্বর

    ডাউনলোডের জন্য শনাক্তকারী।

  • বিকল্প

    GetFileIconOptions ঐচ্ছিক

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    (iconURL?: string) =& gt;void

    • iconURL

      স্ট্রিং ঐচ্ছিক

রিটার্ন

  • Promise<string | undefined>

    Chrome 96+

    একটি Promise রিটার্ন করে যা ডাউনলোডের প্রতিনিধিত্ব করে এমন একটি ছবির URL-এর সাথে সমাধান করে।

    Manifest V3 ও তার পরবর্তী ভার্সনের ক্ষেত্রেই শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হয়।

open()

প্রতিশ্রুতি
chrome.downloads.open(
  downloadId: number,
  callback?: function,
)
: Promise<void>

DownloadItem সম্পূর্ণ হলে, ডাউনলোড করা ফাইলটি এখন খোলে; অন্যথায় runtime.lastError-এর মাধ্যমে একটি সমস্যা দেখায়। এই পদ্ধতির জন্য "downloads" অনুমতির পাশাপাশি "downloads.open" অনুমতিও প্রয়োজন। আইটেমটি প্রথমবার খোলা হলে একটি onChanged ইভেন্ট ফায়ার হয়। এই পদ্ধতিটি শুধুমাত্র ইউজার জেসচারের উত্তরে কল করা যেতে পারে।

প্যারামিটারগুলি

  • downloadId

    নম্বর

    ডাউনলোড করা ফাইলের শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    Chrome 123+

    callback প্যারামিটারটি দেখতে এমন:

    () =& gt;void

রিটার্ন

  • Promise<void>

    Chrome 123+

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

pause()

প্রতিশ্রুতি
chrome.downloads.pause(
  downloadId: number,
  callback?: function,
)
: Promise<void>

ডাউনলোড পজ করুন। অনুরোধটি সফল হলে ডাউনলোড পজ করা অবস্থায় থাকে। অন্যথায়, runtime.lastError-এ সমস্যার মেসেজ থাকে। ডাউনলোড অ্যাক্টিভ না থাকলে অনুরোধ করা যাবে না।

প্যারামিটারগুলি

  • downloadId

    নম্বর

    ডাউনলোড পজ করার আইডি।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    () =& gt;void

রিটার্ন

  • Promise<void>

    Chrome 96+

    পজ করার অনুরোধ সম্পূর্ণ হলে একটি প্রমিস রিটার্ন করে।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

removeFile()

প্রতিশ্রুতি
chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
)
: Promise<void>

ডাউনলোড করা ফাইলটি থাকলে এবং DownloadItem সম্পূর্ণ হলে সেটি সরান; অন্যথায় runtime.lastError-এর মাধ্যমে একটি সমস্যা রিটার্ন করুন।

প্যারামিটারগুলি

  • downloadId

    নম্বর

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    () =& gt;void

রিটার্ন

  • Promise<void>

    Chrome 96+

    Manifest V3 ও তার পরবর্তী ভার্সনের ক্ষেত্রেই শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হয়।

resume()

প্রতিশ্রুতি
chrome.downloads.resume(
  downloadId: number,
  callback?: function,
)
: Promise<void>

পজ করা ডাউনলোড আবার শুরু করুন। অনুরোধ সফল হলে, ডাউনলোড প্রসেস শুরু হয়ে যাবে এবং পজ করা থাকবে না। অন্যথায় runtime.lastError-এ একটি সমস্যার মেসেজ থাকে। ডাউনলোড অ্যাক্টিভ না থাকলে অনুরোধটি সম্পূর্ণ হবে না।

প্যারামিটারগুলি

  • downloadId

    নম্বর

    ডাউনলোড আবার শুরু করার আইডি।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    () =& gt;void

রিটার্ন

  • Promise<void>

    Chrome 96+

    রিজিউম করার অনুরোধ সম্পূর্ণ হলে, একটি Promise রিটার্ন করে যা সমাধান করা হয়।

    Manifest V3 ও তার পরবর্তী ভার্সনের ক্ষেত্রেই শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হয়।

প্রতিশ্রুতি
chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
)
: Promise<DownloadItem[]>

DownloadItem খুঁজুন। সব DownloadItem পেতে খালি অবজেক্টে query সেট করুন। নির্দিষ্ট DownloadItem পেতে, শুধুমাত্র id ফিল্ড সেট করুন। অনেক আইটেম আছে এমন পৃষ্ঠার ক্ষেত্রে, orderBy: ['-startTime'] সেট করুন, প্রতিটি পৃষ্ঠায় আইটেমের সংখ্যার জন্য limit সেট করুন এবং শেষ পৃষ্ঠার শেষ আইটেমের startTime-এর জন্য startedAfter সেট করুন।

প্যারামিটারগুলি

  • কোয়েরি
  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    (results: DownloadItem[]) =& gt;void

রিটার্ন

  • Promise<DownloadItem[]>

    Chrome 96+

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

setShelfEnabled()

Chrome 117 থেকে বন্ধ করা হয়েছে
chrome.downloads.setShelfEnabled(
  enabled: boolean,
)
: void

এর পরিবর্তে setUiOptions ব্যবহার করুন।

বর্তমান ব্রাউজার প্রোফাইলের সাথে যুক্ত প্রতিটি উইন্ডোর নিচে ধূসর শেল্ফ চালু বা বন্ধ করুন। অন্তত একটি এক্সটেনশন বন্ধ করে দিলে, শেল্ফ বন্ধ হয়ে যাবে। অন্তত একটি এক্সটেনশন বন্ধ করে দেওয়ার পরে শেল্ফ চালু করলে runtime.lastError-এর মাধ্যমে একটি সমস্যা দেখানো হবে। "downloads" অনুমতির সাথে "downloads.shelf" অনুমতিও প্রয়োজন।

প্যারামিটারগুলি

  • সক্ষমিত

    বুলিয়ান

setUiOptions()

প্রতিশ্রুতি Chrome 105+
chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
)
: Promise<void>

বর্তমান ব্রাউজার প্রোফাইলের সাথে যুক্ত প্রতিটি উইন্ডোর ডাউনলোড UI পরিবর্তন করুন। অন্তত একটি এক্সটেনশন UiOptions.enabled-এর মান false সেট করে রাখলে, ডাউনলোড UI লুকানো থাকবে। অন্তত একটি এক্সটেনশন UiOptions.enabled-কে বন্ধ করে দিলে, সেটিকে true-তে সেট করলে runtime.lastError-এর মাধ্যমে একটি সমস্যা দেখাবে। "downloads" অনুমতির সাথে "downloads.ui" অনুমতিও প্রয়োজন।

প্যারামিটারগুলি

  • বিকল্প

    ডাউনলোড UI-তে পরিবর্তন এনক্যাপসুলেট করুন।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম:

    () =& gt;void

রিটার্ন

  • Promise<void>

    UI আপডেট সম্পূর্ণ হলে একটি প্রমিস রিটার্ন করে।

    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) =& gt;void

onCreated

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

ডাউনলোড শুরু হলে, এই ইভেন্ট DownloadItem অবজেক্টের সাথে ফায়ার হয়।

প্যারামিটারগুলি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এমন:

    (downloadItem: DownloadItem) =& gt;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-এর মাধ্যমে ডাউনলোড শুরু করা হলে এবং MIME-এর ধরন ও সম্ভাব্য ফাইলের নাম নির্ধারণ করার আগেই টার্গেট ফাইলের নাম জানা থাকলে, download-এ filename পাস করুন।

প্যারামিটারগুলি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এমন:

    (downloadItem: DownloadItem, suggest: function) =& gt;void

    • downloadItem
    • সাজেস্ট করুন

      ফাংশন

      suggest প্যারামিটারটি দেখতে এমন:

      (suggestion?: FilenameSuggestion) =& gt;void

onErased

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

ইতিহাস থেকে কোনও ডাউনলোড মুছে ফেলা হলে downloadId সহ ফায়ার করে।

প্যারামিটারগুলি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম:

    (downloadId: number) =& gt;void

    • downloadId

      নম্বর