ব্রাউজার.রিডিংলিস্ট

বর্ণনা

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

অনুমতি

readingList

রিডিং লিস্ট এপিআই ব্যবহার করতে, এক্সটেনশন ম্যানিফেস্ট ফাইলে "readingList" পারমিশনটি যোগ করুন:

manifest.json:

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

উপলব্ধতা

ক্রোম ১২০+ এমভি৩+

ক্রোমের সাইড প্যানেলে একটি রিডিং লিস্ট রয়েছে। এটি ব্যবহারকারীদের পরে পড়ার জন্য বা অফলাইনে পড়ার জন্য ওয়েব পেজ সংরক্ষণ করতে দেয়। বিদ্যমান আইটেমগুলো খুঁজে বের করতে এবং তালিকা থেকে আইটেম যোগ বা অপসারণ করতে রিডিং লিস্ট এপিআই (Reading List API) ব্যবহার করুন।

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

ধারণা এবং ব্যবহার

আইটেম অর্ডার করা

পঠন তালিকার বিষয়গুলো কোনো নির্দিষ্ট ক্রমে সাজানো নেই।

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

আইটেমগুলো URL দ্বারা চিহ্নিত করা হয়। এর মধ্যে হ্যাশ এবং কোয়েরি স্ট্রিং অন্তর্ভুক্ত থাকে।

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

নিম্নলিখিত বিভাগগুলিতে রিডিং লিস্ট এপিআই-এর কিছু সাধারণ ব্যবহার দেখানো হয়েছে। এক্সটেনশনের সম্পূর্ণ উদাহরণের জন্য এক্সটেনশন স্যাম্পলগুলি দেখুন।

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

পঠন তালিকায় কোনো আইটেম যোগ করতে, 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() ব্যবহার করতে পারেন। নিম্নলিখিত কোডটি একটি আইটেমকে পঠিত হিসেবে চিহ্নিত করে:

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

একটি আইটেম সরান

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

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

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

রিডিং লিস্ট এপিআই এক্সটেনশনের আরও ডেমো দেখতে, রিডিং লিস্ট এপিআই স্যাম্পলটি দেখুন।

প্রকারভেদ

AddEntryOptions

বৈশিষ্ট্য

  • পড়া হয়েছে

    বুলিয়ান

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

  • শিরোনাম

    স্ট্রিং

    এন্ট্রিটির শিরোনাম।

  • ইউআরএল

    স্ট্রিং

    এন্ট্রিটির ইউআরএল।

QueryInfo

বৈশিষ্ট্য

  • পড়া হয়েছে

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

    পঠিত ( true ) নাকি অপঠিত ( false ) আইটেম অনুসন্ধান করা হবে তা নির্দেশ করে।

  • শিরোনাম

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

    অনুসন্ধানের জন্য একটি শিরোনাম।

  • ইউআরএল

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

    অনুসন্ধান করার জন্য একটি ইউআরএল।

ReadingListEntry

বৈশিষ্ট্য

  • সৃষ্টির সময়

    সংখ্যা

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

  • পড়া হয়েছে

    বুলিয়ান

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

  • শেষ আপডেটের সময়

    সংখ্যা

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

  • শিরোনাম

    স্ট্রিং

    এন্ট্রিটির শিরোনাম।

  • ইউআরএল

    স্ট্রিং

    এন্ট্রিটির ইউআরএল।

RemoveOptions

বৈশিষ্ট্য

  • ইউআরএল

    স্ট্রিং

    যে ইউআরএলটি সরাতে হবে।

UpdateEntryOptions

বৈশিষ্ট্য

  • পড়া হয়েছে

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

    হালনাগাদকৃত পঠিত অবস্থা। কোনো মান প্রদান করা না হলে বিদ্যমান অবস্থাটিই থাকবে।

  • শিরোনাম

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

    নতুন শিরোনাম। কোনো মান প্রদান করা না হলে বিদ্যমান শিরোনামটিই থাকবে।

  • ইউআরএল

    স্ট্রিং

    যে ইউআরএলটি আপডেট করা হবে।

পদ্ধতি

addEntry()

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

পঠন তালিকায় না থাকলে একটি নতুন বিষয় যোগ করে।

প্যারামিটার

ফেরত

  • প্রতিশ্রুতি<শূন্য>

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

query()

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

QueryInfo প্রোপার্টিগুলোর সাথে মেলে এমন সমস্ত এন্ট্রি পুনরুদ্ধার করে। যে প্রোপার্টিগুলো প্রদান করা হয়নি, সেগুলো মেলানো হবে না।

প্যারামিটার

ফেরত

removeEntry()

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

পঠন তালিকায় কোনো এন্ট্রি বিদ্যমান থাকলে তা মুছে দেয়।

প্যারামিটার

  • পঠন তালিকা থেকে অপসারণ করার জন্য এন্ট্রিটি।

ফেরত

  • প্রতিশ্রুতি<শূন্য>

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

updateEntry()

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

পঠন তালিকার কোনো এন্ট্রি বিদ্যমান থাকলে তা আপডেট করে।

প্যারামিটার

ফেরত

  • প্রতিশ্রুতি<শূন্য>

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

ইভেন্টগুলি

onEntryAdded

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

পঠন তালিকায় কোনো ReadingListEntry যুক্ত হলে এটি সক্রিয় হয়।

প্যারামিটার

onEntryRemoved

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

পঠন তালিকা থেকে কোনো ReadingListEntry মুছে ফেলা হলে এটি সক্রিয় হয়।

প্যারামিটার

onEntryUpdated

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

পঠন তালিকায় কোনো ReadingListEntry আপডেট করা হলে এটি সক্রিয় হয়।

প্যারামিটার