এই অনুমতি একটি সতর্কতা ট্রিগার করে ।
বর্ণনা
বুকমার্ক তৈরি করতে, সংগঠিত করতে এবং অন্যথায় ম্যানিপুলেট করতে 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+যখন এই নোডটি শেষবার খোলা হয়েছিল, তখন থেকে মিলিসেকেন্ডে। ফোল্ডারের জন্য সেট করা নেই।
- আইডি
স্ট্রিং
নোডের অনন্য শনাক্তকারী। আইডিগুলি বর্তমান প্রোফাইলের মধ্যে অনন্য, এবং ব্রাউজার পুনরায় চালু হওয়ার পরেও তারা বৈধ থাকে৷
- সূচক
সংখ্যা ঐচ্ছিক
এই নোডের মূল ফোল্ডারের মধ্যে 0-ভিত্তিক অবস্থান।
- প্যারেন্টআইডি
স্ট্রিং ঐচ্ছিক
মূল ফোল্ডারের
id। রুট নোডের জন্য বাদ দেওয়া হয়েছে। - শিরোনাম
স্ট্রিং
নোডের জন্য প্রদর্শিত পাঠ্য।
- অপরিবর্তনীয়
"পরিচালিত"
ঐচ্ছিকএই নোডটি পরিবর্তনযোগ্য না হওয়ার কারণ নির্দেশ করে।
managedমান নির্দেশ করে যে এই নোডটি সিস্টেম অ্যাডমিনিস্ট্রেটর বা তত্ত্বাবধানে থাকা ব্যবহারকারীর কাস্টোডিয়ান দ্বারা কনফিগার করা হয়েছে। ব্যবহারকারী এবং এক্সটেনশন (ডিফল্ট) দ্বারা নোড পরিবর্তন করা গেলে বাদ দেওয়া হয়। - url
স্ট্রিং ঐচ্ছিক
কোনো ব্যবহারকারী বুকমার্কে ক্লিক করলে URL নেভিগেট হয়। ফোল্ডারগুলির জন্য বাদ দেওয়া হয়েছে৷
BookmarkTreeNodeUnmodifiable
এই নোডটি পরিবর্তনযোগ্য না হওয়ার কারণ নির্দেশ করে। managed মান নির্দেশ করে যে এই নোডটি সিস্টেম অ্যাডমিনিস্ট্রেটর দ্বারা কনফিগার করা হয়েছে। ব্যবহারকারী এবং এক্সটেনশন (ডিফল্ট) দ্বারা নোড পরিবর্তন করা গেলে বাদ দেওয়া হয়।
মান
"পরিচালিত"
CreateDetails
সৃষ্টি() ফাংশনে অবজেক্ট পাস করা হয়েছে।
বৈশিষ্ট্য
- সূচক
সংখ্যা ঐচ্ছিক
- প্যারেন্টআইডি
স্ট্রিং ঐচ্ছিক
অন্যান্য বুকমার্ক ফোল্ডারে ডিফল্ট।
- শিরোনাম
স্ট্রিং ঐচ্ছিক
- url
স্ট্রিং ঐচ্ছিক
বৈশিষ্ট্য
MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE
বুকমার্ক লেখার ক্রিয়াকলাপগুলি আর Chrome দ্বারা সীমাবদ্ধ নয়৷
মান
1000000
MAX_WRITE_OPERATIONS_PER_HOUR
বুকমার্ক লেখার ক্রিয়াকলাপগুলি আর Chrome দ্বারা সীমাবদ্ধ নয়৷
মান
1000000
পদ্ধতি
create()
chrome.bookmarks.create(
bookmark: CreateDetails,
callback?: function,
)
নির্দিষ্ট প্যারেন্টআইডির অধীনে একটি বুকমার্ক বা ফোল্ডার তৈরি করে। url NULL বা অনুপস্থিত হলে, এটি একটি ফোল্ডার হবে।
পরামিতি
- বুকমার্ক
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(result: BookmarkTreeNode) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode >
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
get()
chrome.bookmarks.get(
idOrIdList: string | [string, ...string[]],
callback?: function,
)
নির্দিষ্ট BookmarkTreeNode(গুলি) উদ্ধার করে।
পরামিতি
- idOrIdList
স্ট্রিং | [স্ট্রিং, ...স্ট্রিং[]]
একটি একক স্ট্রিং-মূল্যবান আইডি বা স্ট্রিং-মূল্যবান আইডিগুলির একটি অ্যারে৷
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(results: BookmarkTreeNode[]) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode []>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
getChildren()
chrome.bookmarks.getChildren(
id: string,
callback?: function,
)
নির্দিষ্ট BookmarkTreeNode আইডির বাচ্চাদের উদ্ধার করে।
পরামিতি
- আইডি
স্ট্রিং
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(results: BookmarkTreeNode[]) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode []>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
getRecent()
chrome.bookmarks.getRecent(
numberOfItems: number,
callback?: function,
)
সম্প্রতি যোগ করা বুকমার্ক পুনরুদ্ধার করে।
পরামিতি
- সংখ্যার আইটেম
সংখ্যা
ফেরত দিতে আইটেম সর্বোচ্চ সংখ্যা.
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(results: BookmarkTreeNode[]) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode []>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
getSubTree()
chrome.bookmarks.getSubTree(
id: string,
callback?: function,
)
নির্দিষ্ট নোড থেকে শুরু করে বুকমার্কের অনুক্রমের অংশ পুনরুদ্ধার করে।
পরামিতি
- আইডি
স্ট্রিং
সাবট্রির রুটের আইডি পুনরুদ্ধার করতে হবে।
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(results: BookmarkTreeNode[]) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode []>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
getTree()
chrome.bookmarks.getTree(
callback?: function,
)
পুরো বুকমার্কের অনুক্রম পুনরুদ্ধার করে।
পরামিতি
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(results: BookmarkTreeNode[]) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode []>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
move()
chrome.bookmarks.move(
id: string,
destination: object,
callback?: function,
)
নির্দিষ্ট বুকমার্কট্রিনোডকে প্রদত্ত অবস্থানে নিয়ে যায়।
পরামিতি
- আইডি
স্ট্রিং
- গন্তব্য
বস্তু
- সূচক
সংখ্যা ঐচ্ছিক
- প্যারেন্টআইডি
স্ট্রিং ঐচ্ছিক
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(result: BookmarkTreeNode) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode >
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
remove()
chrome.bookmarks.remove(
id: string,
callback?: function,
)
একটি বুকমার্ক বা একটি খালি বুকমার্ক ফোল্ডার সরান.
পরামিতি
- আইডি
স্ট্রিং
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:() => void
রিটার্নস
প্রতিশ্রুতি <void>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
removeTree()
chrome.bookmarks.removeTree(
id: string,
callback?: function,
)
পুনরাবৃত্তভাবে একটি বুকমার্ক ফোল্ডার সরিয়ে দেয়।
পরামিতি
- আইডি
স্ট্রিং
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:() => void
রিটার্নস
প্রতিশ্রুতি <void>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
search()
chrome.bookmarks.search(
query: string | object,
callback?: function,
)
প্রদত্ত ক্যোয়ারির সাথে মিলে যাওয়া BookmarkTreeNodes অনুসন্ধান করে। একটি বস্তুর সাথে নির্দিষ্ট করা প্রশ্নগুলি সমস্ত নির্দিষ্ট বৈশিষ্ট্যের সাথে মিলে BookmarkTreeNodes উৎপন্ন করে।
পরামিতি
- প্রশ্ন
স্ট্রিং | বস্তু
হয় শব্দের একটি স্ট্রিং এবং উদ্ধৃত বাক্যাংশ যা বুকমার্ক URL এবং শিরোনামের সাথে মিলে যায়, অথবা একটি বস্তু। যদি একটি বস্তু, বৈশিষ্ট্য
query,url, এবংtitleনির্দিষ্ট করা যেতে পারে এবং সমস্ত নির্দিষ্ট বৈশিষ্ট্যের সাথে মেলে বুকমার্ক উত্পাদিত হবে।- প্রশ্ন
স্ট্রিং ঐচ্ছিক
বুকমার্ক URL এবং শিরোনামের সাথে মিলে যাওয়া শব্দ এবং উদ্ধৃত বাক্যাংশের একটি স্ট্রিং৷
- শিরোনাম
স্ট্রিং ঐচ্ছিক
বুকমার্কের শিরোনাম; শব্দার্থে মেলে।
- url
স্ট্রিং ঐচ্ছিক
বুকমার্কের URL; শব্দার্থে মেলে। মনে রাখবেন যে ফোল্ডারগুলির কোন URL নেই।
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(results: BookmarkTreeNode[]) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode []>
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
update()
chrome.bookmarks.update(
id: string,
changes: object,
callback?: function,
)
বুকমার্ক বা ফোল্ডারের বৈশিষ্ট্য আপডেট করে। আপনি পরিবর্তন করতে চান শুধুমাত্র বৈশিষ্ট্য উল্লেখ করুন; অনির্দিষ্ট বৈশিষ্ট্য অপরিবর্তিত রাখা হবে. দ্রষ্টব্য: বর্তমানে, শুধুমাত্র 'শিরোনাম' এবং 'url' সমর্থিত।
পরামিতি
- আইডি
স্ট্রিং
- পরিবর্তন
বস্তু
- শিরোনাম
স্ট্রিং ঐচ্ছিক
- url
স্ট্রিং ঐচ্ছিক
- কলব্যাক
ফাংশন ঐচ্ছিক
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(result: BookmarkTreeNode) => void
- ফলাফল
রিটার্নস
প্রতিশ্রুতি< BookmarkTreeNode >
Chrome 90+প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।
ঘটনা
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,
)
একটি বুকমার্ক বা ফোল্ডার তৈরি করা হলে বহিস্কার করা হয়।
পরামিতি
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(id: string, bookmark: BookmarkTreeNode) => void
- আইডি
স্ট্রিং
- বুকমার্ক
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
স্ট্রিং
- প্যারেন্টআইডি
স্ট্রিং
onRemoved
chrome.bookmarks.onRemoved.addListener(
callback: function,
)
একটি বুকমার্ক বা ফোল্ডার সরানো হলে বহিস্কার করা হয়. যখন একটি ফোল্ডার পুনরাবৃত্তভাবে মুছে ফেলা হয়, তখন ফোল্ডারের জন্য একটি একক বিজ্ঞপ্তি প্রকাশ করা হয় এবং এর বিষয়বস্তুর জন্য কোনটি নয়।
পরামিতি
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি এর মতো দেখাচ্ছে:(id: string, removeInfo: object) => void
- আইডি
স্ট্রিং
- তথ্য সরান
বস্তু
- সূচক
সংখ্যা
- নোডChrome 48+
- প্যারেন্টআইডি
স্ট্রিং