chrome.history

ब्यौरा

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

अनुमतियां

history

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

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

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

सिद्धांत और इस्तेमाल

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

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

उदाहरण

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

टाइप

HistoryItem

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

प्रॉपर्टी

  • id

    स्ट्रिंग

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

  • lastVisitTime

    नंबर ज़रूरी नहीं

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

  • title

    स्ट्रिंग ज़रूरी नहीं

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

  • typedCount

    नंबर ज़रूरी नहीं

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

  • यूआरएल

    स्ट्रिंग ज़रूरी नहीं

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

  • visitCount

    नंबर ज़रूरी नहीं

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

TransitionType

Chrome 44 और इसके बाद के वर्शन

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

Enum

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

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

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

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

"Manual_subframe"
उपयोगकर्ता किसी सबफ़्रेम में कुछ चुनकर इस पेज पर पहुंचा.

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

"auto_toplevel"
पेज के बारे में कमांड लाइन में बताया गया था या यह स्टार्ट पेज है.

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

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

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

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

UrlDetails

Chrome 88+

प्रॉपर्टी

  • यूआरएल

    स्ट्रिंग

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

VisitItem

यूआरएल पर एक विज़िट को शामिल करने वाला ऑब्जेक्ट.

प्रॉपर्टी

  • id

    स्ट्रिंग

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

  • isLocal

    boolean

    Chrome 115 और उसके बाद के वर्शन

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

  • referringVisitId

    स्ट्रिंग

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

  • ट्रांज़िशन

    TransitionType

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

  • visitId

    स्ट्रिंग

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

  • visitTime

    नंबर ज़रूरी नहीं

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

तरीके

addUrl()

वादा 
chrome.history.addUrl(
  details: UrlDetails,
  callback?: function,
)

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

पैरामीटर

  • विवरण

    UrlDetails

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 96 के बाद के वर्शन

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

deleteAll()

वादा 
chrome.history.deleteAll(
  callback?: function,
)

इतिहास से सभी आइटम मिटाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 96 के बाद के वर्शन

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

deleteRange()

वादा 
chrome.history.deleteRange(
  range: object,
  callback?: function,
)

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

पैरामीटर

  • सीमा

    ऑब्जेक्ट

    • endTime

      नंबर

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

    • startTime

      नंबर

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 96 के बाद के वर्शन

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

deleteUrl()

वादा 
chrome.history.deleteUrl(
  details: UrlDetails,
  callback?: function,
)

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

पैरामीटर

  • विवरण

    UrlDetails

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 96 के बाद के वर्शन

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

getVisits()

वादा 
chrome.history.getVisits(
  details: UrlDetails,
  callback?: function,
)

किसी यूआरएल पर जाने के बारे में जानकारी लाता है.

पैरामीटर

  • विवरण

    UrlDetails

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (results: VisitItem[])=>void

रिटर्न

  • Promise<VisitItem[]>

    Chrome 96 के बाद के वर्शन

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

वादा 
chrome.history.search(
  query: object,
  callback?: function,
)

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

पैरामीटर

  • query

    ऑब्जेक्ट

    • endTime

      नंबर ज़रूरी नहीं

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

    • maxResults

      नंबर ज़रूरी नहीं

      पुनर्प्राप्त करने के लिए परिणामों की अधिकतम संख्या. डिफ़ॉल्ट वैल्यू 100 होती है.

    • startTime

      नंबर ज़रूरी नहीं

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

    • टेक्स्ट

      स्ट्रिंग

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (results: HistoryItem[])=>void

रिटर्न

  • Promise<HistoryItem[]>

    Chrome 96 के बाद के वर्शन

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

इवेंट

onVisited

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (result: HistoryItem)=>void

onVisitRemoved

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (removed: object)=>void

    • हटाया

      ऑब्जेक्ट

      • allHistory

        boolean

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

      • urls

        स्ट्रिंग[] ज़रूरी नहीं है