chrome.history

বর্ণনা

ব্রাউজারের পরিদর্শন করা পৃষ্ঠাগুলির রেকর্ডের সাথে ইন্টারঅ্যাক্ট করতে chrome.history API ব্যবহার করুন৷ আপনি ব্রাউজারের ইতিহাসে URL যোগ করতে, সরাতে এবং অনুসন্ধান করতে পারেন৷ আপনার নিজস্ব সংস্করণ দিয়ে ইতিহাসের পৃষ্ঠা ওভাররাইড করতে, ওভাররাইড পৃষ্ঠাগুলি দেখুন।

অনুমতি

history

ব্যবহারকারীর ব্রাউজারের ইতিহাসের সাথে ইন্টারঅ্যাক্ট করতে, ইতিহাস API ব্যবহার করুন।

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

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

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

রূপান্তর প্রকার

একটি নির্দিষ্ট ভিজিটে ব্রাউজারটি কীভাবে একটি নির্দিষ্ট URL-এ নেভিগেট করেছে তা বর্ণনা করতে ইতিহাস API রূপান্তর প্রকারগুলি ব্যবহার করে৷ উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী অন্য পৃষ্ঠার একটি লিঙ্কে ক্লিক করে একটি পৃষ্ঠা পরিদর্শন করেন, তাহলে রূপান্তর প্রকারটি "লিঙ্ক"। রূপান্তর প্রকারের তালিকার জন্য রেফারেন্স বিষয়বস্তু দেখুন।

উদাহরণ

এই API ব্যবহার করে দেখতে, chrome-extension-samples repository থেকে history API উদাহরণ ইনস্টল করুন।

প্রকারভেদ

HistoryItem

ইতিহাসের প্রশ্নের একটি ফলাফলকে এনক্যাপসুলেট করে এমন একটি বস্তু।

বৈশিষ্ট্য

  • আইডি

    স্ট্রিং

    আইটেমের অনন্য শনাক্তকারী।

  • শেষ দেখার সময়

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

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

  • শিরোনাম

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

    পৃষ্ঠার শিরোনাম যখন এটি শেষবার লোড করা হয়েছিল।

  • টাইপ করা গণনা

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

    ঠিকানা টাইপ করে ব্যবহারকারী কতবার এই পৃষ্ঠায় নেভিগেট করেছে।

  • url

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

    ব্যবহারকারীর দ্বারা নেভিগেট করা URL৷

  • ভিজিট কাউন্ট

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

    ব্যবহারকারী এই পৃষ্ঠায় কতবার নেভিগেট করেছে।

TransitionType

Chrome 44+

এটির রেফারারের কাছ থেকে এই দর্শনের জন্য রূপান্তর প্রকার ।

এনাম

"লিঙ্ক"
ব্যবহারকারী অন্য পৃষ্ঠার একটি লিঙ্কে ক্লিক করে এই পৃষ্ঠায় পৌঁছেছেন।

"টাইপ করা"
ব্যবহারকারী ঠিকানা বারে URL টাইপ করে এই পৃষ্ঠায় পৌঁছেছেন। এটি অন্যান্য সুস্পষ্ট নেভিগেশন ক্রিয়াগুলির জন্যও ব্যবহৃত হয়।

"অটো_বুকমার্ক"
ব্যবহারকারী UI-তে একটি পরামর্শের মাধ্যমে এই পৃষ্ঠায় এসেছেন, উদাহরণস্বরূপ, একটি মেনু আইটেমের মাধ্যমে৷

"অটো_সাবফ্রেম"
ব্যবহারকারী সাবফ্রেম নেভিগেশনের মাধ্যমে এই পৃষ্ঠায় এসেছেন যা তারা অনুরোধ করেনি, যেমন পূর্ববর্তী পৃষ্ঠায় একটি ফ্রেমে একটি বিজ্ঞাপন লোড করার মাধ্যমে৷ এগুলি সর্বদা পিছনে এবং সামনের মেনুতে নতুন নেভিগেশন এন্ট্রি তৈরি করে না।

"ম্যানুয়াল_সাবফ্রেম"
ব্যবহারকারী একটি সাবফ্রেমে কিছু নির্বাচন করে এই পৃষ্ঠায় এসেছেন।

"উত্পন্ন"
ব্যবহারকারী ঠিকানা বারে টাইপ করে এবং একটি এন্ট্রি নির্বাচন করে এই পৃষ্ঠায় এসেছেন যা একটি URL-এর মতো দেখাচ্ছে না, যেমন একটি Google অনুসন্ধান পরামর্শ৷ উদাহরণ স্বরূপ, একটি মিলের একটি Google অনুসন্ধান ফলাফল পৃষ্ঠার URL থাকতে পারে, কিন্তু এটি ব্যবহারকারীর কাছে "Search Google for ..." হিসাবে প্রদর্শিত হতে পারে। এগুলি টাইপ করা নেভিগেশন থেকে আলাদা কারণ ব্যবহারকারী গন্তব্য URL টাইপ করেনি বা দেখেনি৷ এগুলি কীওয়ার্ড নেভিগেশনের সাথেও সম্পর্কিত।

"অটো_টপলেভেল"
পৃষ্ঠাটি কমান্ড লাইনে নির্দিষ্ট করা হয়েছিল বা এটি শুরু পৃষ্ঠা।

"ফর্ম_জমা দিন"
ব্যবহারকারী একটি ফর্মে মান পূরণ করে এবং ফর্ম জমা দিয়ে এই পৃষ্ঠায় পৌঁছেছেন৷ সমস্ত ফর্ম জমা এই রূপান্তর প্রকার ব্যবহার করে না।

"পুনরায় লোড"
ব্যবহারকারী পৃষ্ঠাটি পুনরায় লোড করেছেন, হয় পুনরায় লোড বোতামে ক্লিক করে বা ঠিকানা বারে এন্টার টিপে৷ সেশন পুনরুদ্ধার এবং বন্ধ ট্যাব পুনরায় খুলুন এছাড়াও এই রূপান্তর প্রকার ব্যবহার করে।

"কীওয়ার্ড"
এই পৃষ্ঠার URLটি ডিফল্ট অনুসন্ধান প্রদানকারী ছাড়া অন্য একটি পরিবর্তনযোগ্য কীওয়ার্ড থেকে তৈরি করা হয়েছে।

"কীওয়ার্ড_জেনারেটেড"
একটি কীওয়ার্ডের জন্য তৈরি হওয়া একটি ভিজিটের সাথে মিলে যায়।

UrlDetails

Chrome 88+

বৈশিষ্ট্য

  • url

    স্ট্রিং

    অপারেশন জন্য URL. history.search() এ কল থেকে ফেরত দেওয়া ফরম্যাটে এটি অবশ্যই হতে হবে।

VisitItem

একটি URL-এ একবার ভিজিট করা একটি অবজেক্ট।

বৈশিষ্ট্য

  • আইডি

    স্ট্রিং

    সংশ্লিষ্ট history.HistoryItem অনন্য শনাক্তকারী।HistoryItem।

  • স্থানীয়

    বুলিয়ান

    Chrome 115+

    এই ডিভাইসে ভিজিট করা হলে সত্য। এটি একটি ভিন্ন ডিভাইস থেকে সিঙ্ক করা হলে মিথ্যা।

  • রেফারিং ভিজিটআইডি

    স্ট্রিং

    রেফারারের ভিজিট আইডি।

  • স্থানান্তর

    ট্রানজিশন টাইপ

    এটির রেফারারের কাছ থেকে এই দর্শনের জন্য রূপান্তর প্রকার ।

  • ভিজিট আইডি

    স্ট্রিং

    এই সফরের জন্য অনন্য শনাক্তকারী.

  • দেখার সময়

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

    যখন এই পরিদর্শনটি ঘটেছে, তখন থেকে মিলিসেকেন্ডে উপস্থাপিত হয়েছে।

পদ্ধতি

addUrl()

প্রতিশ্রুতি
chrome.history.addUrl(
  details: UrlDetails,
  callback?: function,
)

"লিঙ্ক" এর একটি রূপান্তর প্রকারের সাথে বর্তমান সময়ে ইতিহাসে একটি URL যোগ করে।

পরামিতি

  • বিস্তারিত

    Url বিস্তারিত

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    ()=>void

রিটার্নস

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

    Chrome 96+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

deleteAll()

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

ইতিহাস থেকে সমস্ত আইটেম মুছে দেয়।

পরামিতি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    ()=>void

রিটার্নস

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

    Chrome 96+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

deleteRange()

প্রতিশ্রুতি
chrome.history.deleteRange(
  range: object,
  callback?: function,
)

ইতিহাস থেকে নির্দিষ্ট তারিখ সীমার মধ্যে সমস্ত আইটেম সরিয়ে দেয়। ইতিহাস থেকে পৃষ্ঠাগুলি সরানো হবে না যদি না সমস্ত পরিদর্শন পরিসরের মধ্যে পড়ে।

পরামিতি

  • পরিসীমা

    বস্তু

    • শেষ সময়

      সংখ্যা

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

    • সময় শুরু

      সংখ্যা

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

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    ()=>void

রিটার্নস

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

    Chrome 96+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

deleteUrl()

প্রতিশ্রুতি
chrome.history.deleteUrl(
  details: UrlDetails,
  callback?: function,
)

ইতিহাস থেকে প্রদত্ত ইউআরএলের সমস্ত ঘটনাগুলি সরিয়ে দেয়।

পরামিতি

  • বিস্তারিত

    Url বিস্তারিত

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    ()=>void

রিটার্নস

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

    Chrome 96+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

getVisits()

প্রতিশ্রুতি
chrome.history.getVisits(
  details: UrlDetails,
  callback?: function,
)

একটি URL-এ ভিজিট সম্পর্কে তথ্য পুনরুদ্ধার করে।

পরামিতি

রিটার্নস

  • প্রতিশ্রুতি< ভিজিট আইটেম []>

    Chrome 96+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

প্রতিশ্রুতি
chrome.history.search(
  query: object,
  callback?: function,
)

কোয়েরির সাথে মিলে যাওয়া প্রতিটি পৃষ্ঠার শেষ পরিদর্শন সময়ের জন্য ইতিহাস অনুসন্ধান করে।

পরামিতি

  • প্রশ্ন

    বস্তু

    • শেষ সময়

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

      এই তারিখের আগে পরিদর্শন করা ফলাফলগুলিকে সীমাবদ্ধ করুন, যুগের পর থেকে মিলিসেকেন্ডে উপস্থাপন করা হয়েছে৷

    • সর্বোচ্চ ফলাফল

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

      পুনরুদ্ধার করার জন্য সর্বাধিক সংখ্যক ফলাফল। ডিফল্ট 100।

    • সময় শুরু

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

      এই তারিখের পরে যারা পরিদর্শন করেছেন তাদের ফলাফল সীমিত করুন, যুগের পর থেকে মিলিসেকেন্ডে উপস্থাপন করা হয়েছে। সম্পত্তি নির্দিষ্ট না হলে, এটি 24 ঘন্টা ডিফল্ট হবে।

    • পাঠ্য

      স্ট্রিং

      ইতিহাস পরিষেবাতে একটি বিনামূল্যে-পাঠ্য প্রশ্ন। সমস্ত পৃষ্ঠা পুনরুদ্ধার করতে এটি খালি রাখুন।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (results: HistoryItem[])=>void

রিটার্নস

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

    Chrome 96+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

ঘটনা

onVisited

chrome.history.onVisited.addListener(
  callback: function,
)

একটি URL পরিদর্শন করা হলে বরখাস্ত করা হয়, সেই URL-এর জন্য HistoryItem ডেটা প্রদান করে৷ পৃষ্ঠাটি লোড হওয়ার আগেই এই ইভেন্টটি ফায়ার হয়ে যায়।

পরামিতি

onVisitRemoved

chrome.history.onVisitRemoved.addListener(
  callback: function,
)

ইতিহাস থেকে এক বা একাধিক URL মুছে ফেলা হলে বহিস্কার করা হয়। যখন সমস্ত ভিজিট সরানো হয় তখন ইউআরএলটি ইতিহাস থেকে মুছে ফেলা হয়।

পরামিতি

  • কলব্যাক

    ফাংশন

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

    (removed: object)=>void

    • সরানো

      বস্তু

      • সমস্ত ইতিহাস

        বুলিয়ান

        সত্য যদি সমস্ত ইতিহাস মুছে ফেলা হয়। যদি সত্য হয়, তাহলে url খালি হবে।

      • ইউআরএল

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