ब्यौरा
ब्राउज़र के देखे गए पेजों के रिकॉर्ड के साथ इंटरैक्ट करने के लिए, chrome.history एपीआई का इस्तेमाल करें. ब्राउज़र के इतिहास में जाकर, यूआरएल जोड़े जा सकते हैं, हटाए जा सकते हैं, और उनके लिए क्वेरी की जा सकती है. इतिहास पेज को अपने वर्शन से बदलने के लिए, पेज बदलना लेख पढ़ें.
अनुमतियां
historyमेनिफ़ेस्ट
आपको "इतिहास" का एलान करना होगा इतिहास एपीआई का इस्तेमाल करने के लिए एक्सटेंशन मेनिफ़ेस्ट में अनुमति. इसके लिए उदाहरण:
{
"name": "My extension",
...
"permissions": [
"history"
],
...
}
ट्रांज़िशन के टाइप
इतिहास एपीआई ट्रांज़िशन के तरीके का इस्तेमाल करके यह बताता है कि ब्राउज़र किसी खास यूआरएल पर कैसे गया. एक खास विज़िट पर. उदाहरण के लिए, अगर कोई उपयोगकर्ता किसी अन्य पेज पर दिए गए लिंक पर क्लिक करके उस पेज पर जाता है, ट्रांज़िशन टाइप "लिंक" है.
नीचे दी गई टेबल में, अलग-अलग तरह के ट्रांज़िशन की जानकारी दी गई है.
| ट्रांज़िशन टाइप | ब्यौरा |
|---|---|
| "लिंक" | उपयोगकर्ता किसी अन्य पेज पर मौजूद लिंक पर क्लिक करने से इस पेज पर आया है. |
| "typed" | उपयोगकर्ता को यह पेज, पता बार में यूआरएल टाइप करने से मिला है. इसका इस्तेमाल नेविगेशन से जुड़ी अन्य कार्रवाइयों के लिए भी किया जाता है. जनरेट किया गया भी देखें. इसका इस्तेमाल उन मामलों में किया जाता है जहां उपयोगकर्ता ने कोई ऐसा विकल्प चुना है जो यूआरएल जैसा नहीं दिखता. |
| "auto_bookmark" | उपयोगकर्ता इस पेज पर यूज़र इंटरफ़ेस (यूआई) में दिए गए सुझाव से आया था—उदाहरण के लिए, मेन्यू आइटम से. |
| "auto_subframe" | सबफ़्रेम नेविगेशन. यह ऐसा कोई भी कॉन्टेंट है जो किसी नॉन-टॉप-लेवल फ़्रेम में अपने-आप लोड होता है. उदाहरण के लिए, यदि किसी पृष्ठ में विज्ञापन वाले कई फ़्रेम हैं, तो उन विज्ञापन URL में यह ट्रांज़िशन प्रकार होगा. ऐसा हो सकता है कि उपयोगकर्ता को पता ही न हो कि इन पेजों में मौजूद कॉन्टेंट एक अलग फ़्रेम है. इसलिए, हो सकता है कि उसे यूआरएल की परवाह न हो (manual_subframe भी देखें). |
| "मैन्युअल_सबफ़्रेम" | उपयोगकर्ता के साफ़ तौर पर अनुरोध किए गए सबफ़्रेम नेविगेशन के लिए और बैक-फ़ॉरवर्ड सूची में नई नेविगेशन एंट्री जनरेट करने के लिए. हो सकता है कि अपने-आप लोड होने वाले फ़्रेम के मुकाबले, साफ़ तौर पर अनुरोध किया गया फ़्रेम ज़्यादा ज़रूरी हो. इसकी वजह यह हो सकती है कि उपयोगकर्ता को सिर्फ़ यह ध्यान रखना चाहिए कि अनुरोध किया गया फ़्रेम लोड हो गया है. |
| "जनरेट किया गया" | उपयोगकर्ता पता बार में टाइप करके और यूआरएल जैसी नहीं दिखने वाली एंट्री चुनकर इस पेज पर आया है. उदाहरण के लिए, किसी मैच में Google पर खोज नतीजों के पेज का यूआरएल हो सकता है, लेकिन वह उपयोगकर्ता को "Google पर खोजें ..." के तौर पर दिख सकता है. ये टाइप किए गए नेविगेशन से बिलकुल अलग होते हैं, क्योंकि उपयोगकर्ता ने डेस्टिनेशन यूआरएल नहीं टाइप किया या नहीं देखा. कीवर्ड भी देखें. |
| "auto_toplevel" | पेज कमांड लाइन में बताया गया था या यह स्टार्ट पेज है. |
| "form_submit" | उपयोगकर्ता ने फ़ॉर्म में वैल्यू भरकर सबमिट की है. ध्यान दें कि कुछ स्थितियों में, जैसे कि जब किसी फ़ॉर्म में कॉन्टेंट सबमिट करने के लिए स्क्रिप्ट का इस्तेमाल किया जाता है, तब किसी फ़ॉर्म को सबमिट करने का मतलब यह ट्रांज़िशन टाइप नहीं होता. |
| "फिर से लोड करें" | उपयोगकर्ता ने पेज को फिर से लोड करने के लिए, 'फिर से लोड करें' बटन पर क्लिक किया या पता बार में Enter दबाएं. सेशन को पहले जैसा करने और बंद किए गए टैब को फिर से खोलने के लिए भी, इस ट्रांज़िशन टाइप का इस्तेमाल किया जाता है. |
| "कीवर्ड" | यूआरएल, बदले जा सकने वाले कीवर्ड से जनरेट किया गया था. इसमें डिफ़ॉल्ट खोज सेवा देने वाली कंपनी शामिल नहीं थी. keyword_generated को भी देखें. |
| "keyword_generate" | किसी कीवर्ड के लिए जनरेट हुई विज़िट से मेल खाता है. कीवर्ड भी देखें. |
उदाहरण
इस एपीआई को आज़माने के लिए, chrome-extension-samples से इतिहास एपीआई का उदाहरण इंस्टॉल करें डेटा स्टोर करने की जगह.
टाइप
HistoryItem
ऐसा ऑब्जेक्ट जिसमें इतिहास क्वेरी के एक नतीजे को इनकैप्सुलेट किया जाता है.
प्रॉपर्टी
-
आईडी
स्ट्रिंग
आइटम के लिए यूनीक आइडेंटिफ़ायर.
-
lastVisitTime
नंबर वैकल्पिक
जब यह पेज पिछली बार लोड हुआ था, तब इसे epoch के बाद मिलीसेकंड में दिखाया जाता है.
-
title
स्ट्रिंग ज़रूरी नहीं
पेज का वह टाइटल जब इसे पिछली बार लोड किया गया था.
-
typedCount
नंबर वैकल्पिक
पता टाइप करके उपयोगकर्ता ने इस पेज पर कितनी बार नेविगेट किया है.
-
url
स्ट्रिंग ज़रूरी नहीं
वह यूआरएल जिसे उपयोगकर्ता ने नेविगेट किया है.
-
visitCount
नंबर वैकल्पिक
उपयोगकर्ता इस पेज पर कितनी बार गया.
TransitionType
इस विज़िट के लिए रेफ़रर से मिला ट्रांज़िशन टाइप.
Enum
"link"
उपयोगकर्ता किसी दूसरे पेज पर मौजूद लिंक पर क्लिक करके इस पेज पर आया है.
"typed"
उपयोगकर्ता, पता बार में यूआरएल टाइप करके इस पेज पर पहुंचे. इसका इस्तेमाल नेविगेशन से जुड़ी अन्य कार्रवाइयों के लिए भी किया जाता है.
"auto_bookmark"
उपयोगकर्ता इस पेज पर यूज़र इंटरफ़ेस में दिए गए सुझाव के ज़रिए आया है, उदाहरण के लिए, मेन्यू आइटम के ज़रिए.
"auto_subframe"
उपयोगकर्ता इस पेज पर उस सबफ़्रेम नेविगेशन के ज़रिए पहुंचे जिसके लिए उन्होंने अनुरोध नहीं किया है. जैसे, पिछले पेज पर किसी फ़्रेम में विज्ञापन लोड होने से. इनकी वजह से, बैक और फ़ॉरवर्ड मेन्यू में हमेशा नई नेविगेशन एंट्री जनरेट नहीं होती.
"manual_subframe"
उपयोगकर्ता किसी सबफ़्रेम में कुछ चुनकर ही इस पेज पर आया है.
"Generate"
उपयोगकर्ता इस पेज पर आया. इसके लिए, उपयोगकर्ता ने पता बार में टाइप किया. इसके बाद, उसने ऐसी एंट्री चुनी जो यूआरएल जैसी नहीं दिखती थी, जैसे कि Google Search का कोई सुझाव. उदाहरण के लिए, किसी मैच में Google Search के नतीजों के पेज का यूआरएल हो सकता है, लेकिन वह उपयोगकर्ता को "Google पर खोजें ..." के तौर पर दिख सकता है. ये टाइप किए गए नेविगेशन से अलग होते हैं, क्योंकि उपयोगकर्ता ने डेस्टिनेशन यूआरएल (विज्ञापन के लैंडिंग पेज का यूआरएल) टाइप नहीं किया या न ही देखा. ये कीवर्ड, नेविगेशन पर भी लागू होते हैं.
"auto_toplevel"
पेज कमांड लाइन में बताया गया था या यह स्टार्ट पेज है.
"form_submit"
उपयोगकर्ता, फ़ॉर्म में वैल्यू भरकर और फ़ॉर्म सबमिट करके इस पेज पर पहुंचे. सभी फ़ॉर्म सबमिशन में, इस तरह के ट्रांज़िशन का इस्तेमाल नहीं किया जाता.
"फिर से लोड करें"
उपयोगकर्ता ने पेज को फिर से लोड किया. इसके लिए, 'फिर से लोड करें' बटन पर क्लिक करें या पता बार में Enter दबाएं. सेशन को पहले जैसा करने और बंद किए गए टैब को फिर से खोलने के लिए भी, इस ट्रांज़िशन टाइप का इस्तेमाल किया जाता है.
"कीवर्ड"
इस पेज का यूआरएल, बदले जा सकने वाले कीवर्ड से जनरेट किया गया था. यह डिफ़ॉल्ट सर्च प्रोवाइडर से नहीं था.
"keyword_generate"
किसी कीवर्ड के लिए जनरेट हुई विज़िट से मेल खाता है.
UrlDetails
प्रॉपर्टी
-
url
स्ट्रिंग
कार्रवाई का यूआरएल. यह
history.search()पर किए गए कॉल के फ़ॉर्मैट में होना चाहिए.
VisitItem
ऐसा ऑब्जेक्ट जो यूआरएल पर एक विज़िट को एन्क्रिप्ट (सुरक्षित) करता है.
प्रॉपर्टी
-
आईडी
स्ट्रिंग
इससे जुड़े
history.HistoryItemके लिए यूनीक आइडेंटिफ़ायर. -
isLocal
बूलियन
Chrome 115 और उसके बाद वाले वर्शनअगर इस डिवाइस से विज़िट की गई है, तो वैल्यू 'सही' होगी. गलत है, अगर इसे किसी दूसरे डिवाइस से सिंक किया गया था.
-
referringVisitId
स्ट्रिंग
रेफ़रर का विज़िट आईडी.
-
ट्रांज़िशन
इस विज़िट के लिए रेफ़रर से मिला ट्रांज़िशन टाइप.
-
visitId
स्ट्रिंग
इस विज़िट के लिए यूनीक आइडेंटिफ़ायर.
-
visitTime
नंबर वैकल्पिक
यह विज़िट कब हुई, इसे epoch के बाद मिलीसेकंड में दिखाया जाता है.
तरीके
addUrl()
chrome.history.addUrl(
details: UrlDetails,
callback?: function,
)
इससे मौजूदा समय के इतिहास में, "लिंक" के ट्रांज़िशन के टाइप के साथ एक यूआरएल जोड़ा जाता है.
पैरामीटर
-
विवरण
-
कॉलबैक
फ़ंक्शन वैकल्पिक
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,
)
इतिहास से, तय तारीख की सीमा के अंदर के सभी आइटम हटा देता है. पेजों को इतिहास से तब तक नहीं हटाया जाएगा, जब तक सभी विज़िट इस सीमा में नहीं आतीं.
पैरामीटर
-
सीमा
ऑब्जेक्ट
-
endTime
संख्या
इस तारीख से पहले के इतिहास में जोड़े गए आइटम, जो समय के बाद से मिलीसेकंड में दिखाए जाते हैं.
-
startTime
संख्या
इस तारीख के बाद के इतिहास में जोड़े गए आइटम, जो epoch के बाद से मिलीसेकंड में दिखाए जाते हैं.
-
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callbackपैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
deleteUrl()
chrome.history.deleteUrl(
details: UrlDetails,
callback?: function,
)
इतिहास से दिए गए यूआरएल की सभी घटनाएं हटा देता है.
पैरामीटर
-
विवरण
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callbackपैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getVisits()
chrome.history.getVisits(
details: UrlDetails,
callback?: function,
)
किसी यूआरएल पर हुई विज़िट की जानकारी हासिल करता है.
पैरामीटर
-
विवरण
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callbackपैरामीटर ऐसा दिखता है:(results: VisitItem[]) => void
-
नतीजे
-
रिटर्न
-
Promise<VisitItem[]>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
search()
chrome.history.search(
query: object,
callback?: function,
)
क्वेरी से मेल खाने वाले हर पेज के आखिरी विज़िट के समय का इतिहास खोजता है.
पैरामीटर
-
क्वेरी
ऑब्जेक्ट
-
endTime
नंबर वैकल्पिक
इस तारीख से पहले विज़िट किए गए नतीजों को सीमित करें, जो Epoch के बाद से मिलीसेकंड में दिखाए जाते हैं.
-
ज़्यादा से ज़्यादा नतीजे
नंबर वैकल्पिक
वापस लाने के लिए, नतीजों की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट तौर पर, यह 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
बूलियन
अगर पूरा इतिहास हटा दिया गया था, तो सही है. अगर सही है, तो यूआरएल खाली होंगे.
-
यूआरएल
स्ट्रिंग[] ज़रूरी नहीं
-
-