browser.downloads

বিবরণ

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

অনুমতি

downloads

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

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

উদাহরণ

আপনি examples/api/downloads ডিরেক্টরিতে browser.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+ Chrome 148 থেকে browser.*

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

• id

  নম্বর

  DownloadItem-এর id যা পরিবর্তন করা হয়েছে।

• মূকাভিনয়

  StringDelta ঐচ্ছিক

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

• সাময়িক ভাবে থামানো হয়েছে

  BooleanDelta ঐচ্ছিক

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

• startTime

  StringDelta ঐচ্ছিক

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

• রাজ্য

  StringDelta ঐচ্ছিক

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

• totalBytes

  DoubleDelta ঐচ্ছিক

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

• URL

  StringDelta ঐচ্ছিক

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

DownloadItem

প্রপার্টি

• byExtensionId

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

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

• byExtensionName

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

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

• bytesReceived

  নম্বর

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

• canResume

  বুলিয়ান

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

• বিপদ

  DangerType

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

• 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+ Chrome 148 থেকে browser.*

  সব রিডাইরেক্টের পরে, এই ডাউনলোড যে URL থেকে করা হচ্ছে তার সম্পূর্ণ 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 ফর্ম্যাটে প্রদত্ত মিলি সেকেন্ডের পরে শেষ হওয়া DownloadItem-এ ফলাফল সীমিত করে

• endedBefore

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

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

• সমস্যা

  InterruptReason ঐচ্ছিক

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

• এগজিস্টস

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

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

• fileSize

  নম্বর ঐচ্ছিক

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

• ফাইলের নাম

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

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

• filenameRegex

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

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

• finalUrl

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

  Chrome 54+ Chrome 148 থেকে browser.*

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

• finalUrlRegex

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

  Chrome 54+ Chrome 148 থেকে browser.*

  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 ফর্ম্যাটে প্রদত্ত ms-এর পরে শুরু হওয়া 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

প্রপার্টি

• সাইজ

  নম্বর ঐচ্ছিক

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

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+ Chrome 148 থেকে browser.*

প্রপার্টি

• সক্ষমিত

  বুলিয়ান

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

পদ্ধতি

acceptDanger()

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

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

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

• downloadId

  নম্বর

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

রিটার্ন

• <void> প্রমিস

  Chrome 96+ Chrome 148 থেকে browser.*

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

cancel()

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

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

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

• downloadId

  নম্বর

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

রিটার্ন

• <void> প্রমিস

  Chrome 96+ Chrome 148 থেকে browser.*

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

download()

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

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

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

• বিকল্প

  DownloadOptions

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

রিটার্ন

• Promise<number>

  Chrome 96+ Chrome 148 থেকে browser.*

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

erase()

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

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

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

• কোয়েরি

  DownloadQuery

রিটার্ন

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

  Chrome 96+ Chrome 148 থেকে browser.*

getFileIcon()

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

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

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

• downloadId

  নম্বর

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

• বিকল্প

  GetFileIconOptions ঐচ্ছিক

রিটার্ন

• Promise<string | undefined>

  Chrome 96+ Chrome 148 থেকে browser.*

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

open()

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

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

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

• downloadId

  নম্বর

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

রিটার্ন

• <void> প্রমিস

  Chrome 123+ ব্রাউজার।* Chrome 148 থেকে

pause()

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

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

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

• downloadId

  নম্বর

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

রিটার্ন

• <void> প্রমিস

  Chrome 96+ Chrome 148 থেকে browser.*

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

removeFile()

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

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

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

• downloadId

  নম্বর

রিটার্ন

• <void> প্রমিস

  Chrome 96+ Chrome 148 থেকে browser.*

resume()

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

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

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

• downloadId

  নম্বর

  যে ডাউনলোড আবার শুরু করতে হবে সেটির আইডি।

রিটার্ন

• <void> প্রমিস

  Chrome 96+ Chrome 148 থেকে browser.*

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

search()

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

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

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

• কোয়েরি

  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>

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

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

• বিকল্প

  UiOptions

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

রিটার্ন

• <void> প্রমিস

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

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 অটোমেটিক কল করা হবে। সব শ্রোতা suggest-এ কল না করা পর্যন্ত DownloadItem সম্পূর্ণ হবে না। ডাউনলোড করা ফাইলটির নাম downloadItem.filename হিসেবে ব্যবহার করার অনুমতি দিতে, লিসেনার কোনও আর্গুমেন্ট ছাড়াই suggest কল করতে পারেন অথবা টার্গেট ফাইলের নাম ওভাররাইড করতে suggest-এ একটি suggestion অবজেক্ট পাস করতে পারেন। একাধিক এক্সটেনশন ফাইলের নাম ওভাররাইড করলে, শেষ যে এক্সটেনশনটি ইনস্টল করা হয়েছে এবং যার লিসেনার suggest-এ suggestion অবজেক্ট পাস করে, সেটিই কার্যকর হয়। কোন এক্সটেনশনটি জিতবে তা নিয়ে বিভ্রান্তি এড়াতে, ব্যবহারকারীদের এমন এক্সটেনশন ইনস্টল করা উচিত নয় যা একে অপরের সাথে বিরোধ করতে পারে। download-এর মাধ্যমে ডাউনলোড শুরু করা হলে এবং MIME-এর ধরন ও সম্ভাব্য ফাইলের নাম নির্ধারণ করার আগে টার্গেট ফাইলের নাম জানা থাকলে, পরিবর্তে 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

    নম্বর