বিবরণ
কুকিজ অনুসন্ধান এবং সংশোধন করতে এবং পরিবর্তন হলে বিজ্ঞপ্তি পেতে chrome.cookies API ব্যবহার করুন।
অনুমতিসমূহ
cookiesম্যানিফেস্ট
কুকিজ এপিআই ব্যবহার করার জন্য, আপনার ম্যানিফেস্টে "কুকিজ" অনুমতি ঘোষণা করতে হবে, এবং যে হোস্টের কুকিজ আপনি অ্যাক্সেস করতে চান তাদের হোস্ট অনুমতিও দিতে হবে । উদাহরণস্বরূপ:
{
"name": "My extension",
...
"host_permissions": [
"*://*.google.com/"
],
"permissions": [
"cookies"
],
...
}
পার্টিশন
পার্টিশন করা কুকিজ একটি সাইটকে চিহ্নিত করতে দেয় যে নির্দিষ্ট কুকিজগুলি শীর্ষ স্তরের ফ্রেমের উৎপত্তিস্থলের বিপরীতে কী করা উচিত। এর মানে হল যে যদি সাইট A সাইট B এবং সাইট C তে একটি আইফ্রেম ব্যবহার করে এমবেড করা হয়, তাহলে একটি পার্টিশন করা কুকির প্রতিটিতে আলাদা মান থাকতে পারে।
chrome.cookies পার্টিশনিং সমর্থন করে না, যার অর্থ হল সমস্ত পদ্ধতি সমস্ত পার্টিশন থেকে কুকি পড়ে এবং লেখে। cookies.set() পদ্ধতিটি ডিফল্ট পার্টিশনে কুকি সংরক্ষণ করে।
এক্সটেনশনের জন্য পার্টিশনের সাধারণ প্রভাব সম্পর্কে বিস্তারিত জানার জন্য, স্টোরেজ এবং কুকিজ দেখুন।
উদাহরণ
cookies API ব্যবহারের একটি সহজ উদাহরণ আপনি examples/api/cookies ডিরেক্টরিতে খুঁজে পেতে পারেন। অন্যান্য উদাহরণের জন্য এবং সোর্স কোড দেখার ক্ষেত্রে সাহায্যের জন্য, Samples দেখুন।
প্রকারভেদ
Cookie
একটি HTTP কুকি সম্পর্কে তথ্য উপস্থাপন করে।
বৈশিষ্ট্য
- ডোমেইন
স্ট্রিং
কুকির ডোমেন (যেমন "www.google.com", "example.com")।
- মেয়াদ শেষের তারিখ
সংখ্যা ঐচ্ছিক
UNIX যুগের পর থেকে সেকেন্ডের সংখ্যা হিসেবে কুকির মেয়াদ শেষ হওয়ার তারিখ। সেশন কুকিজের জন্য প্রদান করা হয়নি।
- হোস্ট-কেবল
বুলিয়ান
যদি কুকিটি কেবল হোস্ট-ভিত্তিক কুকি হয় (অর্থাৎ অনুরোধের হোস্ট অবশ্যই কুকির ডোমেনের সাথে হুবহু মিলবে) তাহলে এটি সত্য।
- http শুধুমাত্র
বুলিয়ান
যদি কুকিটি HttpOnly হিসেবে চিহ্নিত থাকে (অর্থাৎ ক্লায়েন্ট-সাইড স্ক্রিপ্টের কাছে কুকিটি অ্যাক্সেসযোগ্য নয়) তাহলে সত্য।
- নাম
স্ট্রিং
কুকির নাম।
- পার্টিশন কী
কুকি পার্টিশনকি ঐচ্ছিক
ক্রোম ১১৯+পার্টিশনড অ্যাট্রিবিউট ব্যবহার করে কুকিজ পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।
- পথ
স্ট্রিং
কুকির পথ।
- একই সাইটক্রোম ৫১+
কুকির একই-সাইট স্ট্যাটাস (অর্থাৎ কুকিটি ক্রস-সাইট অনুরোধের সাথে পাঠানো হয়েছে কিনা)।
- নিরাপদ
বুলিয়ান
কুকিটি যদি নিরাপদ হিসেবে চিহ্নিত করা থাকে (অর্থাৎ এর পরিধি নিরাপদ চ্যানেলের মধ্যেই সীমাবদ্ধ, সাধারণত HTTPS) তাহলে এটি সত্য।
- অধিবেশন
বুলিয়ান
যদি কুকিটি একটি সেশন কুকি হয়, তবে মেয়াদ শেষ হওয়ার তারিখ সহ একটি স্থায়ী কুকির বিপরীতে, এটি সত্য।
- স্টোরআইডি
স্ট্রিং
getAllCookieStores() এ প্রদত্ত কুকি ধারণকারী কুকি স্টোরের আইডি।
- মূল্য
স্ট্রিং
কুকির মূল্য।
CookieDetails
কুকি শনাক্ত করার জন্য বিশদ বিবরণ।
বৈশিষ্ট্য
- নাম
স্ট্রিং
অ্যাক্সেস করার জন্য কুকির নাম।
- পার্টিশন কী
কুকি পার্টিশনকি ঐচ্ছিক
ক্রোম ১১৯+পার্টিশনড অ্যাট্রিবিউট ব্যবহার করে কুকিজ পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।
- স্টোরআইডি
স্ট্রিং ঐচ্ছিক
কুকি স্টোরের আইডি যেখানে কুকি খুঁজতে হবে। ডিফল্টরূপে, বর্তমান এক্সিকিউশন কনটেক্সটের কুকি স্টোর ব্যবহার করা হবে।
- ইউআরএল
স্ট্রিং
যে URL-এর সাথে কুকি অ্যাক্সেস করা হবে তা যুক্ত। এই যুক্তিটি একটি পূর্ণ URL হতে পারে, এই ক্ষেত্রে URL পাথ অনুসরণকারী যেকোনো ডেটা (যেমন কোয়েরি স্ট্রিং) কেবল উপেক্ষা করা হয়। যদি এই URL-এর জন্য হোস্ট অনুমতিগুলি ম্যানিফেস্ট ফাইলে নির্দিষ্ট না করা থাকে, তাহলে API কল ব্যর্থ হবে।
CookiePartitionKey
একটি পার্টিশন করা কুকির পার্টিশন কী প্রতিনিধিত্ব করে।
বৈশিষ্ট্য
- ক্রসসাইটঅ্যান্সেস্টার আছে
বুলিয়ান ঐচ্ছিক
ক্রোম ১৩০+কুকিটি ক্রস-ক্রস সাইট প্রসঙ্গে সেট করা হয়েছে কিনা তা নির্দেশ করে। এটি ক্রস-সাইট প্রসঙ্গে এমবেড করা একটি শীর্ষ-স্তরের সাইটকে একই-সাইট প্রসঙ্গে শীর্ষ-স্তরের সাইট দ্বারা সেট করা কুকি অ্যাক্সেস করতে বাধা দেয়।
- টপলেভেলসাইট
স্ট্রিং ঐচ্ছিক
পার্টিশন করা কুকিটি যে শীর্ষ-স্তরের সাইটে পাওয়া যায়।
CookieStore
ব্রাউজারে একটি কুকি স্টোর প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, একটি ছদ্মবেশী মোড উইন্ডো, একটি অ-ছদ্মবেশী উইন্ডো থেকে একটি পৃথক কুকি স্টোর ব্যবহার করে।
বৈশিষ্ট্য
- আইডি
স্ট্রিং
কুকি স্টোরের জন্য অনন্য শনাক্তকারী।
- ট্যাবআইডি
সংখ্যা[]
এই কুকি স্টোরটি শেয়ার করে এমন সমস্ত ব্রাউজার ট্যাবের শনাক্তকারী।
FrameDetails
ফ্রেম শনাক্ত করার জন্য বিশদ বিবরণ।
বৈশিষ্ট্য
- ডকুমেন্ট আইডি
স্ট্রিং ঐচ্ছিক
ডকুমেন্টের জন্য অনন্য শনাক্তকারী। যদি ফ্রেমআইডি এবং/অথবা ট্যাবআইডি প্রদান করা হয় তবে প্রদত্ত ডকুমেন্ট আইডি দ্বারা পাওয়া ডকুমেন্টের সাথে মিল রেখে যাচাই করা হবে।
- ফ্রেম আইডি
সংখ্যা ঐচ্ছিক
ট্যাবের মধ্যে ফ্রেমের জন্য অনন্য শনাক্তকারী।
- ট্যাবআইডি
সংখ্যা ঐচ্ছিক
ফ্রেম ধারণকারী ট্যাবের জন্য অনন্য শনাক্তকারী।
OnChangedCause
কুকি পরিবর্তনের পেছনের মূল কারণ। যদি কোনও কুকি "chrome.cookies.remove" এ একটি স্পষ্ট কলের মাধ্যমে ঢোকানো হয় বা সরানো হয়, তাহলে "cause" "explicit" হবে। যদি কোনও কুকি মেয়াদ শেষ হওয়ার কারণে স্বয়ংক্রিয়ভাবে সরানো হয়, তাহলে "cause" "expired" হবে। যদি কোনও কুকি ইতিমধ্যেই মেয়াদ শেষ হওয়ার তারিখের সাথে ওভাররাইট করার কারণে সরানো হয়, তাহলে "cause" "expired_overwrite" তে সেট করা হবে। যদি কোনও কুকি আবর্জনা সংগ্রহের কারণে স্বয়ংক্রিয়ভাবে সরানো হয়, তাহলে "cause" "expired" হবে। যদি কোনও "সেট" কল ওভাররাইট করার কারণে কুকি স্বয়ংক্রিয়ভাবে সরানো হয়, তাহলে "cause" "overwrite" হবে। সেই অনুযায়ী আপনার প্রতিক্রিয়া পরিকল্পনা করুন।
এনাম
"উচ্ছেদ" "মেয়াদ শেষ" "স্পষ্ট" "মেয়াদোত্তীর্ণ_ওভাররাইট" "ওভাররাইট"
SameSiteStatus
একটি কুকির 'SameSite' অবস্থা (https://tools.ietf.org/html/draft-west-first-party-cookies)। 'no_restriction' 'SameSite=None' সহ একটি কুকি সেটের সাথে মিলে যায়, 'lax' 'SameSite=Lax' এর সাথে মিলে যায় এবং 'strict' 'SameSite=Strict' এর সাথে মিলে যায়। 'unspecified' SameSite অ্যাট্রিবিউট ছাড়া একটি কুকি সেটের সাথে মিলে যায়।
এনাম
"কোন_সীমাবদ্ধতা নেই" "শিথিলতা" "কঠোর" "অনির্দিষ্ট"
পদ্ধতি
get()
chrome.cookies.get(
details: CookieDetails,
callback?: function,
): Promise<Cookie | undefined>
একটি কুকি সম্পর্কে তথ্য পুনরুদ্ধার করে। যদি প্রদত্ত URL-এর জন্য একই নামের একাধিক কুকি বিদ্যমান থাকে, তাহলে দীর্ঘতম পথের কুকিটি ফেরত পাঠানো হবে। একই পথের দৈর্ঘ্যের কুকিগুলির জন্য, সবচেয়ে আগে তৈরির সময় সহ কুকিটি ফেরত পাঠানো হবে।
পরামিতি
রিটার্নস
প্রতিশ্রুতি< কুকি | অনির্ধারিত>
ক্রোম ৮৮+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
getAll()
chrome.cookies.getAll(
details: object,
callback?: function,
): Promise<Cookie[]>
একটি একক কুকি স্টোর থেকে প্রদত্ত তথ্যের সাথে মেলে এমন সমস্ত কুকি পুনরুদ্ধার করে। ফিরে আসা কুকিগুলি সাজানো হবে, সবচেয়ে দীর্ঘ পথের সাথে প্রথমে। যদি একাধিক কুকির একই পথের দৈর্ঘ্য থাকে, তাহলে সবচেয়ে আগে তৈরির সময় সহ কুকিগুলি প্রথমে থাকবে। এই পদ্ধতিটি কেবলমাত্র সেই ডোমেনগুলির জন্য কুকি পুনরুদ্ধার করে যেখানে এক্সটেনশনের হোস্ট অনুমতি রয়েছে।
পরামিতি
- বিস্তারিত
বস্তু
পুনরুদ্ধার করা কুকিজ ফিল্টার করার জন্য তথ্য।
- ডোমেইন
স্ট্রিং ঐচ্ছিক
যাদের ডোমেন এটির সাথে মেলে বা সাবডোমেন, তাদের মধ্যে পুনরুদ্ধার করা কুকিজ সীমাবদ্ধ করে।
- নাম
স্ট্রিং ঐচ্ছিক
নাম অনুসারে কুকিজ ফিল্টার করে।
- পার্টিশন কী
কুকি পার্টিশনকি ঐচ্ছিক
ক্রোম ১১৯+পার্টিশনড অ্যাট্রিবিউট ব্যবহার করে কুকিজ পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।
- পথ
স্ট্রিং ঐচ্ছিক
যাদের পাথ এই স্ট্রিং এর সাথে হুবহু মিলে যায়, তাদের মধ্যে পুনরুদ্ধার করা কুকিজ সীমাবদ্ধ করে।
- নিরাপদ
বুলিয়ান ঐচ্ছিক
কুকিগুলিকে তাদের সিকিউর প্রপার্টি অনুসারে ফিল্টার করে।
- অধিবেশন
বুলিয়ান ঐচ্ছিক
সেশন বনাম স্থায়ী কুকি ফিল্টার করে।
- স্টোরআইডি
স্ট্রিং ঐচ্ছিক
যে কুকি স্টোর থেকে কুকিজ উদ্ধার করা হবে। বাদ দিলে, বর্তমান এক্সিকিউশন কনটেক্সটের কুকি স্টোর ব্যবহার করা হবে।
- ইউআরএল
স্ট্রিং ঐচ্ছিক
পুনরুদ্ধার করা কুকিগুলিকে কেবলমাত্র সেই কুকিগুলিতে সীমাবদ্ধ করে যা প্রদত্ত URL এর সাথে মেলে।
- কলব্যাক
ঐচ্ছিক ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(cookies: Cookie[]) => void
- কুকিজ
কুকি []
প্রদত্ত কুকি তথ্যের সাথে মেলে এমন সমস্ত বিদ্যমান, মেয়াদোত্তীর্ণ কুকি।
রিটার্নস
প্রতিশ্রুতি< কুকি []>
ক্রোম ৮৮+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
getAllCookieStores()
chrome.cookies.getAllCookieStores(
callback?: function,
): Promise<CookieStore[]>
সমস্ত বিদ্যমান কুকি স্টোরের তালিকা তৈরি করে।
পরামিতি
- কলব্যাক
ঐচ্ছিক ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(cookieStores: CookieStore[]) => void
- কুকিস্টোর
কুকিস্টোর []
সমস্ত বিদ্যমান কুকি স্টোর।
রিটার্নস
প্রতিশ্রুতি< কুকিস্টোর []>
ক্রোম ৮৮+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
getPartitionKey()
chrome.cookies.getPartitionKey(
details: FrameDetails,
callback?: function,
): Promise<object>
নির্দেশিত ফ্রেমের পার্টিশন কী।
পরামিতি
- বিস্তারিত
- কলব্যাক
ঐচ্ছিক ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(details: object) => void
- বিস্তারিত
বস্তু
পুনরুদ্ধার করা পার্টিশন কী সম্পর্কে বিশদ বিবরণ রয়েছে।
- পার্টিশন কী
পার্টিশনড অ্যাট্রিবিউট ব্যবহার করে কুকিজ পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।
রিটার্নস
প্রতিশ্রুতি <object>
প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
remove()
chrome.cookies.remove(
details: CookieDetails,
callback?: function,
): Promise<object | undefined>
নামের মাধ্যমে একটি কুকি মুছে ফেলে।
পরামিতি
- বিস্তারিত
- কলব্যাক
ঐচ্ছিক ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(details?: object) => void
- বিস্তারিত
ঐচ্ছিক বস্তু
যে কুকিটি সরানো হয়েছে তার বিশদ বিবরণ এতে রয়েছে। যদি কোনও কারণে অপসারণ ব্যর্থ হয়, তাহলে প্রতিশ্রুতি প্রত্যাখ্যান করা হবে।
- নাম
স্ট্রিং
যে কুকিটি সরানো হয়েছে তার নাম।
- পার্টিশন কী
কুকি পার্টিশনকি ঐচ্ছিক
ক্রোম ১১৯+পার্টিশনড অ্যাট্রিবিউট ব্যবহার করে কুকিজ পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।
- স্টোরআইডি
স্ট্রিং
যে কুকি স্টোর থেকে কুকিটি সরানো হয়েছে তার আইডি।
- ইউআরএল
স্ট্রিং
যে কুকিটি সরানো হয়েছে তার সাথে সম্পর্কিত URL।
রিটার্নস
প্রতিশ্রুতি<বস্তু | অনির্ধারিত>
ক্রোম ৮৮+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
set()
chrome.cookies.set(
details: object,
callback?: function,
): Promise<Cookie | undefined>
প্রদত্ত কুকি ডেটা সহ একটি কুকি সেট করে; যদি সমতুল্য কুকি থাকে তবে সেগুলি ওভাররাইট করতে পারে।
পরামিতি
- বিস্তারিত
বস্তু
সেট করা কুকি সম্পর্কে বিশদ বিবরণ।
- ডোমেইন
স্ট্রিং ঐচ্ছিক
কুকির ডোমেন। বাদ দিলে, কুকিটি কেবল হোস্ট-অনলি কুকিতে পরিণত হয়।
- মেয়াদ শেষের তারিখ
সংখ্যা ঐচ্ছিক
UNIX যুগের পর থেকে সেকেন্ডের সংখ্যা হিসেবে কুকির মেয়াদ শেষ হওয়ার তারিখ। বাদ দিলে, কুকিটি একটি সেশন কুকিতে পরিণত হয়।
- http শুধুমাত্র
বুলিয়ান ঐচ্ছিক
কুকিটিকে HttpOnly হিসেবে চিহ্নিত করা উচিত কিনা। ডিফল্ট হিসেবে মিথ্যা।
- নাম
স্ট্রিং ঐচ্ছিক
কুকির নাম। বাদ দিলে ডিফল্টরূপে খালি।
- পার্টিশন কী
কুকি পার্টিশনকি ঐচ্ছিক
ক্রোম ১১৯+পার্টিশনড অ্যাট্রিবিউট ব্যবহার করে কুকিজ পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।
- পথ
স্ট্রিং ঐচ্ছিক
কুকির পথ। url প্যারামিটারের পথ অংশে ডিফল্ট।
- একই সাইট
SameSiteStatus ঐচ্ছিক
ক্রোম ৫১+কুকির একই-সাইট অবস্থা। ডিফল্টভাবে "unspecified" থাকে, অর্থাৎ, বাদ দিলে, কুকিটি SameSite অ্যাট্রিবিউট নির্দিষ্ট না করেই সেট করা হয়।
- নিরাপদ
বুলিয়ান ঐচ্ছিক
কুকিটি নিরাপদ হিসেবে চিহ্নিত করা উচিত কিনা। ডিফল্টভাবে মিথ্যা।
- স্টোরআইডি
স্ট্রিং ঐচ্ছিক
কুকি স্টোরের আইডি যেখানে কুকি সেট করতে হবে। ডিফল্টরূপে, কুকিটি বর্তমান এক্সিকিউশন কনটেক্সটের কুকি স্টোরে সেট করা থাকে।
- ইউআরএল
স্ট্রিং
কুকির সেটিং এর সাথে সংযুক্ত করার জন্য অনুরোধ-URI। এই মানটি তৈরি করা কুকির ডিফল্ট ডোমেন এবং পাথ মানগুলিকে প্রভাবিত করতে পারে। যদি এই URL এর জন্য হোস্ট অনুমতিগুলি ম্যানিফেস্ট ফাইলে নির্দিষ্ট না করা থাকে, তাহলে API কলটি ব্যর্থ হবে।
- মূল্য
স্ট্রিং ঐচ্ছিক
কুকির মান। বাদ দিলে ডিফল্টরূপে খালি।
- কলব্যাক
ঐচ্ছিক ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(cookie?: Cookie) => void
- কুকি
কুকি ঐচ্ছিক
সেট করা কুকি সম্পর্কে বিস্তারিত তথ্য এতে রয়েছে। যদি কোনও কারণে সেটিং ব্যর্থ হয়, তাহলে প্রতিশ্রুতি বাতিল করা হবে।
রিটার্নস
প্রতিশ্রুতি< কুকি | অনির্ধারিত>
ক্রোম ৮৮+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
ইভেন্টগুলি
onChanged
chrome.cookies.onChanged.addListener(
callback: function,
)
কুকি সেট করা বা সরানো হলে এটি চালু করা হয়। বিশেষ ক্ষেত্রে, মনে রাখবেন যে কুকির বৈশিষ্ট্য আপডেট করা দুই ধাপের প্রক্রিয়া হিসেবে বাস্তবায়িত হয়: আপডেট করা কুকিটি প্রথমে সম্পূর্ণরূপে সরানো হয়, "cause" বা "overwrite" সহ একটি বিজ্ঞপ্তি তৈরি করে। পরে, আপডেট করা মানগুলির সাথে একটি নতুন কুকি লেখা হয়, "cause" "explicit" সহ একটি দ্বিতীয় বিজ্ঞপ্তি তৈরি করে।
পরামিতি
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(changeInfo: object) => void
- পরিবর্তন তথ্য
বস্তু
- কারণ
কুকির পরিবর্তনের পিছনে অন্তর্নিহিত কারণ।
- কুকি
সেট করা বা সরানো কুকি সম্পর্কে তথ্য।
- সরানো হয়েছে
বুলিয়ান
যদি কোনও কুকি সরানো হয় তবে সত্য।