chrome.history

রিফ্রেশ তারিখ: ২০২৬-০৯-২৫ রোবটস: নোইনডেক্স

বর্ণনা

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

অনুমতি

history

প্রকাশ

হিস্ট্রি এপিআই ব্যবহার করার জন্য আপনাকে এক্সটেনশন ম্যানিফেস্টে 'হিস্ট্রি' পারমিশনটি অবশ্যই ঘোষণা করতে হবে। উদাহরণস্বরূপ:

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

রূপান্তরের প্রকারভেদ

হিস্ট্রি এপিআই একটি ট্রানজিশন টাইপ ব্যবহার করে বর্ণনা করে যে, কোনো নির্দিষ্ট ভিজিটে ব্রাউজারটি কীভাবে একটি নির্দিষ্ট ইউআরএল-এ নেভিগেট করেছে। উদাহরণস্বরূপ, যদি কোনো ব্যবহারকারী অন্য কোনো পৃষ্ঠার লিঙ্কে ক্লিক করে একটি পৃষ্ঠায় আসেন, তাহলে ট্রানজিশন টাইপটি হবে 'লিঙ্ক'।

নিম্নোক্ত সারণিতে প্রতিটি রূপান্তরের ধরণ বর্ণনা করা হয়েছে।

রূপান্তর প্রকার বর্ণনা
"টাইপ করা" ব্যবহারকারী অ্যাড্রেস বারে ইউআরএলটি টাইপ করে এই পেজটিতে এসেছেন। এটি অন্যান্য সুস্পষ্ট নেভিগেশন অ্যাকশনের জন্যও ব্যবহৃত হয়। আরও দেখুন 'জেনারেটেড' , যা এমন ক্ষেত্রে ব্যবহৃত হয় যেখানে ব্যবহারকারী এমন একটি বিকল্প বেছে নিয়েছেন যা দেখতে মোটেও ইউআরএল-এর মতো নয়।
"স্বয়ংক্রিয়_বুকমার্ক" ব্যবহারকারী UI-এর কোনো সাজেশনের মাধ্যমে—যেমন, কোনো মেনু আইটেমের মাধ্যমে—এই পেজটিতে এসেছেন।
"auto_subframe" সাবফ্রেম নেভিগেশন। এটি এমন যেকোনো কন্টেন্ট যা স্বয়ংক্রিয়ভাবে একটি নন-টপ-লেভেল ফ্রেমে লোড হয়। উদাহরণস্বরূপ, যদি একটি পেজ বিজ্ঞাপনযুক্ত একাধিক ফ্রেম নিয়ে গঠিত হয়, তবে সেই বিজ্ঞাপনের URL-গুলোতে এই ট্রানজিশন টাইপটি থাকে। ব্যবহারকারী হয়তো বুঝতেই পারবেন না যে এই পেজগুলোর কন্টেন্ট একটি আলাদা ফ্রেম, এবং তাই তিনি URL-টি নিয়ে মাথা ঘামাতে নাও পারেন ( ম্যানুয়াল_সাবফ্রেম- ও দেখুন)।
"ম্যানুয়াল_সাবফ্রেম" সাবফ্রেম নেভিগেশনের জন্য, যা ব্যবহারকারী দ্বারা স্পষ্টভাবে অনুরোধ করা হয় এবং ব্যাক/ফরোয়ার্ড তালিকায় নতুন নেভিগেশন এন্ট্রি তৈরি করে। একটি স্পষ্টভাবে অনুরোধ করা ফ্রেম সম্ভবত একটি স্বয়ংক্রিয়ভাবে লোড হওয়া ফ্রেমের চেয়ে বেশি গুরুত্বপূর্ণ, কারণ ব্যবহারকারী সম্ভবত এই বিষয়টি নিয়ে ভাবেন যে অনুরোধ করা ফ্রেমটি লোড হয়েছে।
"উৎপাদিত" ব্যবহারকারী অ্যাড্রেস বারে টাইপ করে এবং এমন একটি এন্ট্রি নির্বাচন করে এই পৃষ্ঠায় এসেছেন যা দেখতে ইউআরএল-এর মতো নয়। উদাহরণস্বরূপ, একটি ম্যাচ গুগল সার্চ রেজাল্ট পেজের ইউআরএল হতে পারে, কিন্তু ব্যবহারকারীর কাছে এটি "Search Google for ..." হিসাবে প্রদর্শিত হতে পারে। এগুলো টাইপ করা নেভিগেশনের মতো হুবহু এক নয়, কারণ ব্যবহারকারী গন্তব্য ইউআরএলটি টাইপ করেননি বা দেখেননি। আরও দেখুন কীওয়ার্ড ।
"auto_toplevel" পৃষ্ঠাটি কমান্ড লাইনে নির্দিষ্ট করা হয়েছিল অথবা এটি প্রারম্ভিক পৃষ্ঠা।
"ফর্ম_জমা" ব্যবহারকারী একটি ফর্মে তথ্য পূরণ করে তা জমা দিয়েছেন। উল্লেখ্য যে, কিছু পরিস্থিতিতে—যেমন যখন কোনো ফর্ম বিষয়বস্তু জমা দেওয়ার জন্য স্ক্রিপ্ট ব্যবহার করে—ফর্ম জমা দেওয়ার ফলে এই ধরনের রূপান্তর ঘটে না।
"পুনরায় লোড করুন" ব্যবহারকারী রিলোড বোতামে ক্লিক করে অথবা অ্যাড্রেস বারে এন্টার চেপে পৃষ্ঠাটি পুনরায় লোড করেছেন। সেশন পুনরুদ্ধার এবং বন্ধ ট্যাব পুনরায় খোলার ক্ষেত্রেও এই ট্রানজিশন টাইপটি ব্যবহৃত হয়।
"কীওয়ার্ড" ডিফল্ট সার্চ প্রোভাইডার ছাড়া অন্য কোনো পরিবর্তনযোগ্য কীওয়ার্ড থেকে ইউআরএলটি তৈরি করা হয়েছে। আরও দেখুন keyword_generated ।
"কীওয়ার্ড_জেনারেটেড" একটি কীওয়ার্ডের জন্য তৈরি হওয়া ভিজিটকে নির্দেশ করে। আরও দেখুন কীওয়ার্ড ।

উদাহরণ

এই API-টি ব্যবহার করার জন্য, chrome-extension-samples রিপোজিটরি থেকে history API উদাহরণটি ইনস্টল করুন।

প্রকারভেদ

HistoryItem

একটি অবজেক্ট যা হিস্ট্রি কোয়েরির একটি ফলাফলকে ধারণ করে।

বৈশিষ্ট্য

  • আইডি

    স্ট্রিং

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

  • শেষ পরিদর্শনের সময়

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

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

  • শিরোনাম

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

    সর্বশেষ লোড হওয়ার সময় পৃষ্ঠাটির শিরোনাম।

  • টাইপডকাউন্ট

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

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

  • ইউআরএল

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

    ব্যবহারকারী কর্তৃক পরিদর্শিত ইউআরএল।

  • ভিজিট সংখ্যা

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

    ব্যবহারকারী যতবার এই পৃষ্ঠায় এসেছেন তার সংখ্যা।

TransitionType

ক্রোম ৪৪+

এর রেফারার থেকে এই ভিজিটের ট্রানজিশন টাইপ ।

এনাম

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

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

"স্বয়ংক্রিয়_বুকমার্ক"
ব্যবহারকারী UI-এর কোনো সাজেশনের মাধ্যমে, যেমন কোনো মেনু আইটেমের মাধ্যমে, এই পেজটিতে এসেছেন।

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

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

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

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

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

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

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

"কীওয়ার্ড_জেনারেটেড"
একটি কীওয়ার্ডের জন্য তৈরি হওয়া ভিজিটকে নির্দেশ করে।

UrlDetails

ক্রোম ৮৮+

বৈশিষ্ট্য

  • ইউআরএল

    স্ট্রিং

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

VisitItem

একটি অবজেক্ট যা কোনো একটি ইউআরএল-এ একবার পরিদর্শনের তথ্য ধারণ করে।

বৈশিষ্ট্য

  • আইডি

    স্ট্রিং

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

  • স্থানীয়

    বুলিয়ান

    ক্রোম ১১৫+

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

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

    স্ট্রিং

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

  • এর রেফারার থেকে এই ভিজিটের ট্রানজিশন টাইপ ।

  • ভিজিটআইডি

    স্ট্রিং

    এই পরিদর্শনের অনন্য শনাক্তকারী।

  • ভিজিটটাইম

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

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

পদ্ধতি

addUrl()

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

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

প্যারামিটার

  • বিস্তারিত

    ইউআরএল বিবরণ

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯৬+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

deleteAll()

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

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

প্যারামিটার

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯৬+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

deleteRange()

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

হিস্ট্রি থেকে নির্দিষ্ট তারিখের পরিসরের মধ্যেকার সমস্ত আইটেম মুছে দেয়। যদি সমস্ত ভিজিট নির্দিষ্ট পরিসরের মধ্যে না পড়ে, তবে পেজগুলো হিস্ট্রি থেকে মুছে ফেলা হবে না।

প্যারামিটার

  • পরিসর

    বস্তু

    • শেষ সময়

      সংখ্যা

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

    • শুরুর সময়

      সংখ্যা

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

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯৬+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

deleteUrl()

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

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

প্যারামিটার

  • বিস্তারিত

    ইউআরএল বিবরণ

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

ফেরত

  • প্রতিশ্রুতি<শূন্য>

    ক্রোম ৯৬+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

getVisits()

প্রতিশ্রুতি
chrome.history.getVisits(
  details: UrlDetails,
  callback?: function,
): Promise<VisitItem[]>

কোনো ইউআরএল-এ পরিদর্শনের তথ্য পুনরুদ্ধার করে।

প্যারামিটার

ফেরত

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

    ক্রোম ৯৬+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

প্রতিশ্রুতি
chrome.history.search(
  query: object,
  callback?: function,
): Promise<HistoryItem[]>

কোয়েরির সাথে মেলে এমন প্রতিটি পেজের শেষ পরিদর্শনের সময় খুঁজে বের করার জন্য হিস্ট্রি অনুসন্ধান করে।

প্যারামিটার

  • প্রশ্ন

    বস্তু

    • শেষ সময়

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

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

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

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

      পুনরুদ্ধার করার জন্য ফলাফলের সর্বোচ্চ সংখ্যা। ডিফল্ট মান ১০০।

    • শুরুর সময়

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

      ফলাফলকে এই তারিখের পরে ভিজিট করা বিষয়গুলোর মধ্যে সীমাবদ্ধ করুন, যা ইপক থেকে মিলিসেকেন্ডে প্রকাশ করা হয়েছে। যদি প্রপার্টিটি নির্দিষ্ট করা না থাকে, তবে এটি ডিফল্টভাবে ২৪ ঘণ্টা হবে।

    • পাঠ্য

      স্ট্রিং

      হিস্ট্রি সার্ভিসে একটি ফ্রি-টেক্সট কোয়েরি। সমস্ত পৃষ্ঠা পেতে এটি খালি রাখুন।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (results: HistoryItem[]) => void

ফেরত

  • প্রতিশ্রুতি< ইতিহাস আইটেম []>

    ক্রোম ৯৬+

    প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

ইভেন্টগুলি

onVisited

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

কোনো URL ভিজিট করা হলে এই ইভেন্টটি ফায়ার হয় এবং সেই URL-এর HistoryItem ডেটা প্রদান করে। পেজ লোড হওয়ার আগেই এই ইভেন্টটি ফায়ার হয়।

প্যারামিটার

onVisitRemoved

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

হিস্ট্রি থেকে এক বা একাধিক ইউআরএল মুছে ফেলা হলে এটি সক্রিয় হয়। সমস্ত ভিজিট মুছে ফেলা হলে ইউআরএলটি হিস্ট্রি থেকে সম্পূর্ণরূপে মুছে ফেলা হয়।

প্যারামিটার

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি দেখতে এইরকম: 

    (removed: object) => void

    • অপসারণ করা হয়েছে

      বস্তু

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

        বুলিয়ান

        সমস্ত ইতিহাস মুছে ফেলা হলে 'ট্রু' হবে। যদি 'ট্রু' হয়, তাহলে ইউআরএলগুলো খালি থাকবে।

      • ইউআরএল

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