chrome.bookmarks

বর্ণনা

বুকমার্ক তৈরি করতে, সংগঠিত করতে এবং অন্যথায় ম্যানিপুলেট করতে chrome.bookmarks API ব্যবহার করুন৷ এছাড়াও ওভাররাইড পৃষ্ঠাগুলি দেখুন, যা আপনি একটি কাস্টম বুকমার্ক ম্যানেজার পৃষ্ঠা তৈরি করতে ব্যবহার করতে পারেন৷

তারকা ক্লিক করা একটি বুকমার্ক যোগ করে
তারকা ক্লিক করা একটি বুকমার্ক যোগ করে।

অনুমতি

bookmarks

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

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

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

বস্তু এবং বৈশিষ্ট্য

বুকমার্কগুলি একটি গাছে সংগঠিত হয়, যেখানে গাছের প্রতিটি নোড হয় একটি বুকমার্ক বা একটি ফোল্ডার (কখনও কখনও একটি গ্রুপ বলা হয়)। গাছের প্রতিটি নোড একটি বুকমার্কস দ্বারা উপস্থাপিত হয়৷BookmarkTreeNode অবজেক্ট৷

BookmarkTreeNode বৈশিষ্ট্যগুলি chrome.bookmarks API জুড়ে ব্যবহৃত হয়৷ উদাহরণস্বরূপ, আপনি যখন bookmarks.create কল করেন, তখন আপনি নতুন নোডের প্যারেন্ট ( parentId ), এবং ঐচ্ছিকভাবে, নোডের index , title এবং url বৈশিষ্ট্যগুলি পাস করেন৷ একটি নোডের বৈশিষ্ট্যগুলি সম্পর্কে তথ্যের জন্য bookmarks.BookmarkTreeNode দেখুন৷

উদাহরণ

নিম্নলিখিত কোডটি "এক্সটেনশন বুকমার্কস" শিরোনাম সহ একটি ফোল্ডার তৈরি করে। create() প্রথম আর্গুমেন্ট নতুন ফোল্ডারের জন্য বৈশিষ্ট্য নির্দিষ্ট করে। দ্বিতীয় যুক্তিটি ফোল্ডারটি তৈরি হওয়ার পরে কার্যকর করার জন্য একটি ফাংশন সংজ্ঞায়িত করে।

chrome.bookmarks.create(
  {'parentId': bookmarkBar.id, 'title': 'Extension bookmarks'},
  function(newFolder) {
    console.log("added folder: " + newFolder.title);
  },
);

পরবর্তী স্নিপেটটি এক্সটেনশনের জন্য বিকাশকারী ডকুমেন্টেশনের দিকে নির্দেশ করে একটি বুকমার্ক তৈরি করে। যেহেতু বুকমার্ক তৈরি করা ব্যর্থ হলে খারাপ কিছুই ঘটবে না, এই কোডটি একটি কলব্যাক ফাংশন সংজ্ঞায়িত করতে বিরক্ত করে না।

chrome.bookmarks.create({
  'parentId': extensionsFolderId,
  'title': 'Extensions doc',
  'url': 'https://developer.chrome.com/docs/extensions',
});

এই APIটি চেষ্টা করতে, chrome-extension-samples repository থেকে Bookmarks API উদাহরণটি ইনস্টল করুন৷

প্রকারভেদ

BookmarkTreeNode

বুকমার্ক ট্রিতে একটি নোড (হয় একটি বুকমার্ক বা একটি ফোল্ডার)। চাইল্ড নোডগুলি তাদের মূল ফোল্ডারের মধ্যে অর্ডার করা হয়।

বৈশিষ্ট্য

  • শিশুদের

    BookmarkTreeNode [] ঐচ্ছিক

    এই নোডের শিশুদের একটি আদেশকৃত তালিকা।

  • তারিখ যোগ করা হয়েছে

    সংখ্যা ঐচ্ছিক

    যখন এই নোডটি তৈরি করা হয়েছিল, তখন যুগ থেকে মিলিসেকেন্ডে ( new Date(dateAdded) )।

  • dateGroupmodified

    সংখ্যা ঐচ্ছিক

    যখন এই ফোল্ডারের বিষয়বস্তু শেষবার পরিবর্তিত হয়, তখন থেকে মিলিসেকেন্ডে।

  • তারিখ সর্বশেষ ব্যবহার করা হয়েছে

    সংখ্যা ঐচ্ছিক

    Chrome 114+

    যখন এই নোডটি শেষবার খোলা হয়েছিল, তখন থেকে মিলিসেকেন্ডে। ফোল্ডারের জন্য সেট করা নেই।

  • ফোল্ডার প্রকার

    FolderType ঐচ্ছিক

    Chrome 134+

    যদি উপস্থিত থাকে, এটি একটি ফোল্ডার যা ব্রাউজার দ্বারা যোগ করা হয় এবং ব্যবহারকারী বা এক্সটেনশন দ্বারা পরিবর্তন করা যায় না। চাইল্ড নোড সংশোধন করা যেতে পারে, যদি এই নোডে unmodifiable সম্পত্তি সেট না থাকে। ব্যবহারকারী এবং এক্সটেনশন (ডিফল্ট) দ্বারা নোড পরিবর্তন করা গেলে বাদ দেওয়া হয়।

    প্রতিটি ফোল্ডার প্রকারের শূন্য, এক বা একাধিক নোড থাকতে পারে। একটি ফোল্ডার ব্রাউজার দ্বারা যোগ বা সরানো হতে পারে, কিন্তু এক্সটেনশন API এর মাধ্যমে নয়।

  • আইডি

    স্ট্রিং

    নোডের অনন্য শনাক্তকারী। আইডিগুলি বর্তমান প্রোফাইলের মধ্যে অনন্য, এবং ব্রাউজার পুনরায় চালু হওয়ার পরেও তারা বৈধ থাকে৷

  • সূচক

    সংখ্যা ঐচ্ছিক

    এই নোডের মূল ফোল্ডারের মধ্যে 0-ভিত্তিক অবস্থান।

  • parentId

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

    মূল ফোল্ডারের id । রুট নোডের জন্য বাদ দেওয়া হয়েছে।

  • সিঙ্ক করা

    বুলিয়ান

    Chrome 134+

    এই নোডটি ব্রাউজার দ্বারা ব্যবহারকারীর রিমোট অ্যাকাউন্ট স্টোরেজের সাথে সিঙ্ক করা হয়েছে কিনা। এটি একই FolderType অ্যাকাউন্ট এবং শুধুমাত্র স্থানীয় সংস্করণগুলির মধ্যে পার্থক্য করতে ব্যবহার করা যেতে পারে। এই সম্পত্তির মান একটি বিদ্যমান নোডের জন্য পরিবর্তিত হতে পারে, উদাহরণস্বরূপ ব্যবহারকারীর কর্মের ফলে।

    দ্রষ্টব্য: এটি প্রতিফলিত করে যে নোডটি ব্রাউজারের অন্তর্নির্মিত অ্যাকাউন্ট প্রদানকারীতে সংরক্ষণ করা হয়েছে কিনা। এটি সম্ভব যে একটি নোড তৃতীয় পক্ষের মাধ্যমে সিঙ্ক করা যেতে পারে, এমনকি যদি এই মানটি মিথ্যা হয়।

    পরিচালিত নোডের জন্য (নোড যেখানে unmodifiable true সেট করা হয়), এই সম্পত্তি সর্বদা false হবে।

  • শিরোনাম

    স্ট্রিং

    নোডের জন্য প্রদর্শিত পাঠ্য।

  • অপরিবর্তনীয়

    "পরিচালিত"
    ঐচ্ছিক

    এই নোডটি পরিবর্তনযোগ্য না হওয়ার কারণ নির্দেশ করে। managed মান নির্দেশ করে যে এই নোডটি সিস্টেম অ্যাডমিনিস্ট্রেটর বা তত্ত্বাবধানে থাকা ব্যবহারকারীর কাস্টোডিয়ান দ্বারা কনফিগার করা হয়েছে। ব্যবহারকারী এবং এক্সটেনশন (ডিফল্ট) দ্বারা নোড পরিবর্তন করা গেলে বাদ দেওয়া হয়।

  • url

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

    কোনো ব্যবহারকারী বুকমার্কে ক্লিক করলে URL নেভিগেট হয়। ফোল্ডারগুলির জন্য বাদ দেওয়া হয়েছে৷

BookmarkTreeNodeUnmodifiable

Chrome 44+

এই নোডটি পরিবর্তনযোগ্য না হওয়ার কারণ নির্দেশ করে। managed মান নির্দেশ করে যে এই নোডটি সিস্টেম অ্যাডমিনিস্ট্রেটর দ্বারা কনফিগার করা হয়েছে। ব্যবহারকারী এবং এক্সটেনশন (ডিফল্ট) দ্বারা নোড পরিবর্তন করা গেলে বাদ দেওয়া হয়।

মান

"পরিচালিত"

CreateDetails

সৃষ্টি() ফাংশনে অবজেক্ট পাস করা হয়েছে।

বৈশিষ্ট্য

  • সূচক

    সংখ্যা ঐচ্ছিক

  • প্যারেন্টআইডি

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

    অন্যান্য বুকমার্ক ফোল্ডারে ডিফল্ট।

  • শিরোনাম

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

  • url

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

FolderType

Chrome 134+

ফোল্ডারের ধরন নির্দেশ করে।

এনাম

"বুকমার্ক-বার"
যে ফোল্ডারের বিষয়বস্তু ব্রাউজার উইন্ডোর উপরে প্রদর্শিত হয়।

"অন্য"
বুকমার্ক যা সমস্ত প্ল্যাটফর্মে বুকমার্কের সম্পূর্ণ তালিকায় প্রদর্শিত হয়৷

"মোবাইল"
বুকমার্কগুলি সাধারণত ব্যবহারকারীর মোবাইল ডিভাইসে উপলব্ধ, তবে এক্সটেনশন বা বুকমার্ক ম্যানেজারে পরিবর্তনযোগ্য৷

"পরিচালিত"
একটি শীর্ষ-স্তরের ফোল্ডার যা উপস্থিত হতে পারে যদি সিস্টেম অ্যাডমিনিস্ট্রেটর বা তত্ত্বাবধানে থাকা ব্যবহারকারীর কাস্টোডিয়ান বুকমার্কগুলি কনফিগার করে থাকে৷

বৈশিষ্ট্য

MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE

অবচয়

বুকমার্ক লেখার ক্রিয়াকলাপগুলি আর Chrome দ্বারা সীমাবদ্ধ নয়৷

মান

1000000

MAX_WRITE_OPERATIONS_PER_HOUR

অবচয়

বুকমার্ক লেখার ক্রিয়াকলাপগুলি আর Chrome দ্বারা সীমাবদ্ধ নয়৷

মান

1000000

পদ্ধতি

create()

chrome.bookmarks.create(
  bookmark: CreateDetails,
): Promise<BookmarkTreeNode>

নির্দিষ্ট প্যারেন্টআইডির অধীনে একটি বুকমার্ক বা ফোল্ডার তৈরি করে। url NULL বা অনুপস্থিত হলে, এটি একটি ফোল্ডার হবে।

পরামিতি

রিটার্নস

get()

chrome.bookmarks.get(
  idOrIdList: string | [string, ...string[]],
): Promise<BookmarkTreeNode[]>

নির্দিষ্ট BookmarkTreeNode(গুলি) উদ্ধার করে।

পরামিতি

  • idOrIdList

    স্ট্রিং | [স্ট্রিং, ...স্ট্রিং[]]

    একটি একক স্ট্রিং-মূল্যবান আইডি বা স্ট্রিং-মূল্যবান আইডিগুলির একটি অ্যারে৷

রিটার্নস

getChildren()

chrome.bookmarks.getChildren(
  id: string,
): Promise<BookmarkTreeNode[]>

নির্দিষ্ট BookmarkTreeNode আইডির বাচ্চাদের উদ্ধার করে।

পরামিতি

  • আইডি

    স্ট্রিং

রিটার্নস

getRecent()

chrome.bookmarks.getRecent(
  numberOfItems: number,
): Promise<BookmarkTreeNode[]>

সম্প্রতি যোগ করা বুকমার্ক পুনরুদ্ধার করে।

পরামিতি

  • সংখ্যার আইটেম

    সংখ্যা

    ফেরত দিতে আইটেম সর্বোচ্চ সংখ্যা.

রিটার্নস

getSubTree()

chrome.bookmarks.getSubTree(
  id: string,
): Promise<BookmarkTreeNode[]>

নির্দিষ্ট নোড থেকে শুরু করে বুকমার্কের অনুক্রমের অংশ পুনরুদ্ধার করে।

পরামিতি

  • আইডি

    স্ট্রিং

    সাবট্রির রুটের আইডি পুনরুদ্ধার করতে হবে।

রিটার্নস

getTree()

chrome.bookmarks.getTree(): Promise<BookmarkTreeNode[]>

পুরো বুকমার্কের অনুক্রম পুনরুদ্ধার করে।

রিটার্নস

move()

chrome.bookmarks.move(
  id: string,
  destination: object,
): Promise<BookmarkTreeNode>

নির্দিষ্ট বুকমার্কট্রিনোডকে প্রদত্ত অবস্থানে নিয়ে যায়।

পরামিতি

  • আইডি

    স্ট্রিং

  • গন্তব্য

    বস্তু

    • সূচক

      সংখ্যা ঐচ্ছিক

    • parentId

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

রিটার্নস

remove()

chrome.bookmarks.remove(
  id: string,
): Promise<void>

একটি বুকমার্ক বা একটি খালি বুকমার্ক ফোল্ডার সরান.

পরামিতি

  • আইডি

    স্ট্রিং

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 90+

removeTree()

chrome.bookmarks.removeTree(
  id: string,
): Promise<void>

পুনরাবৃত্তভাবে একটি বুকমার্ক ফোল্ডার সরিয়ে দেয়।

পরামিতি

  • আইডি

    স্ট্রিং

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 90+
chrome.bookmarks.search(
  query: string | object,
): Promise<BookmarkTreeNode[]>

প্রদত্ত ক্যোয়ারির সাথে মিলে যাওয়া BookmarkTreeNodes অনুসন্ধান করে। একটি বস্তুর সাথে নির্দিষ্ট করা প্রশ্নগুলি সমস্ত নির্দিষ্ট বৈশিষ্ট্যের সাথে মিলে BookmarkTreeNodes উৎপন্ন করে।

পরামিতি

  • প্রশ্ন

    স্ট্রিং | বস্তু

    হয় শব্দের একটি স্ট্রিং এবং উদ্ধৃত বাক্যাংশ যা বুকমার্ক URL এবং শিরোনামের সাথে মিলে যায়, অথবা একটি বস্তু। যদি একটি বস্তু, বৈশিষ্ট্য query , url , এবং title নির্দিষ্ট করা যেতে পারে এবং সমস্ত নির্দিষ্ট বৈশিষ্ট্যের সাথে মেলে বুকমার্ক উত্পাদিত হবে।

    • প্রশ্ন

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

      বুকমার্ক URL এবং শিরোনামের সাথে মিলে যাওয়া শব্দ এবং উদ্ধৃত বাক্যাংশের একটি স্ট্রিং৷

    • শিরোনাম

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

      বুকমার্কের শিরোনাম; শব্দার্থে মেলে।

    • url

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

      বুকমার্কের URL; শব্দার্থে মেলে। মনে রাখবেন যে ফোল্ডারগুলির কোন URL নেই।

রিটার্নস

update()

chrome.bookmarks.update(
  id: string,
  changes: object,
): Promise<BookmarkTreeNode>

বুকমার্ক বা ফোল্ডারের বৈশিষ্ট্য আপডেট করে। আপনি পরিবর্তন করতে চান শুধুমাত্র বৈশিষ্ট্য উল্লেখ করুন; অনির্দিষ্ট বৈশিষ্ট্য অপরিবর্তিত রাখা হবে. দ্রষ্টব্য: বর্তমানে, শুধুমাত্র 'শিরোনাম' এবং 'url' সমর্থিত।

পরামিতি

  • আইডি

    স্ট্রিং

  • পরিবর্তন

    বস্তু

    • শিরোনাম

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

    • url

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

রিটার্নস

ঘটনা

onChanged

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

একটি বুকমার্ক বা ফোল্ডার পরিবর্তন হলে বহিস্কার করা হয়। দ্রষ্টব্য: বর্তমানে, শুধুমাত্র শিরোনাম এবং url পরিবর্তনগুলি এটিকে ট্রিগার করে৷

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (id: string, changeInfo: object) => void

    • আইডি

      স্ট্রিং

    • তথ্য পরিবর্তন করুন

      বস্তু

      • শিরোনাম

        স্ট্রিং

      • url

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

onChildrenReordered

chrome.bookmarks.onChildrenReordered.addListener(
  callback: function,
)

UI-তে সাজানো অর্ডারের কারণে একটি ফোল্ডারের বাচ্চারা তাদের অর্ডার পরিবর্তন করলে বহিস্কার করা হয়। এটিকে সরানোর () ফলে বলা হয় না।

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (id: string, reorderInfo: object) => void

    • আইডি

      স্ট্রিং

    • তথ্য পুনঃক্রম

      বস্তু

      • চাইল্ড আইডি

        স্ট্রিং[]

onCreated

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

একটি বুকমার্ক বা ফোল্ডার তৈরি করা হলে বহিস্কার করা হয়।

পরামিতি

onImportBegan

chrome.bookmarks.onImportBegan.addListener(
  callback: function,
)

একটি বুকমার্ক আমদানি সেশন শুরু হলে বহিস্কার করা হয়৷ onImportEnded বহিস্কার না হওয়া পর্যন্ত ব্যয়বহুল পর্যবেক্ষকদের onCreated আপডেটগুলি উপেক্ষা করা উচিত। পর্যবেক্ষকদের এখনও অবিলম্বে অন্যান্য বিজ্ঞপ্তি পরিচালনা করা উচিত।

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

onImportEnded

chrome.bookmarks.onImportEnded.addListener(
  callback: function,
)

একটি বুকমার্ক আমদানি সেশন শেষ হলে বহিস্কার করা হয়৷

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

onMoved

chrome.bookmarks.onMoved.addListener(
  callback: function,
)

একটি বুকমার্ক বা ফোল্ডার একটি ভিন্ন মূল ফোল্ডারে সরানো হলে বহিস্কার করা হয়।

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (id: string, moveInfo: object) => void

    • আইডি

      স্ট্রিং

    • মুভ ইনফো

      বস্তু

      • সূচক

        সংখ্যা

      • পুরাতন সূচক

        সংখ্যা

      • oldParentId

        স্ট্রিং

      • parentId

        স্ট্রিং

onRemoved

chrome.bookmarks.onRemoved.addListener(
  callback: function,
)

একটি বুকমার্ক বা ফোল্ডার সরানো হলে বহিস্কার করা হয়. যখন একটি ফোল্ডার পুনরাবৃত্তভাবে মুছে ফেলা হয়, তখন ফোল্ডারের জন্য একটি একক বিজ্ঞপ্তি প্রকাশ করা হয় এবং এর বিষয়বস্তুর জন্য কোনটি নয়।

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (id: string, removeInfo: object) => void