browser.readingList

বিবরণ

পড়ার তালিকা থেকে আইটেম পড়তে ও পরিবর্তন করতে chrome.readingList API ব্যবহার করুন।

অনুমতি

readingList

Reading List API ব্যবহার করতে, এক্সটেনশন ম্যানিফেস্ট ফাইলে "readingList" অনুমতি যোগ করুন:

manifest.json:

{
  "name": "My reading list extension",
  ...
  "permissions": [
    "readingList"
  ]
}

উপলভ্যতা

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

Chrome-এর সাইড প্যানেলে একটি পড়ার তালিকা আছে। এটি ব্যবহারকারীদের পরে বা অফলাইনে পড়ার জন্য ওয়েব পৃষ্ঠা সেভ করতে দেয়। আগে থেকে থাকা আইটেম ফিরিয়ে আনতে এবং তালিকা থেকে আইটেম যোগ করতে বা সরাতে Reading List API ব্যবহার করুন।

পড়ার তালিকায় বেশ কিছু নিবন্ধ দেখানো হচ্ছে

ধারণা ও ব্যবহার

আইটেম ক্রমানুযায়ী সাজানো

পড়ার তালিকায় আইটেমগুলি কোনও নির্দিষ্ট ক্রমে থাকে না।

আইটেমের অনন্যতা

URL-এর মাধ্যমে আইটেম কী করা হয়। এর মধ্যে হ্যাশ ও কোয়েরি স্ট্রিং অন্তর্ভুক্ত।

যেসব ক্ষেত্রে ব্যবহার করা যাবে

নিচের বিভাগগুলি Reading List API-এর কিছু সাধারণ ব্যবহারের উদাহরণ দেখায়। সম্পূর্ণ এক্সটেনশনের উদাহরণ দেখতে এক্সটেনশনের স্যাম্পেল দেখুন।

আইটেম যোগ করুন

পড়ার তালিকায় কোনও আইটেম যোগ করতে, browser.readingList.addEntry() ব্যবহার করুন:

browser.readingList.addEntry({
  title: "New to the web platform in September | web.dev",
  url: "https://developer.chrome.com/",
  hasBeenRead: false
});

আইটেম দেখান

রিডিং লিস্ট থেকে আইটেম দেখাতে, সেগুলি ফিরিয়ে আনতে browser.readingList.query() পদ্ধতি ব্যবহার করুন। পদ্ধতি।

const items = await browser.readingList.query({});

for (const item of items) {
  // Do something do display the item
}

কোনও আইটেম 'পড়া হয়েছে' হিসেবে চিহ্নিত করা

আপনি browser.readingList.updateEntry() ব্যবহার করে শীর্ষক, URL ও পড়ার স্ট্যাটাস আপডেট করতে পারবেন। নিম্নলিখিত কোড কোনও আইটেমকে 'পড়া হয়েছে' হিসেবে চিহ্নিত করে:

browser.readingList.updateEntry({
  url: "https://developer.chrome.com/",
  hasBeenRead: true
});

কোনও আইটেম সরানো

কোনও আইটেম সরাতে, browser.readingList.removeEntry() ব্যবহার করুন:

browser.readingList.removeEntry({
  url: "https://developer.chrome.com/"
});

এক্সটেনশনের নমুনা

আরও Reading List API এক্সটেনশন ডেমোর জন্য, Reading List API স্যাম্পেল দেখুন।

ধরন

AddEntryOptions

প্রপার্টি

• hasBeenRead

  বুলিয়ান

  এন্ট্রি পড়া হয়ে গেলে true হবে।

• শীর্ষক

  স্ট্রিং

  এন্ট্রির শীর্ষক।

• URL

  স্ট্রিং

  এন্ট্রির URL।

QueryInfo

প্রপার্টি

• hasBeenRead

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

  পড়া (true) বা না পড়া (false) আইটেম সার্চ করতে হবে কিনা তা নির্দেশ করে।

• শীর্ষক

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

  সার্চ করার জন্য শীর্ষক।

• URL

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

  সার্চ করার জন্য একটি URL।

ReadingListEntry

প্রপার্টি

• creationTime

  নম্বর

  যে সময়ে এন্ট্রি তৈরি করা হয়েছে। ১ জানুয়ারি, ১৯৭০ থেকে মিলিসেকেন্ডে রেকর্ড করা হয়েছে।

• hasBeenRead

  বুলিয়ান

  এন্ট্রি পড়া হয়ে গেলে true হবে।

• lastUpdateTime

  নম্বর

  শেষবার যখন এন্ট্রি আপডেট করা হয়েছিল। এই ভ্যালু ১ জানুয়ারি, ১৯৭০ থেকে মিলিসেকেন্ডে হিসেব করা হয়।

• শীর্ষক

  স্ট্রিং

  এন্ট্রির শীর্ষক।

• URL

  স্ট্রিং

  এন্ট্রির URL।

RemoveOptions

প্রপার্টি

• URL

  স্ট্রিং

  যে URL সরাতে হবে।

UpdateEntryOptions

প্রপার্টি

• hasBeenRead

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

  আপডেট করা রিড স্ট্যাটাস। কোনও ভ্যালু প্রদান করা না হলে, বর্তমান স্ট্যাটাসই থেকে যায়।

• শীর্ষক

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

  নতুন শীর্ষক। কোনও ভ্যালু না দেওয়া হলে, আগে থেকে থাকা টাইলটিই থেকে যায়।

• URL

  স্ট্রিং

  যে URL আপডেট করা হবে।

পদ্ধতি

addEntry()

browser.readingList.addEntry(
  entry: AddEntryOptions,
): Promise<void>

পড়ার তালিকায় কোনও এন্ট্রি না থাকলে, সেটি যোগ করে।

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

• এন্ট্রি

  AddEntryOptions

  পড়ার তালিকায় যোগ করার জন্য এন্ট্রি।

রিটার্ন

• <void> প্রমিস

  এন্ট্রি যোগ করা হয়ে গেলে সমাধান হয়ে যায়।

query()

browser.readingList.query(
  info: QueryInfo,
): Promise<ReadingListEntry[]>

QueryInfo প্রপার্টির সাথে মেলে এমন সব এন্ট্রি রিট্রিভ করে। যেসব প্রপার্টি প্রদান করা হয়নি সেগুলি ম্যাচ করা হবে না।

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

• তথ্য

  QueryInfo

  যেসব প্রপার্টি সার্চ করতে হবে।

রিটার্ন

• Promise<ReadingListEntry[]>

  এন্ট্রিগুলি মিলে গেলে সমাধান হয়ে যায়।

removeEntry()

browser.readingList.removeEntry(
  info: RemoveOptions,
): Promise<void>

রিডিং লিস্টে কোনও এন্ট্রি থাকলে তা সরিয়ে দেয়।

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

• তথ্য

  RemoveOptions

  পড়ার তালিকা থেকে সরানোর জন্য এন্ট্রি।

রিটার্ন

• <void> প্রমিস

  এন্ট্রি সরিয়ে দেওয়া হলে সমস্যার সমাধান হয়ে যায়।

updateEntry()

browser.readingList.updateEntry(
  info: UpdateEntryOptions,
): Promise<void>

রিডিং লিস্ট এন্ট্রি থাকলে তা আপডেট করে।

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

• তথ্য

  UpdateEntryOptions

  আপডেট করার জন্য এন্ট্রি।

রিটার্ন

• <void> প্রমিস

  মিলে যাওয়া এন্ট্রি আপডেট করা হয়ে গেলে সমাধান হয়ে যায়।

ইভেন্ট

onEntryAdded

browser.readingList.onEntryAdded.addListener(
  callback: function,
)

পড়ার তালিকায় ReadingListEntry যোগ করা হলে ট্রিগার করা হয়।

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

• কলব্যাক

  ফাংশন

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

  (entry: ReadingListEntry) => void

  • এন্ট্রি

    ReadingListEntry

onEntryRemoved

browser.readingList.onEntryRemoved.addListener(
  callback: function,
)

পড়ার তালিকা থেকে ReadingListEntry সরানো হলে ট্রিগার করা হয়।

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

• কলব্যাক

  ফাংশন

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

  (entry: ReadingListEntry) => void

  • এন্ট্রি

    ReadingListEntry

onEntryUpdated

browser.readingList.onEntryUpdated.addListener(
  callback: function,
)

রিডিং লিস্টে ReadingListEntry আপডেট করা হলে ট্রিগার করা হয়।

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

• কলব্যাক

  ফাংশন

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

  (entry: ReadingListEntry) => void

  • এন্ট্রি

    ReadingListEntry