browser.webNavigation

ब्यौरा

chrome.webNavigation एपीआई का इस्तेमाल करके, नेविगेशन के अनुरोधों की स्थिति के बारे में सूचनाएं पाएं.

अनुमतियां

webNavigation

browser.webNavigation के सभी तरीकों और इवेंट के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "webNavigation" की अनुमति का एलान करना होगा. उदाहरण के लिए:

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

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

इवेंट का क्रम

नेविगेशन पूरा होने पर, इवेंट इस क्रम में ट्रिगर होते हैं:

onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted

इस प्रोसेस के दौरान कोई भी गड़बड़ी होने पर, onErrorOccurred इवेंट ट्रिगर होता है. किसी खास नेविगेशन के लिए, onErrorOccurred के बाद कोई और इवेंट ट्रिगर नहीं होता.

अगर नेविगेट करने वाले फ़्रेम में सबफ़्रेम शामिल हैं, तो उसके किसी भी चाइल्ड फ़्रेम के onBeforeNavigate से पहले, उसका onCommitted ट्रिगर होता है. वहीं, उसके सभी चाइल्ड फ़्रेम के onCompleted के बाद, उसका onCompleted ट्रिगर होता है.

किसी फ़्रेम के रेफ़रंस फ़्रैगमेंट में बदलाव होने पर, onReferenceFragmentUpdated इवेंट ट्रिगर होता है. यह इवेंट, onDOMContentLoaded के बाद कभी भी ट्रिगर हो सकता है. भले ही, onCompleted के बाद हो.

अगर फ़्रेम की स्थिति में बदलाव करने के लिए history API का इस्तेमाल किया जाता है, तो history.pushState() का इस्तेमाल करने पर, onHistoryStateUpdated इवेंट ट्रिगर होता है. यह इवेंट, onDOMContentLoaded के बाद कभी भी ट्रिगर हो सकता है.

अगर नेविगेशन की वजह से किसी पेज को बैक-फ़ॉरवर्ड कैश मेमोरी से वापस लाया जाता है, तो onDOMContentLoaded इवेंट ट्रिगर नहीं होगा. यह इवेंट ट्रिगर नहीं होता, क्योंकि जब पहली बार पेज पर विज़िट किया गया था, तब कॉन्टेंट पहले ही लोड हो चुका था.

अगर नेविगेशन को Chrome इंस्टेंट या Instant Pages का इस्तेमाल करके ट्रिगर किया गया था, तो पूरी तरह से लोड हो चुके पेज को मौजूदा टैब में बदल दिया जाता है. ऐसे में, onTabReplaced इवेंट ट्रिगर होता है.

webRequest इवेंट से संबंध

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

आम तौर पर, webNavigation इवेंट, यूज़र इंटरफ़ेस (यूआई) में दिखने वाली नेविगेशन की स्थिति से काफ़ी हद तक जुड़े होते हैं. वहीं, webRequest इवेंट, नेटवर्क स्टैक की स्थिति से जुड़े होते हैं. आम तौर पर, यह स्थिति उपयोगकर्ता को नहीं दिखती.

टैब के आईडी

नेविगेट किए जा रहे सभी टैब, Chrome के यूज़र इंटरफ़ेस (यूआई) में मौजूद असल टैब से मेल नहीं खाते. उदाहरण के लिए, ऐसा टैब जिसे पहले से रेंडर किया जा रहा है. Tabs API का इस्तेमाल करके, ऐसे टैब ऐक्सेस नहीं किए जा सकते. साथ ही, webNavigation.getFrame() या webNavigation.getAllFrames() पर कॉल करके, उनके बारे में जानकारी का अनुरोध भी नहीं किया जा सकता. इस तरह का टैब स्वैप किए जाने के बाद, onTabReplaced इवेंट ट्रिगर होता है. इसके बाद, इन एपीआई के ज़रिए उन्हें ऐक्सेस किया जा सकता है.

टाइमस्टैंप

यह ध्यान रखना ज़रूरी है कि ओएस में Chrome की अलग-अलग प्रोसेस को मैनेज करने से जुड़ी कुछ तकनीकी समस्याओं की वजह से, ब्राउज़र और एक्सटेंशन प्रोसेस के बीच घड़ी का समय अलग-अलग हो सकता है. इसका मतलब है कि WebNavigation इवेंट की timeStamp प्रॉपर्टी की timeStamp प्रॉपर्टी, सिर्फ़ इंटरनल तौर पर एक जैसी होगी. एक इवेंट की तुलना दूसरे इवेंट से करने पर, आपको उनके बीच का सही ऑफ़सेट मिलेगा. हालांकि, एक्सटेंशन में मौजूद मौजूदा समय से उनकी तुलना करने पर (उदाहरण के लिए, (new Date()).getTime() का इस्तेमाल करके), आपको अनचाहे नतीजे मिल सकते हैं.

फ़्रेम आईडी

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

Chrome में एक साथ कई प्रोसेस चलती हैं. इसलिए, कोई टैब किसी वेब पेज के सोर्स और डेस्टिनेशन को रेंडर करने के लिए अलग-अलग प्रोसेस का इस्तेमाल कर सकता है. इसलिए, अगर किसी नई प्रोसेस में नेविगेशन होता है, तो आपको नए और पुराने, दोनों पेजों से इवेंट मिल सकते हैं.ऐसा तब तक होता है, जब तक नया नेविगेशन पूरा नहीं हो जाता. इसका मतलब है कि onCommitted इवेंट को नए मेन फ़्रेम के लिए भेजा जाता है. दूसरे शब्दों में कहें, तो एक ही frameId के साथ webNavigation इवेंट के एक से ज़्यादा ऐसे सीक्वेंस हो सकते हैं जो अभी पूरे नहीं हुए हैं. processId कुंजी की मदद से, सिक्वेंस के बीच अंतर किया जा सकता है.

यह भी ध्यान दें कि कुछ समय के लिए लोड होने के दौरान, प्रोसेस को कई बार स्विच किया जा सकता है. ऐसा तब होता है, जब लोड को किसी दूसरी साइट पर रीडायरेक्ट किया जाता है. इस मामले में, आपको onBeforeNavigate और onErrorOccurred इवेंट बार-बार मिलेंगे. ऐसा तब तक होगा, जब तक आपको फ़ाइनल onCommitted इवेंट नहीं मिल जाता.

एक्सटेंशन के साथ एक और समस्या यह है कि फ़्रेम का लाइफ़साइकल कैसा होना चाहिए. कोई फ़्रेम, किसी दस्तावेज़ को होस्ट करता है. यह दस्तावेज़, किसी यूआरएल से जुड़ा होता है. दस्तावेज़ में बदलाव किया जा सकता है (जैसे, नेविगेट करके), लेकिन frameId में बदलाव नहीं होगा. इसलिए, किसी खास दस्तावेज़ में हुई किसी गतिविधि को सिर्फ़ frameId से जोड़ना मुश्किल है. हम documentId का कॉन्सेप्ट पेश कर रहे हैं. यह हर दस्तावेज़ के लिए यूनीक आइडेंटिफ़ायर होता है. अगर किसी फ़्रेम पर नेविगेट किया जाता है और वह नया दस्तावेज़ खोलता है, तो आइडेंटिफ़ायर बदल जाएगा. यह फ़ील्ड यह तय करने में मददगार होता है कि पेज कब अपनी लाइफ़साइकल की स्थिति बदलते हैं (प्रीरेंडर/ऐक्टिव/कैश किए गए के बीच), क्योंकि यह एक जैसा रहता है.

ट्रांज़िशन टाइप और क्वालिफ़ायर

webNavigation onCommitted इवेंट में, transitionType और transitionQualifiers प्रॉपर्टी है. ट्रांज़िशन टाइप वही होता है जिसका इस्तेमाल history API में किया जाता है. इससे यह पता चलता है कि ब्राउज़र इस यूआरएल पर कैसे पहुंचा. इसके अलावा, कई ट्रांज़िशन क्वालिफ़ायर भी दिखाए जा सकते हैं, जिनसे नेविगेशन के बारे में ज़्यादा जानकारी मिलती है.

ये ट्रांज़िशन क्वालिफ़ायर मौजूद हैं:

ट्रांज़िशन क्वालीफ़ायरब्यौरा
"client_redirect"नेविगेशन के दौरान, पेज पर JavaScript या मेटा रीफ़्रेश टैग की वजह से एक या उससे ज़्यादा रीडायरेक्ट हुए.
"server_redirect"नेविगेशन के दौरान, सर्वर से भेजे गए एचटीटीपी हेडर की वजह से एक या उससे ज़्यादा बार रीडायरेक्ट किया गया.
"forward_back"उपयोगकर्ता ने नेविगेशन शुरू करने के लिए, 'आगे जाएं' या 'वापस जाएं' बटन का इस्तेमाल किया हो.
"from_address_bar"उपयोगकर्ता ने पता बार (जिसे ओम्निबॉक्स भी कहा जाता है) से नेविगेशन शुरू किया.

उदाहरण

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

टाइप

TransitionQualifier

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

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

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

नेविगेशन की वजह. इतिहास के एपीआई में बताए गए ट्रांज़िशन टाइप का इस्तेमाल किया जाता है. ये ट्रांज़िशन टाइप, history API में बताए गए ट्रांज़िशन टाइप के जैसे ही होते हैं. हालांकि, पुराने सिस्टम के साथ काम करने की सुविधा के लिए, इनमें "auto_toplevel" की जगह "start_page" का इस्तेमाल किया जाता है.

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"generated"

"start_page"

"form_submit"

"reload"

"keyword"

"keyword_generated"

तरीके

getAllFrames()

chrome.webNavigation.getAllFrames(
  details: object,
): Promise<object[] | undefined>

यह कुकी, किसी टैब के सभी फ़्रेम के बारे में जानकारी इकट्ठा करती है.

पैरामीटर

  • विवरण

    ऑब्जेक्ट

    उस टैब के बारे में जानकारी जिससे सभी फ़्रेम वापस पाने हैं.

    • tabId

      संख्या

      टैब का आईडी.

रिटर्न

  • Promise<object[] | undefined>

    Chrome 93 या इसके बाद का वर्शन

getFrame()

chrome.webNavigation.getFrame(
  details: object,
): Promise<object | undefined>

यह दिए गए फ़्रेम के बारे में जानकारी वापस लाता है. फ़्रेम का मतलब किसी वेब पेज के <iframe> या <frame> से है. इसकी पहचान टैब आईडी और फ़्रेम आईडी से होती है.

पैरामीटर

  • विवरण

    ऑब्जेक्ट

    जिस फ़्रेम के बारे में जानकारी चाहिए उसकी जानकारी.

    • documentId

      string ज़रूरी नहीं है

      Chrome 106 या इसके बाद के वर्शन

      दस्तावेज़ का यूयूआईडी. अगर frameId और/या tabId दिए जाते हैं, तो उनकी पुष्टि की जाएगी. इससे यह पता चलेगा कि वे दिए गए दस्तावेज़ आईडी से मिले दस्तावेज़ से मेल खाते हैं या नहीं.

    • frameId

      number ज़रूरी नहीं

      दिए गए टैब में फ़्रेम का आईडी.

    • processId

      number ज़रूरी नहीं

      Chrome 49 के बाद से काम नहीं करता

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

      उस प्रोसेस का आईडी जो इस टैब के लिए रेंडरर चलाती है.

    • tabId

      number ज़रूरी नहीं

      उस टैब का आईडी जिसमें फ़्रेम मौजूद है.

रिटर्न

  • Promise<object | undefined>

    Chrome 93 या इसके बाद का वर्शन

इवेंट

onBeforeNavigate

chrome.webNavigation.onBeforeNavigate.addListener(
  callback: function,
  filters?: object,
)

यह इवेंट तब ट्रिगर होता है, जब नेविगेशन शुरू होने वाला होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • Chrome 106 या इसके बाद के वर्शन

        दस्तावेज़ का लाइफ़साइकल.

      • frameId

        संख्या

        0 का मतलब है कि नेविगेशन, टैब के कॉन्टेंट विंडो में होता है. पॉज़िटिव वैल्यू का मतलब है कि नेविगेशन, सबफ़्रेम में होता है. फ़्रेम आईडी, किसी टैब और प्रोसेस के लिए यूनीक होते हैं.

      • Chrome 106 या इसके बाद के वर्शन

        नेविगेशन किस तरह के फ़्रेम में हुआ.

      • parentDocumentId

        string ज़रूरी नहीं है

        Chrome 106 या इसके बाद के वर्शन

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

      • parentFrameId

        संख्या

        पैरंट फ़्रेम का आईडी या अगर यह मुख्य फ़्रेम है, तो -1.

      • processId

        संख्या

        Chrome 50 के बाद से काम नहीं करता

        इस इवेंट के लिए processId अब सेट नहीं किया गया है, क्योंकि onCommit तक यह पता नहीं चलता कि कौनसा प्रोसेस, नतीजे के तौर पर मिले दस्तावेज़ को रेंडर करेगा.

        वैल्यू -1.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन होने वाला है.

      • timeStamp

        संख्या

        वह समय जब ब्राउज़र ने नेविगेशन शुरू किया था. यह समय, epoch के बाद से मिलीसेकंड में होता है.

      • url

        स्ट्रिंग

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onCommitted

chrome.webNavigation.onCommitted.addListener(
  callback: function,
  filters?: object,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • documentId

        स्ट्रिंग

        Chrome 106 या इसके बाद के वर्शन

        लोड किए गए दस्तावेज़ का यूयूआईडी.

      • Chrome 106 या इसके बाद के वर्शन

        दस्तावेज़ का लाइफ़साइकल.

      • frameId

        संख्या

        0 का मतलब है कि नेविगेशन, टैब के कॉन्टेंट विंडो में होता है. पॉज़िटिव वैल्यू का मतलब है कि नेविगेशन, सबफ़्रेम में होता है. फ़्रेम आईडी, टैब में यूनीक होते हैं.

      • Chrome 106 या इसके बाद के वर्शन

        नेविगेशन किस तरह के फ़्रेम में हुआ.

      • parentDocumentId

        string ज़रूरी नहीं है

        Chrome 106 या इसके बाद के वर्शन

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

      • parentFrameId

        संख्या

        Chrome 74 या इसके बाद का वर्शन

        पैरंट फ़्रेम का आईडी या अगर यह मुख्य फ़्रेम है, तो -1.

      • processId

        संख्या

        उस प्रोसेस का आईडी जो इस फ़्रेम के लिए रेंडरर चलाती है.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन होता है.

      • timeStamp

        संख्या

        epoch के बाद से मिलीसेकंड में वह समय जब नेविगेशन शुरू किया गया था.

      • transitionQualifiers

        TransitionQualifier[]

        ट्रांज़िशन क्वालिफ़ायर की सूची.

      • transitionType

        TransitionType

        नेविगेशन की वजह.

      • url

        स्ट्रिंग

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onCompleted

chrome.webNavigation.onCompleted.addListener(
  callback: function,
  filters?: object,
)

यह इवेंट तब ट्रिगर होता है, जब दस्तावेज़ और उससे जुड़े सभी संसाधन पूरी तरह से लोड हो जाते हैं और शुरू हो जाते हैं.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • documentId

        स्ट्रिंग

        Chrome 106 या इसके बाद के वर्शन

        लोड किए गए दस्तावेज़ का यूयूआईडी.

      • Chrome 106 या इसके बाद के वर्शन

        दस्तावेज़ का लाइफ़साइकल.

      • frameId

        संख्या

        0 का मतलब है कि नेविगेशन, टैब के कॉन्टेंट विंडो में होता है. पॉज़िटिव वैल्यू का मतलब है कि नेविगेशन, सबफ़्रेम में होता है. फ़्रेम आईडी, टैब में यूनीक होते हैं.

      • Chrome 106 या इसके बाद के वर्शन

        नेविगेशन किस तरह के फ़्रेम में हुआ.

      • parentDocumentId

        string ज़रूरी नहीं है

        Chrome 106 या इसके बाद के वर्शन

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

      • parentFrameId

        संख्या

        Chrome 74 या इसके बाद का वर्शन

        पैरंट फ़्रेम का आईडी या अगर यह मुख्य फ़्रेम है, तो -1.

      • processId

        संख्या

        उस प्रोसेस का आईडी जो इस फ़्रेम के लिए रेंडरर चलाती है.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन होता है.

      • timeStamp

        संख्या

        वह समय, जब दस्तावेज़ लोड हो गया था. यह समय, epoch के बाद से मिलीसेकंड में होता है.

      • url

        स्ट्रिंग

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onCreatedNavigationTarget

chrome.webNavigation.onCreatedNavigationTarget.addListener(
  callback: function,
  filters?: object,
)

यह इवेंट तब ट्रिगर होता है, जब नेविगेशन को होस्ट करने के लिए कोई नई विंडो या मौजूदा विंडो में कोई नया टैब बनाया जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • sourceFrameId

        संख्या

        उस फ़्रेम का आईडी जिसमें sourceTabId मौजूद है और जिसमें नेविगेशन ट्रिगर किया गया है. 0 का मतलब मुख्य फ़्रेम है.

      • sourceProcessId

        संख्या

        यह उस प्रोसेस का आईडी होता है जो सोर्स फ़्रेम के लिए रेंडरर चलाती है.

      • sourceTabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन ट्रिगर किया गया है.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें यूआरएल खोला गया है

      • timeStamp

        संख्या

        यह उस समय को दिखाता है, जब ब्राउज़र नया व्यू बनाने वाला था. यह समय, epoch के बाद से मिलीसेकंड में होता है.

      • url

        स्ट्रिंग

        वह यूआरएल जिसे नई विंडो में खोलना है.

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onDOMContentLoaded

chrome.webNavigation.onDOMContentLoaded.addListener(
  callback: function,
  filters?: object,
)

यह इवेंट तब ट्रिगर होता है, जब पेज का DOM पूरी तरह से बन जाता है. हालांकि, ऐसा हो सकता है कि रेफ़र किए गए संसाधन लोड न हों.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • documentId

        स्ट्रिंग

        Chrome 106 या इसके बाद के वर्शन

        लोड किए गए दस्तावेज़ का यूयूआईडी.

      • Chrome 106 या इसके बाद के वर्शन

        दस्तावेज़ का लाइफ़साइकल.

      • frameId

        संख्या

        0 का मतलब है कि नेविगेशन, टैब के कॉन्टेंट विंडो में होता है. पॉज़िटिव वैल्यू का मतलब है कि नेविगेशन, सबफ़्रेम में होता है. फ़्रेम आईडी, टैब में यूनीक होते हैं.

      • Chrome 106 या इसके बाद के वर्शन

        नेविगेशन किस तरह के फ़्रेम में हुआ.

      • parentDocumentId

        string ज़रूरी नहीं है

        Chrome 106 या इसके बाद के वर्शन

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

      • parentFrameId

        संख्या

        Chrome 74 या इसके बाद का वर्शन

        पैरंट फ़्रेम का आईडी या अगर यह मुख्य फ़्रेम है, तो -1.

      • processId

        संख्या

        उस प्रोसेस का आईडी जो इस फ़्रेम के लिए रेंडरर चलाती है.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन होता है.

      • timeStamp

        संख्या

        यह मेट्रिक, उस समय के बारे में बताती है जब पेज का DOM पूरी तरह से बन गया था. यह समय, epoch के बाद से मिलीसेकंड में होता है.

      • url

        स्ट्रिंग

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onErrorOccurred

chrome.webNavigation.onErrorOccurred.addListener(
  callback: function,
  filters?: object,
)

यह इवेंट तब ट्रिगर होता है, जब कोई गड़बड़ी होती है और नेविगेशन बंद हो जाता है. ऐसा तब हो सकता है, जब नेटवर्क की कोई गड़बड़ी हुई हो या उपयोगकर्ता ने नेविगेशन बंद कर दिया हो.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • documentId

        स्ट्रिंग

        Chrome 106 या इसके बाद के वर्शन

        लोड किए गए दस्तावेज़ का यूयूआईडी.

      • Chrome 106 या इसके बाद के वर्शन

        दस्तावेज़ का लाइफ़साइकल.

      • गड़बड़ी

        स्ट्रिंग

        गड़बड़ी की जानकारी.

      • frameId

        संख्या

        0 का मतलब है कि नेविगेशन, टैब के कॉन्टेंट विंडो में होता है. पॉज़िटिव वैल्यू का मतलब है कि नेविगेशन, सबफ़्रेम में होता है. फ़्रेम आईडी, टैब में यूनीक होते हैं.

      • Chrome 106 या इसके बाद के वर्शन

        नेविगेशन किस तरह के फ़्रेम में हुआ.

      • parentDocumentId

        string ज़रूरी नहीं है

        Chrome 106 या इसके बाद के वर्शन

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

      • parentFrameId

        संख्या

        Chrome 74 या इसके बाद का वर्शन

        पैरंट फ़्रेम का आईडी या अगर यह मुख्य फ़्रेम है, तो -1.

      • processId

        संख्या

        Chrome 50 के बाद से काम नहीं करता

        इस इवेंट के लिए, processId अब सेट नहीं किया गया है.

        वैल्यू -1.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन होता है.

      • timeStamp

        संख्या

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

      • url

        स्ट्रिंग

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onHistoryStateUpdated

chrome.webNavigation.onHistoryStateUpdated.addListener(
  callback: function,
  filters?: object,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • documentId

        स्ट्रिंग

        Chrome 106 या इसके बाद के वर्शन

        लोड किए गए दस्तावेज़ का यूयूआईडी.

      • Chrome 106 या इसके बाद के वर्शन

        दस्तावेज़ का लाइफ़साइकल.

      • frameId

        संख्या

        0 का मतलब है कि नेविगेशन, टैब के कॉन्टेंट विंडो में होता है. पॉज़िटिव वैल्यू का मतलब है कि नेविगेशन, सबफ़्रेम में होता है. फ़्रेम आईडी, टैब में यूनीक होते हैं.

      • Chrome 106 या इसके बाद के वर्शन

        नेविगेशन किस तरह के फ़्रेम में हुआ.

      • parentDocumentId

        string ज़रूरी नहीं है

        Chrome 106 या इसके बाद के वर्शन

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

      • parentFrameId

        संख्या

        Chrome 74 या इसके बाद का वर्शन

        पैरंट फ़्रेम का आईडी या अगर यह मुख्य फ़्रेम है, तो -1.

      • processId

        संख्या

        उस प्रोसेस का आईडी जो इस फ़्रेम के लिए रेंडरर चलाती है.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन होता है.

      • timeStamp

        संख्या

        epoch के बाद से मिलीसेकंड में वह समय जब नेविगेशन शुरू किया गया था.

      • transitionQualifiers

        TransitionQualifier[]

        ट्रांज़िशन क्वालिफ़ायर की सूची.

      • transitionType

        TransitionType

        नेविगेशन की वजह.

      • url

        स्ट्रिंग

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onReferenceFragmentUpdated

chrome.webNavigation.onReferenceFragmentUpdated.addListener(
  callback: function,
  filters?: object,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • documentId

        स्ट्रिंग

        Chrome 106 या इसके बाद के वर्शन

        लोड किए गए दस्तावेज़ का यूयूआईडी.

      • Chrome 106 या इसके बाद के वर्शन

        दस्तावेज़ का लाइफ़साइकल.

      • frameId

        संख्या

        0 का मतलब है कि नेविगेशन, टैब के कॉन्टेंट विंडो में होता है. पॉज़िटिव वैल्यू का मतलब है कि नेविगेशन, सबफ़्रेम में होता है. फ़्रेम आईडी, टैब में यूनीक होते हैं.

      • Chrome 106 या इसके बाद के वर्शन

        नेविगेशन किस तरह के फ़्रेम में हुआ.

      • parentDocumentId

        string ज़रूरी नहीं है

        Chrome 106 या इसके बाद के वर्शन

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

      • parentFrameId

        संख्या

        Chrome 74 या इसके बाद का वर्शन

        पैरंट फ़्रेम का आईडी या अगर यह मुख्य फ़्रेम है, तो -1.

      • processId

        संख्या

        उस प्रोसेस का आईडी जो इस फ़्रेम के लिए रेंडरर चलाती है.

      • tabId

        संख्या

        उस टैब का आईडी जिसमें नेविगेशन होता है.

      • timeStamp

        संख्या

        epoch के बाद से मिलीसेकंड में वह समय जब नेविगेशन शुरू किया गया था.

      • transitionQualifiers

        TransitionQualifier[]

        ट्रांज़िशन क्वालिफ़ायर की सूची.

      • transitionType

        TransitionType

        नेविगेशन की वजह.

      • url

        स्ट्रिंग

  • फ़िल्टर

    object ज़रूरी नहीं है

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

onTabReplaced

chrome.webNavigation.onTabReplaced.addListener(
  callback: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • replacedTabId

        संख्या

        बदले गए टैब का आईडी.

      • tabId

        संख्या

        उस टैब का आईडी जिसने पुराने टैब की जगह ली है.

      • timeStamp

        संख्या

        Epoch के बाद से मिलीसेकंड में, वह समय जब बदलाव हुआ था.