chrome.cookies

বর্ণনা

chrome.cookies API ব্যবহার করুন কুকিজ অনুসন্ধান এবং সংশোধন করতে, এবং যখন সেগুলি পরিবর্তন হয় তখন বিজ্ঞপ্তি পেতে৷

অনুমতি

cookies

উদ্ভাসিত

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

{
  "name": "My extension",
  ...
  "host_permissions": [
    "*://*.google.com/"
  ],
  "permissions": [
    "cookies"
  ],
  ...
}

বিভাজন

বিভাজিত কুকিজ একটি সাইটকে চিহ্নিত করতে দেয় যে নির্দিষ্ট কুকিগুলি শীর্ষ স্তরের ফ্রেমের উৎপত্তির বিরুদ্ধে কী করা উচিত। এর মানে হল যে সাইট A যদি সাইট B এবং সাইট C-তে একটি iframe ব্যবহার করে এমবেড করা হয়, একটি পার্টিশন করা কুকির প্রতিটিতে আলাদা মান থাকতে পারে।

chrome.cookies পার্টিশন সমর্থন করে না, যার মানে হল যে সমস্ত পদ্ধতি সমস্ত পার্টিশন থেকে কুকি পড়তে এবং লিখতে পারে৷ cookies.set() পদ্ধতি ডিফল্ট পার্টিশনে কুকি সংরক্ষণ করে।

এক্সটেনশনের জন্য পার্টিশনের সাধারণ প্রভাব সম্পর্কে বিশদ বিবরণের জন্য, স্টোরেজ এবং কুকিজ দেখুন।

উদাহরণ

আপনি উদাহরণ/এপিআই/কুকিজ ডিরেক্টরিতে কুকিজ API ব্যবহার করার একটি সহজ উদাহরণ খুঁজে পেতে পারেন। অন্যান্য উদাহরণের জন্য এবং উত্স কোড দেখতে সাহায্যের জন্য, নমুনা দেখুন।

প্রকারভেদ

একটি HTTP কুকি সম্পর্কে তথ্য উপস্থাপন করে।

বৈশিষ্ট্য

  • ডোমেইন

    স্ট্রিং

    কুকির ডোমেন (যেমন "www.google.com", "example.com")।

  • মেয়াদ শেষ হওয়ার তারিখ

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

    UNIX যুগ থেকে সেকেন্ডের সংখ্যা হিসাবে কুকির মেয়াদ শেষ হওয়ার তারিখ। সেশন কুকিজ জন্য প্রদান করা হয় না.

  • শুধুমাত্র হোস্ট

    বুলিয়ান

    কুকি যদি শুধুমাত্র হোস্টের জন্য কুকি হয় (যেমন একটি অনুরোধের হোস্ট অবশ্যই কুকির ডোমেনের সাথে হুবহু মিলতে হবে)।

  • শুধুমাত্র http

    বুলিয়ান

    সত্য যদি কুকি HttpOnly হিসাবে চিহ্নিত করা হয় (অর্থাৎ কুকিটি ক্লায়েন্ট-সাইড স্ক্রিপ্টগুলিতে অ্যাক্সেসযোগ্য নয়)।

  • নাম

    স্ট্রিং

    কুকির নাম।

  • partitionKey

    CookiePartitionKey ঐচ্ছিক

    Chrome 119+

    পার্টিশন করা বৈশিষ্ট্য সহ কুকি পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।

  • পথ

    স্ট্রিং

    কুকির পথ।

  • Chrome 51+

    কুকির একই-সাইটের অবস্থা (অর্থাৎ ক্রস-সাইট অনুরোধের সাথে কুকি পাঠানো হয়েছে কিনা)।

  • নিরাপদ

    বুলিয়ান

    কুকিকে নিরাপদ হিসেবে চিহ্নিত করা হলে সত্য (অর্থাৎ এর সুযোগ নিরাপদ চ্যানেলে সীমাবদ্ধ, সাধারণত HTTPS)।

  • অধিবেশন

    বুলিয়ান

    মেয়াদ শেষ হওয়ার তারিখ সহ একটি স্থায়ী কুকির বিপরীতে কুকিটি একটি সেশন কুকি হলে সত্য৷

  • স্টোর আইডি

    স্ট্রিং

    getAllCookieStores() এ প্রদত্ত কুকি স্টোরের আইডিতে এই কুকি রয়েছে।

  • মান

    স্ট্রিং

    কুকির মান।

CookieDetails

Chrome 88+

কুকি সনাক্ত করতে বিশদ বিবরণ.

বৈশিষ্ট্য

  • নাম

    স্ট্রিং

    অ্যাক্সেস করার জন্য কুকির নাম।

  • partitionKey

    CookiePartitionKey ঐচ্ছিক

    Chrome 119+

    পার্টিশন করা বৈশিষ্ট্য সহ কুকি পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।

  • স্টোর আইডি

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

    কুকি স্টোরের আইডি যেখানে কুকি খুঁজতে হবে। ডিফল্টরূপে, বর্তমান এক্সিকিউশন কনটেক্সট এর কুকি স্টোর ব্যবহার করা হবে।

  • url

    স্ট্রিং

    যে ইউআরএলের সাথে কুকি অ্যাক্সেস করতে হবে সেটি যুক্ত। এই যুক্তিটি একটি সম্পূর্ণ URL হতে পারে, এই ক্ষেত্রে URL পাথ (যেমন ক্যোয়ারী স্ট্রিং) অনুসরণ করা যেকোন ডেটাকে উপেক্ষা করা হয়। ম্যানিফেস্ট ফাইলে এই URL-এর হোস্টের অনুমতি নির্দিষ্ট না থাকলে, API কল ব্যর্থ হবে৷

CookiePartitionKey

Chrome 119+

একটি বিভাজিত কুকির পার্টিশন কী প্রতিনিধিত্ব করে।

বৈশিষ্ট্য

  • আছেCrossSiteAncestor

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

    Chrome 130+

    কুকি একটি ক্রস-ক্রস সাইট প্রসঙ্গে সেট করা হয়েছে কিনা তা নির্দেশ করে। এটি একটি ক্রস-সাইট প্রসঙ্গে এম্বেড করা একটি শীর্ষ-স্তরের সাইটকে একই-সাইট প্রসঙ্গে শীর্ষ-স্তরের সাইট দ্বারা সেট করা কুকিজ অ্যাক্সেস করতে বাধা দেয়।

  • টপ লেভেল সাইট

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

    বিভাজিত কুকি যে শীর্ষ-স্তরের সাইটটিতে উপলব্ধ।

CookieStore

ব্রাউজারে একটি কুকি স্টোরের প্রতিনিধিত্ব করে। একটি ছদ্মবেশী মোড উইন্ডো, উদাহরণস্বরূপ, একটি অ-ছদ্মবেশী উইন্ডো থেকে একটি পৃথক কুকি স্টোর ব্যবহার করে৷

বৈশিষ্ট্য

  • আইডি

    স্ট্রিং

    কুকি স্টোরের অনন্য শনাক্তকারী।

  • ট্যাবআইডি

    সংখ্যা[]

    এই কুকি স্টোর শেয়ার করে এমন সমস্ত ব্রাউজার ট্যাবের শনাক্তকারী৷

FrameDetails

মুলতুবি

ফ্রেম সনাক্ত করতে বিশদ বিবরণ.

বৈশিষ্ট্য

  • ডকুমেন্ট আইডি

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

    নথির অনন্য শনাক্তকারী। ফ্রেমআইডি এবং/অথবা ট্যাবআইডি সরবরাহ করা হলে সেগুলি প্রদত্ত নথি ID দ্বারা পাওয়া নথির সাথে মেলে যাচাই করা হবে।

  • ফ্রেমআইডি

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

    ট্যাবের মধ্যে ফ্রেমের জন্য অনন্য শনাক্তকারী।

  • ট্যাবআইডি

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

    ফ্রেম ধারণকারী ট্যাবের অনন্য শনাক্তকারী।

OnChangedCause

Chrome 44+

কুকির পরিবর্তনের পিছনে অন্তর্নিহিত কারণ। যদি "chrome.cookies.remove" এ একটি স্পষ্ট কলের মাধ্যমে একটি কুকি ঢোকানো হয় বা সরানো হয়, "কারণ" হবে "স্পষ্ট"। মেয়াদ শেষ হওয়ার কারণে একটি কুকি স্বয়ংক্রিয়ভাবে সরানো হলে, "কারণ" "মেয়াদ শেষ" হবে। যদি একটি কুকি ইতিমধ্যেই মেয়াদ উত্তীর্ণ মেয়াদ শেষ হওয়ার তারিখের সাথে ওভাররাইট হওয়ার কারণে সরানো হয়, তাহলে "কারণ" "মেয়াদ শেষ_ওভাররাইট" এ সেট করা হবে। আবর্জনা সংগ্রহের কারণে একটি কুকি স্বয়ংক্রিয়ভাবে সরানো হলে, "কারণ" "উচ্ছেদ" করা হবে। যদি একটি "সেট" কলের কারণে একটি কুকি স্বয়ংক্রিয়ভাবে সরানো হয় যা এটিকে ওভাররাইট করে, "কারণ" হবে "ওভাররাইট"। সেই অনুযায়ী আপনার প্রতিক্রিয়া পরিকল্পনা করুন।

এনাম

"বহিষ্কৃত"

"মেয়াদ শেষ"

"স্পষ্ট"

"মেয়াদ শেষ_ওভাররাইট"

"ওভাররাইট"

SameSiteStatus

Chrome 51+

একটি কুকির 'সেমসাইট' অবস্থা (https://tools.ietf.org/html/draft-west-first-party-cookies)। 'no_restriction' 'SameSite=None', 'lax' থেকে 'SameSite=Lax' এবং 'স্ট্রিক'-এর সাথে 'SameSite=Strict' সহ একটি কুকি সেটের সাথে মিলে যায়। 'অনির্দিষ্ট' একইসাইট অ্যাট্রিবিউট ছাড়া একটি কুকি সেটের সাথে মিলে যায়।

এনাম

"কোন_সীমাবদ্ধতা"

"শিথিল"

"কঠোর"

"অনির্দিষ্ট"

পদ্ধতি

get()

প্রতিশ্রুতি
chrome.cookies.get(
  details: CookieDetails,
  callback?: function,
)

একটি একক কুকি সম্পর্কে তথ্য পুনরুদ্ধার করে। প্রদত্ত URL-এর জন্য একই নামের একাধিক কুকি বিদ্যমান থাকলে, দীর্ঘতম পথটি ফেরত দেওয়া হবে। একই পথের দৈর্ঘ্য সহ কুকিগুলির জন্য, প্রথম দিকের তৈরির সময় সহ কুকি ফেরত দেওয়া হবে৷

পরামিতি

  • বিস্তারিত

    কুকির বিবরণ

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (cookie?: Cookie) => void

    • কুকি

      কুকি ঐচ্ছিক

      কুকি সম্পর্কে বিশদ রয়েছে। এই ধরনের কোনো কুকি পাওয়া না গেলে এই প্যারামিটারটি শূন্য।

রিটার্নস

  • প্রতিশ্রুতি< কুকি | undefined>

    Chrome 88+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

getAll()

প্রতিশ্রুতি
chrome.cookies.getAll(
  details: object,
  callback?: function,
)

প্রদত্ত তথ্যের সাথে মেলে এমন একটি একক কুকি স্টোর থেকে সমস্ত কুকি পুনরুদ্ধার করে। প্রত্যাবর্তনকৃত কুকিগুলিকে প্রথমে দীর্ঘতম পাথের সাথে সাজানো হবে৷ যদি একাধিক কুকির একই পথের দৈর্ঘ্য থাকে, তবে প্রথম দিকের তৈরির সময়টি প্রথম হবে৷ এই পদ্ধতিটি শুধুমাত্র সেই ডোমেনের জন্য কুকিজ পুনরুদ্ধার করে যেগুলির জন্য এক্সটেনশনের হোস্টের অনুমতি রয়েছে৷

পরামিতি

  • বিস্তারিত

    বস্তু

    পুনরুদ্ধার করা কুকিজ ফিল্টার করার তথ্য।

    • ডোমেইন

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

      পুনরুদ্ধার করা কুকিগুলিকে সীমাবদ্ধ করে যাদের ডোমেন মেলে বা এটির সাবডোমেন।

    • নাম

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

      নাম দ্বারা কুকিজ ফিল্টার.

    • partitionKey

      CookiePartitionKey ঐচ্ছিক

      Chrome 119+

      পার্টিশন করা বৈশিষ্ট্য সহ কুকি পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।

    • পথ

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

      পুনরুদ্ধার করা কুকিগুলিকে সীমাবদ্ধ করে যাদের পাথ এই স্ট্রিংটির সাথে ঠিক মেলে৷

    • নিরাপদ

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

      কুকিগুলিকে তাদের সুরক্ষিত সম্পত্তি দ্বারা ফিল্টার করে।

    • অধিবেশন

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

      ফিল্টার আউট সেশন বনাম স্থায়ী কুকিজ।

    • স্টোর আইডি

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

      কুকির দোকান থেকে কুকিজ পুনরুদ্ধার করতে। যদি বাদ দেওয়া হয়, বর্তমান এক্সিকিউশন প্রেক্ষাপটের কুকি স্টোর ব্যবহার করা হবে।

    • url

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

      পুনরুদ্ধার করা কুকিগুলিকে প্রদত্ত URL এর সাথে মেলে তাদের মধ্যে সীমাবদ্ধ করে৷

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (cookies: Cookie[]) => void

    • কুকিজ

      কুকি [ ]

      প্রদত্ত কুকি তথ্যের সাথে মেলে এমন সমস্ত বিদ্যমান, মেয়াদোত্তীর্ণ কুকিজ।

রিটার্নস

  • প্রতিশ্রুতি < কুকি []>

    Chrome 88+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

getAllCookieStores()

প্রতিশ্রুতি
chrome.cookies.getAllCookieStores(
  callback?: function,
)

সমস্ত বিদ্যমান কুকি দোকান তালিকা.

পরামিতি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (cookieStores: CookieStore[]) => void

রিটার্নস

  • প্রতিশ্রুতি< কুকিস্টোর []>

    Chrome 88+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

getPartitionKey()

প্রতিশ্রুতি মুলতুবি
chrome.cookies.getPartitionKey(
  details: FrameDetails,
  callback?: function,
)

ফ্রেমের জন্য পার্টিশন কী নির্দেশিত।

পরামিতি

  • বিস্তারিত

    ফ্রেম বিবরণ

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (details: object) => void

    • বিস্তারিত

      বস্তু

      পুনরুদ্ধার করা পার্টিশন কী সম্পর্কে বিশদ বিবরণ রয়েছে।

      • পার্টিশন করা বৈশিষ্ট্য সহ কুকি পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।

রিটার্নস

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

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

remove()

প্রতিশ্রুতি
chrome.cookies.remove(
  details: CookieDetails,
  callback?: function,
)

নামে একটি কুকি মুছে দেয়।

পরামিতি

  • বিস্তারিত

    কুকির বিবরণ

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (details?: object) => void

    • বিস্তারিত

      বস্তু ঐচ্ছিক

      অপসারণ করা কুকি সম্পর্কে বিশদ বিবরণ রয়েছে৷ কোনো কারণে অপসারণ ব্যর্থ হলে, এটি "নাল" হবে এবং runtime.lastError সেট করা হবে।

      • নাম

        স্ট্রিং

        কুকির নাম যা সরানো হয়েছে।

      • partitionKey

        CookiePartitionKey ঐচ্ছিক

        Chrome 119+

        পার্টিশন করা বৈশিষ্ট্য সহ কুকি পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।

      • স্টোর আইডি

        স্ট্রিং

        কুকি স্টোরের আইডি যেখান থেকে কুকি সরানো হয়েছে।

      • url

        স্ট্রিং

        কুকির সাথে যুক্ত URL যা সরানো হয়েছে।

রিটার্নস

  • প্রতিশ্রুতি <অবজেক্ট | undefined>

    Chrome 88+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

set()

প্রতিশ্রুতি
chrome.cookies.set(
  details: object,
  callback?: function,
)

প্রদত্ত কুকি ডেটা সহ একটি কুকি সেট করে; সমতুল্য কুকিজ বিদ্যমান থাকলে ওভাররাইট করতে পারে।

পরামিতি

  • বিস্তারিত

    বস্তু

    কুকি সেট করা হচ্ছে সম্পর্কে বিস্তারিত.

    • ডোমেইন

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

      কুকির ডোমেইন। বাদ দেওয়া হলে, কুকি একটি হোস্ট-শুধু কুকি হয়ে যায়।

    • মেয়াদ শেষ হওয়ার তারিখ

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

      UNIX যুগ থেকে সেকেন্ডের সংখ্যা হিসাবে কুকির মেয়াদ শেষ হওয়ার তারিখ। যদি বাদ দেওয়া হয়, কুকি একটি সেশন কুকি হয়ে যায়।

    • শুধুমাত্র http

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

      কুকি HttpOnly হিসেবে চিহ্নিত করা উচিত কিনা। ডিফল্ট থেকে মিথ্যা.

    • নাম

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

      কুকির নাম। বাদ দিলে ডিফল্টরূপে খালি।

    • partitionKey

      CookiePartitionKey ঐচ্ছিক

      Chrome 119+

      পার্টিশন করা বৈশিষ্ট্য সহ কুকি পড়ার বা পরিবর্তন করার জন্য পার্টিশন কী।

    • পথ

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

      কুকির পথ। url প্যারামিটারের পাথ অংশে ডিফল্ট।

    • একই সাইট

      SameSiteStatus ঐচ্ছিক

      Chrome 51+

      কুকির একই সাইটের অবস্থা। "অনির্দিষ্ট" তে ডিফল্ট, অর্থাৎ, যদি বাদ দেওয়া হয়, কুকি একটি SameSite অ্যাট্রিবিউট উল্লেখ না করেই সেট করা হয়।

    • নিরাপদ

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

      কুকিকে সুরক্ষিত হিসাবে চিহ্নিত করা উচিত কিনা। ডিফল্ট থেকে মিথ্যা.

    • স্টোর আইডি

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

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

    • url

      স্ট্রিং

      অনুরোধ-ইউআরআই কুকির সেটিং এর সাথে যুক্ত করার জন্য। এই মানটি তৈরি করা কুকির ডিফল্ট ডোমেন এবং পাথ মানকে প্রভাবিত করতে পারে। ম্যানিফেস্ট ফাইলে এই URL-এর হোস্টের অনুমতি নির্দিষ্ট না থাকলে, API কল ব্যর্থ হবে৷

    • মান

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

      কুকির মান। বাদ দিলে ডিফল্টরূপে খালি।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (cookie?: Cookie) => void

    • কুকি

      কুকি ঐচ্ছিক

      সেট করা কুকি সম্পর্কে বিশদ বিবরণ রয়েছে৷ কোনো কারণে সেটিং ব্যর্থ হলে, এটি "নাল" হবে এবং runtime.lastError সেট করা হবে।

রিটার্নস

  • প্রতিশ্রুতি< কুকি | undefined>

    Chrome 88+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

ঘটনা

onChanged

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

একটি কুকি সেট বা সরানো হলে বহিস্কার করা হয়। একটি বিশেষ ক্ষেত্রে, নোট করুন যে একটি কুকির বৈশিষ্ট্য আপডেট করা একটি দ্বি-পদক্ষেপ প্রক্রিয়া হিসাবে প্রয়োগ করা হয়: আপডেট করা কুকিটি প্রথমে সম্পূর্ণরূপে সরানো হয়, "ওভাররাইট" এর "কারণ" সহ একটি বিজ্ঞপ্তি তৈরি করে৷ পরে, একটি নতুন কুকি আপডেট করা মান সহ লেখা হয়, "কারণ" "স্পষ্ট" সহ একটি দ্বিতীয় বিজ্ঞপ্তি তৈরি করে।

পরামিতি

  • কলব্যাক

    ফাংশন

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

    (changeInfo: object) => void

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

      বস্তু

      • কারণ

        OnChangedCause

        কুকির পরিবর্তনের পিছনে অন্তর্নিহিত কারণ।

      • কুকি

        কুকি

        সেট করা বা সরানো কুকি সম্পর্কে তথ্য।

      • সরানো

        বুলিয়ান

        সত্য যদি একটি কুকি সরানো হয়.