chrome.history

বর্ণনা

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

অনুমতি

history

উদ্ভাসিত

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

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

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

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

নিম্নলিখিত সারণী প্রতিটি রূপান্তর প্রকার বর্ণনা করে।

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

উদাহরণ

এই 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 খালি হবে।

      • ইউআরএল

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