browser.history

ब्यौरा

ब्राउज़र में विज़िट किए गए पेजों के रिकॉर्ड से इंटरैक्ट करने के लिए, chrome.history एपीआई का इस्तेमाल करें. ब्राउज़र के इतिहास में यूआरएल जोड़े जा सकते हैं, हटाए जा सकते हैं, और क्वेरी की जा सकती है. इतिहास वाले पेज को अपने वर्शन से बदलने के लिए, पेज बदलना देखें.

अनुमतियां

history

उपयोगकर्ता के ब्राउज़िंग इतिहास से इंटरैक्ट करने के लिए, History API का इस्तेमाल करें.

इतिहास एपीआई का इस्तेमाल करने के लिए, एक्सटेंशन मेनिफ़ेस्ट में "history" अनुमति का एलान करें. उदाहरण के लिए:

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

कॉन्सेप्ट और इस्तेमाल

ट्रांज़िशन के टाइप

हिस्ट्री एपीआई, ट्रांज़िशन टाइप का इस्तेमाल करके यह बताता है कि ब्राउज़र ने किसी खास विज़िट के दौरान, किसी खास यूआरएल पर कैसे नेविगेट किया. उदाहरण के लिए, अगर कोई उपयोगकर्ता किसी दूसरे पेज पर मौजूद लिंक पर क्लिक करके किसी पेज पर जाता है, तो ट्रांज़िशन टाइप "लिंक" होगा. ट्रांज़िशन के टाइप की सूची देखने के लिए, रेफ़रंस कॉन्टेंट देखें.

उदाहरण

इस एपीआई को आज़माने के लिए, chrome-extension-samples रिपॉज़िटरी से history API का उदाहरण इंस्टॉल करें.

टाइप

HistoryItem

इतिहास की क्वेरी के एक नतीजे को एनकैप्सुलेट करने वाला ऑब्जेक्ट.

प्रॉपर्टी

• आईडी

  स्ट्रिंग

  आइटम के लिए यूनीक आइडेंटिफ़ायर.

• lastVisitTime

  number ज़रूरी नहीं

  इस पेज को पिछली बार कब लोड किया गया था. इसे Epoch के बाद से मिलीसेकंड में दिखाया जाता है.

• title

  string ज़रूरी नहीं

  पेज को पिछली बार लोड किए जाने के समय उसका टाइटल.

• typedCount

  number ज़रूरी नहीं

  उपयोगकर्ता ने पता टाइप करके, इस पेज पर कितनी बार नेविगेट किया है.

• url

  string ज़रूरी नहीं

  वह यूआरएल जिस पर उपयोगकर्ता ने नेविगेट किया.

• visitCount

  number ज़रूरी नहीं

  उपयोगकर्ता ने इस पेज पर कितनी बार नेविगेट किया है.

TransitionType

Chrome 44+ browser.* Chrome 148 के बाद से

रेफ़रर से इस विज़िट के लिए, ट्रांज़िशन टाइप.

Enum

"लिंक"
उपयोगकर्ता किसी दूसरे पेज पर मौजूद लिंक पर क्लिक करके इस पेज पर पहुंचा.

"typed"
उपयोगकर्ता, पता बार में यूआरएल टाइप करके इस पेज पर पहुंचा. इसका इस्तेमाल, नेविगेशन से जुड़ी अन्य कार्रवाइयों के लिए भी किया जाता है.

"auto_bookmark"
उपयोगकर्ता, यूज़र इंटरफ़ेस (यूआई) में दिए गए सुझाव की मदद से इस पेज पर पहुंचा है. उदाहरण के लिए, मेन्यू आइटम की मदद से.

"auto_subframe"
उपयोगकर्ता इस पेज पर सबफ़्रेम नेविगेशन की मदद से पहुंचा है. उसने इस नेविगेशन का अनुरोध नहीं किया था. जैसे, पिछले पेज पर किसी फ़्रेम में लोड होने वाले विज्ञापन की मदद से. इनसे, बैक और फ़ॉरवर्ड मेन्यू में हमेशा नई नेविगेशन एंट्री जनरेट नहीं होती हैं.

"manual_subframe"
उपयोगकर्ता, सबफ़्रेम में मौजूद किसी विकल्प को चुनकर इस पेज पर पहुंचा है.

"generated"
उपयोगकर्ता ने पता बार में टाइप करके और ऐसी एंट्री चुनकर इस पेज को ऐक्सेस किया जो यूआरएल जैसी नहीं दिखती थी. जैसे, Google Search से जुड़ा सुझाव. उदाहरण के लिए, हो सकता है कि किसी मैच में Google पर खोज नतीजों के पेज का यूआरएल हो, लेकिन उपयोगकर्ता को वह "Google पर ... खोजें" के तौर पर दिखे. ये टाइप किए गए नेविगेशन से अलग होते हैं, क्योंकि उपयोगकर्ता ने डेस्टिनेशन यूआरएल को टाइप नहीं किया या देखा नहीं. ये कीवर्ड नेविगेशन से भी जुड़े होते हैं.

"auto_toplevel"
पेज को कमांड लाइन में बताया गया था या यह शुरुआती पेज है.

"form_submit"
उपयोगकर्ता, फ़ॉर्म में वैल्यू भरकर और फ़ॉर्म सबमिट करके इस पेज पर पहुंचा. सभी फ़ॉर्म सबमिशन के लिए, इस ट्रांज़िशन टाइप का इस्तेमाल नहीं किया जाता.

"reload"
उपयोगकर्ता ने पेज को फिर से लोड किया. इसके लिए, उसने 'फिर से लोड करें' बटन पर क्लिक किया या पता बार में Enter दबाया. सेशन को वापस लाने और बंद किए गए टैब को फिर से खोलने के लिए भी इस ट्रांज़िशन टाइप का इस्तेमाल किया जाता है.

"keyword"
इस पेज का यूआरएल, डिफ़ॉल्ट सर्च इंजन की सुविधा देने वाली कंपनी के अलावा, किसी अन्य कंपनी के बदले जा सकने वाले कीवर्ड से जनरेट किया गया था.

"keyword_generated"
यह किसी कीवर्ड के लिए जनरेट की गई विज़िट से जुड़ा है.

UrlDetails

Chrome 88+ browser.* Chrome 148 से

प्रॉपर्टी

• url

  स्ट्रिंग

  कार्रवाई के लिए यूआरएल. यह उसी फ़ॉर्मैट में होना चाहिए जो history.search() को कॉल करने पर मिलता है.

VisitItem

किसी यूआरएल पर एक विज़िट को एनकैप्सुलेट करने वाला ऑब्जेक्ट.

प्रॉपर्टी

• आईडी

  स्ट्रिंग

  इससे जुड़े history.HistoryItem के लिए यूनीक आइडेंटिफ़ायर.

• isLocal

  बूलियन

  Chrome 115 और इसके बाद के वर्शन Chrome 148 के बाद से browser.*

  अगर विज़िट इस डिवाइस से शुरू हुई है, तो True. अगर इसे किसी दूसरे डिवाइस से सिंक किया गया है, तो False.

• referringVisitId

  स्ट्रिंग

  रेफ़रर का विज़िट आईडी.

• ट्रांज़िशन

  TransitionType

  रेफ़रर से इस विज़िट के लिए, ट्रांज़िशन टाइप.

• visitId

  स्ट्रिंग

  इस विज़िट के लिए यूनीक आइडेंटिफ़ायर.

• visitTime

  number ज़रूरी नहीं

  यह विज़िट कब हुई, इसे epoch के बाद से मिलीसेकंड में दिखाया जाता है.

तरीके

addUrl()

browser.history.addUrl(
  details: UrlDetails,
): Promise<void>

यह "लिंक" के ट्रांज़िशन टाइप के साथ, मौजूदा समय में इतिहास में एक यूआरएल जोड़ता है.

पैरामीटर

• विवरण

  UrlDetails

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

deleteAll()

browser.history.deleteAll(): Promise<void>

इस निर्देश से इतिहास में मौजूद सभी आइटम मिट जाते हैं.

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

deleteRange()

browser.history.deleteRange(
  range: object,
): Promise<void>

यह इतिहास से, तय की गई तारीख की सीमा के सभी आइटम हटा देता है. पेजों को इतिहास से तब तक नहीं हटाया जाएगा, जब तक कि सभी विज़िट, चुनी गई समयावधि के अंदर न हों.

पैरामीटर

• सीमा

  ऑब्जेक्ट

  • endTime

    संख्या

    इस तारीख से पहले इतिहास में जोड़े गए आइटम. इन्हें Epoch के बाद से मिलीसेकंड में दिखाया जाता है.

  • startTime

    संख्या

    इस तारीख के बाद इतिहास में जोड़े गए आइटम. इन्हें Epoch के बाद से मिलीसेकंड में दिखाया जाता है.

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

deleteUrl()

browser.history.deleteUrl(
  details: UrlDetails,
): Promise<void>

इतिहास से दिए गए यूआरएल के सभी इंस्टेंस हटाता है.

पैरामीटर

• विवरण

  UrlDetails

रिटर्न

• वादा<शून्य>

  Chrome 96+ Chrome 148 से browser.*

getVisits()

browser.history.getVisits(
  details: UrlDetails,
): Promise<VisitItem[]>

यह किसी यूआरएल पर की गई विज़िट की जानकारी हासिल करता है.

पैरामीटर

• विवरण

  UrlDetails

रिटर्न

• <VisitItem[]> प्रॉमिस करें

  Chrome 96+ Chrome 148 से browser.*

search()

browser.history.search(
  query: object,
): Promise<HistoryItem[]>

क्वेरी से मैच करने वाले हर पेज पर पिछली बार विज़िट किए जाने का समय जानने के लिए, इतिहास खोजता है.

पैरामीटर

• क्वेरी

  ऑब्जेक्ट

  • endTime

    number ज़रूरी नहीं

    नतीजों को इस तारीख से पहले विज़िट किए गए पेजों तक सीमित करें. इसे epoch के बाद से मिलीसेकंड में दिखाया जाता है.

  • maxResults

    number ज़रूरी नहीं

    ज़्यादा से ज़्यादा कितने नतीजे दिखाए जाएं. डिफ़ॉल्ट वैल्यू 100 होती है.

  • startTime

    number ज़रूरी नहीं

    नतीजों को इस तारीख के बाद विज़िट किए गए पेजों तक सीमित करें. इसे epoch के बाद से मिलीसेकंड में दिखाया जाता है. अगर प्रॉपर्टी की वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से 24 घंटे की वैल्यू सेट हो जाएगी.

  • टेक्स्ट

    स्ट्रिंग

    इतिहास की सेवा के लिए फ़्री-टेक्स्ट क्वेरी. सभी पेज वापस पाने के लिए, इसे खाली छोड़ दें.

रिटर्न

• वादा<HistoryItem[]>

  Chrome 96+ Chrome 148 से browser.*

इवेंट

onVisited

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

यह इवेंट तब ट्रिगर होता है, जब किसी यूआरएल पर विज़िट किया जाता है. इससे उस यूआरएल के लिए HistoryItem डेटा मिलता है. यह इवेंट, पेज लोड होने से पहले ट्रिगर होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर कुछ ऐसा दिखता है:

  (result: HistoryItem) => void

  • नतीजा

    HistoryItem

onVisitRemoved

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

इतिहास से एक या उससे ज़्यादा यूआरएल हटाए जाने पर ट्रिगर होता है. सभी विज़िट हटा दिए जाने के बाद, यूआरएल को इतिहास से मिटा दिया जाता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर कुछ ऐसा दिखता है:

  (removed: object) => void

  • निकाला गया

    ऑब्जेक्ट

    • allHistory

      बूलियन

      अगर पूरा इतिहास हटा दिया गया है, तो True. अगर यह वैल्यू 'सही है' पर सेट है, तो यूआरएल खाली रहेंगे.

    • यूआरएल

      string[] ज़रूरी नहीं