chrome.webviewTag

ब्यौरा

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

अनुमतियां

webview

उपलब्धता

सिर्फ़ ChromeOS के लिए

टाइप

ClearDataOptions

ऐसे विकल्प जिनसे यह तय होता है कि clearData को कौनसा डेटा मिटाना चाहिए.

प्रॉपर्टी

  • प्रारंभ

    number ज़रूरी नहीं

    इस तारीख को या इसके बाद इकट्ठा किया गया डेटा मिटाएं. इसे ईपॉक के बाद से मिलीसेकंड में दिखाया जाता है. इसे JavaScript Date ऑब्जेक्ट के getTime तरीके से ऐक्सेस किया जा सकता है. अगर यह मौजूद नहीं है, तो डिफ़ॉल्ट रूप से 0 पर सेट होता है. इससे ब्राउज़िंग का पूरा डेटा हट जाएगा.

ClearDataTypeSet

डेटा टाइप का एक सेट. जो प्रॉपर्टी मौजूद नहीं हैं उन्हें false के तौर पर माना जाता है.

प्रॉपर्टी

  • appcache

    boolean optional

    वेबसाइटों के ऐप्लिकेशन कैश.

  • कैश मेमोरी

    boolean optional

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

    Chrome 43 से. ब्राउज़र की कैश मेमोरी. ध्यान दें: डेटा हटाने पर, पूरी कैश मेमोरी मिट जाती है. यह सिर्फ़ उस रेंज तक सीमित नहीं होती जिसे आपने तय किया है.

  • कुकी का इस्तेमाल करता है

    boolean optional

    पार्टिशन की कुकी.

  • fileSystems

    boolean optional

    वेबसाइटों के फ़ाइल सिस्टम.

  • indexedDB

    boolean optional

    वेबसाइटों का IndexedDB डेटा.

  • localStorage

    boolean optional

    वेबसाइटों के लोकल स्टोरेज का डेटा.

  • persistentCookies

    boolean optional

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

    पार्टिशन की परसिस्टेंट कुकी.

  • sessionCookies

    boolean optional

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

    पार्टिशन की सेशन कुकी.

  • webSQL

    boolean optional

    वेबसाइटों का WebSQL डेटा.

ContentScriptDetails

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

कॉन्टेंट स्क्रिप्ट डालने के बारे में जानकारी. ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट का दस्तावेज़ देखें.

प्रॉपर्टी

  • all_frames

    boolean optional

    अगर all_frames की वैल्यू true है, तो इसका मतलब है कि JavaScript या सीएसएस को मौजूदा पेज के सभी फ़्रेम में इंजेक्ट किया जाना चाहिए. डिफ़ॉल्ट रूप से, all_frames false होता है. साथ ही, JavaScript या सीएसएस को सिर्फ़ टॉप फ़्रेम में इंजेक्ट किया जाता है.

  • css

    InjectionItems optional

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

  • exclude_globs

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

    मिलान करने के बाद लागू किया जाता है, ताकि इस ग्लोब से मेल खाने वाले यूआरएल को बाहर रखा जा सके. यह @exclude Greasemonkey कीवर्ड की तरह काम करता है.

  • exclude_matches

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

    यह उन पेजों को बाहर रखता है जिनमें यह कॉन्टेंट स्क्रिप्ट डाली जाती है.

  • include_globs

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

    यह फ़िल्टर, मैच होने के बाद लागू होता है. इससे सिर्फ़ वे यूआरएल शामिल किए जाते हैं जो इस ग्लोब से भी मैच होते हैं. इसकी मदद से, @include Greasemonkey कीवर्ड की तरह काम किया जा सकता है.

  • js

    InjectionItems optional

    JavaScript कोड या JavaScript फ़ाइलों की सूची, जिसे मिलते-जुलते पेजों में इंजेक्ट किया जाना है. इन्हें उसी क्रम में डाला जाता है जिस क्रम में ये दिखते हैं.

  • match_about_blank

    boolean optional

    यह तय करता है कि कॉन्टेंट स्क्रिप्ट को about:blank और about:srcdoc पर डाला जाए या नहीं. कॉन्टेंट स्क्रिप्ट सिर्फ़ उन पेजों पर इंजेक्ट की जाएंगी जिनका इनहेरिट किया गया यूआरएल, matches फ़ील्ड में बताए गए किसी पैटर्न से मेल खाता हो. इनहेरिट किया गया यूआरएल, उस दस्तावेज़ का यूआरएल होता है जिसने फ़्रेम या विंडो बनाई है. सैंडबॉक्स किए गए फ़्रेम में कॉन्टेंट स्क्रिप्ट नहीं डाली जा सकतीं.

  • मैच

    string[]

    इससे यह तय किया जाता है कि इस कॉन्टेंट स्क्रिप्ट को किन पेजों में इंजेक्ट किया जाएगा.

  • नाम

    स्ट्रिंग

    इंजेक्ट की जाने वाली कॉन्टेंट स्क्रिप्ट का नाम.

  • run_at

    RunAt optional

    JavaScript या सीएसएस को टैब में जल्द से जल्द इंजेक्ट किया जाएगा. डिफ़ॉल्ट रूप से, इसे "document_idle" पर सेट किया जाता है.

ContentWindow

मेहमान विंडो के लिए मैसेजिंग हैंडल.

प्रॉपर्टी

  • postMessage

    अमान्य

    यह कुकी, एंबेड किए गए वेब कॉन्टेंट को तब तक मैसेज पोस्ट करती है, जब तक एंबेड किया गया कॉन्टेंट टारगेट ऑरिजिन से कोई पेज दिखा रहा हो. यह तरीका तब उपलब्ध होता है, जब पेज पूरी तरह से लोड हो जाता है. contentload इवेंट को सुनें. इसके बाद, इस तरीके को कॉल करें.

    मेहमान, मैसेज इवेंट पर event.source को मैसेज भेजकर, कॉन्टेंट एम्बेड करने वाले व्यक्ति को जवाब भेज सकता है.

    यह एपीआई, वेब पेजों के बीच कम्यूनिकेशन के लिए HTML5 postMessage API जैसा ही है. एम्बेड करने वाला व्यक्ति या कंपनी, अपने फ़्रेम में message इवेंट लिसनर जोड़कर जवाब सुन सकती है.

    postMessage फ़ंक्शन इस तरह दिखता है: 

    (message: any, targetOrigin: string) => {...}

    • मैसेज

      कोई

      मेहमान को भेजने के लिए मैसेज ऑब्जेक्ट.

    • targetOrigin

      स्ट्रिंग

      इससे यह तय होता है कि इवेंट को डिसपैच करने के लिए, मेहमान विंडो का ऑरिजिन क्या होना चाहिए.

ContextMenuCreateProperties

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

प्रॉपर्टी

  • सही का निशान लगाया गया

    boolean optional

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

  • कॉन्टेक्स्ट

    [ContextType, ...ContextType[]] optional

    उन कॉन्टेक्स्ट की सूची जिनमें यह मेन्यू आइटम दिखेगा. अगर कोई वैल्यू तय नहीं की गई है, तो डिफ़ॉल्ट वैल्यू ['page'] होती है.

  • documentUrlPatterns

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

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

  • चालू किया गया

    boolean optional

    यह संदर्भ मेन्यू आइटम चालू है या बंद है. यह डिफ़ॉल्ट रूप से true पर सेट होता है.

  • आईडी

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

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

  • parentId

    string | number ज़रूरी नहीं

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

  • targetUrlPatterns

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

    यह documentUrlPatterns की तरह ही होता है. हालांकि, इससे img/audio/video टैग के src एट्रिब्यूट और ऐंकर टैग के href के आधार पर फ़िल्टर किया जा सकता है.

  • title

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

    आइटम में दिखने वाला टेक्स्ट. अगर type की वैल्यू 'separator' नहीं है, तो यह ज़रूरी है. जब कॉन्टेक्स्ट 'selection' होता है, तब चुने गए टेक्स्ट को दिखाने के लिए, स्ट्रिंग में %s का इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर इस पैरामीटर की वैल्यू "Translate '%s' to Pig Latin" है और उपयोगकर्ता "cool" शब्द चुनता है, तो चुने गए शब्द के लिए कॉन्टेक्स्ट मेन्यू आइटम "Translate 'cool' to Pig Latin" होगा.

  • टाइप

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

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

  • onclick

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

    यह एक ऐसा फ़ंक्शन है जिसे मेन्यू आइटम पर क्लिक करने पर वापस कॉल किया जाएगा.

    onclick फ़ंक्शन इस तरह दिखता है: 

    (info: OnClickData) => {...}

    • जानकारी

      OnClickData

      क्लिक किए गए आइटम और उस कॉन्टेक्स्ट के बारे में जानकारी जहां क्लिक किया गया था.

ContextMenus

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

प्रॉपर्टी

  • onShow

    Event<functionvoidvoid>

    इस webview पर कॉन्टेक्स्ट मेन्यू दिखाने से पहले ट्रिगर होता है. event.preventDefault() को कॉल करके, इस कॉन्टेक्स्ट मेन्यू को बंद करने के लिए इस्तेमाल किया जा सकता है.

    onShow.addListener फ़ंक्शन इस तरह दिखता है: 

    (callback: function) => {...}

    • कॉलबैक

      फ़ंक्शन

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

      (event: object) => void

      • इवेंट

        ऑब्जेक्ट

        • preventDefault

          अमान्य

          संदर्भ मेन्यू को दिखाने से रोकने के लिए, इसे कॉल करें.

          preventDefault फ़ंक्शन इस तरह दिखता है: 

          () => {...}

  • बनाएं

    अमान्य

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

    create फ़ंक्शन इस तरह दिखता है: 

    (createProperties: object, callback?: function) => {...}

    • createProperties

      ऑब्जेक्ट

      आइटम बनाने के लिए इस्तेमाल की गई प्रॉपर्टी

    • कॉलबैक

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

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

      () => void

    • returns

      string | number

      नए आइटम का आईडी.

  • कॉन्टेंट हटाना

    अमान्य

    इससे कॉन्टेक्स्ट मेन्यू का कोई आइटम हटाया जाता है.

    remove फ़ंक्शन इस तरह दिखता है: 

    (menuItemId: string | number, callback?: function) => {...}

    • menuItemId

      string | number

      हटाए जाने वाले कॉन्टेक्स्ट मेन्यू आइटम का आईडी.

    • कॉलबैक

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

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

      () => void

  • removeAll

    अमान्य

    इस webview में जोड़े गए, कॉन्टेक्स्ट मेन्यू के सभी आइटम हटाता है.

    removeAll फ़ंक्शन इस तरह दिखता है: 

    (callback?: function) => {...}

    • कॉलबैक

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

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

      () => void

  • अपडेट करें

    अमान्य

    यह पहले से बनाए गए कॉन्टेक्स्ट मेन्यू आइटम को अपडेट करता है.

    update फ़ंक्शन इस तरह दिखता है: 

    (id: string | number, updateProperties: object, callback?: function) => {...}

    • आईडी

      string | number

      अपडेट किए जाने वाले आइटम का आईडी.

    • updateProperties

      ऑब्जेक्ट

      अपडेट की जाने वाली प्रॉपर्टी. यह फ़ंक्शन, create फ़ंक्शन की तरह ही वैल्यू स्वीकार करता है.

    • कॉलबैक

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

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

      () => void

ContextMenuUpdateProperties

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

प्रॉपर्टी

  • सही का निशान लगाया गया

    boolean optional

    चेकबॉक्स या रेडियो आइटम की स्थिति: चुने गए के लिए सही और नहीं चुने गए के लिए गलत. रेडियो आइटम के किसी ग्रुप में, एक बार में सिर्फ़ एक रेडियो आइटम चुना जा सकता है.

  • कॉन्टेक्स्ट

    [ContextType, ...ContextType[]] optional

    उन कॉन्टेक्स्ट की सूची जिनमें यह मेन्यू आइटम दिखेगा.

  • documentUrlPatterns

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

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

  • चालू किया गया

    boolean optional

    यह संदर्भ मेन्यू आइटम चालू है या बंद है.

  • parentId

    string | number ज़रूरी नहीं

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

  • targetUrlPatterns

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

    यह documentUrlPatterns की तरह ही होता है. हालांकि, इससे img/audio/video टैग के src एट्रिब्यूट और ऐंकर टैग के href के आधार पर फ़िल्टर किया जा सकता है.

  • title

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

    आइटम में दिखने वाला टेक्स्ट

  • टाइप

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

    मेन्यू आइटम का टाइप.

  • onclick

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

    यह एक ऐसा फ़ंक्शन है जिसे मेन्यू आइटम पर क्लिक करने पर वापस कॉल किया जाएगा.

    onclick फ़ंक्शन इस तरह दिखता है: 

    (info: OnClickData) => {...}

    • जानकारी

      OnClickData

      क्लिक किए गए आइटम और उस कॉन्टेक्स्ट के बारे में जानकारी जहां क्लिक किया गया था.

ContextType

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

अलग-अलग कॉन्टेक्स्ट, जिनमें मेन्यू दिख सकता है. 'all' को सेट करने का मतलब है कि अन्य सभी कॉन्टेक्स्ट को सेट किया गया है.

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

यह इंटरफ़ेस, dialog DOM इवेंट से अटैच होता है.

प्रॉपर्टी

  • अभी नहीं

    अमान्य

    डायलॉग बॉक्स को खारिज करें. यह confirm या prompt डायलॉग बॉक्स में, 'रद्द करें' पर क्लिक करने के बराबर है.

    cancel फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • ठीक है

    अमान्य

    डायलॉग बॉक्स में दी गई जानकारी को स्वीकार करें. यह alert, confirm या prompt डायलॉग में 'ठीक है' पर क्लिक करने के बराबर है.

    ok फ़ंक्शन इस तरह दिखता है: 

    (response?: string) => {...}

    • जवाब

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

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

DialogMessageType

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

मेहमान ने किस तरह के मोडल डायलॉग का अनुरोध किया है.

Enum

"alert"

"confirm"

"prompt"

DownloadPermissionRequest

यह request ऑब्जेक्ट का टाइप है, जो download permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • requestMethod

    स्ट्रिंग

    डाउनलोड करने के अनुरोध से जुड़ा एचटीटीपी अनुरोध टाइप (जैसे, GET).

  • url

    स्ट्रिंग

    डाउनलोड करने के लिए अनुरोध किया गया यूआरएल.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें.

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें. अगर allow को कॉल नहीं किया जाता है, तो यह डिफ़ॉल्ट व्यवहार होता है.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

ExitReason

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

स्ट्रिंग, जिससे यह पता चलता है कि उपयोगकर्ता ने ऐप्लिकेशन क्यों छोड़ा.

Enum

"normal"

"abnormal"

"crashed"

"killed"

"oom killed"

"oom"

"लॉन्च नहीं हो सका"

"integrity failure"

FileSystemPermissionRequest

यह request ऑब्जेक्ट का टाइप है, जो filesystem permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • url

    स्ट्रिंग

    लोकल फ़ाइल सिस्टम को ऐक्सेस करने का अनुरोध करने वाले फ़्रेम का यूआरएल.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें.

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

FindCallbackResults

इसमें 'ढूंढें' अनुरोध के सभी नतीजे शामिल होते हैं.

प्रॉपर्टी

  • activeMatchOrdinal

    संख्या

    मौजूदा मैच का क्रमसूचक नंबर.

  • रद्द किया गया

    बूलियन

    इससे पता चलता है कि खोज के इस अनुरोध को रद्द कर दिया गया था या नहीं.

  • numberOfMatches

    संख्या

    पेज पर searchText से मैच होने वाले आइटम की संख्या.

  • selectionRect

    SelectionRect

    स्क्रीन के निर्देशांकों में, ऐक्टिव मैच के चारों ओर मौजूद आयत के बारे में बताता है.

FindOptions

ढूंढने के अनुरोध के लिए विकल्प.

प्रॉपर्टी

  • backward

    boolean optional

    उल्टे क्रम में मिलते-जुलते नतीजे ढूंढने के लिए फ़्लैग करें. डिफ़ॉल्ट वैल्यूfalse है

  • matchCase

    boolean optional

    केस-सेंसिटिविटी (बड़े और छोटे अक्षरों में अंतर) के हिसाब से मैच करने के लिए फ़्लैग करें. डिफ़ॉल्ट वैल्यूfalse है

FullscreenPermissionRequest

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

यह request ऑब्जेक्ट का टाइप है, जो fullscreen permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • origin

    स्ट्रिंग

    webview में मौजूद उस फ़्रेम का ऑरिजिन जिसने फ़ुलस्क्रीन का अनुरोध किया था.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें.

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

GeolocationPermissionRequest

यह request ऑब्जेक्ट का टाइप है, जो geolocation permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • url

    स्ट्रिंग

    जियोलोकेशन डेटा का ऐक्सेस मांगने वाले फ़्रेम का यूआरएल.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें.

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें. अगर allow को कॉल नहीं किया जाता है, तो यह डिफ़ॉल्ट व्यवहार होता है.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

HidPermissionRequest

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

यह request ऑब्जेक्ट का टाइप है, जो hid permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • url

    स्ट्रिंग

    एचआईडी एपीआई का ऐक्सेस मांगने वाले फ़्रेम का यूआरएल.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें.

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें. अगर allow को कॉल नहीं किया जाता है, तो यह डिफ़ॉल्ट व्यवहार होता है.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

InjectDetails

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

प्रॉपर्टी

  • कोड

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

    इंजेक्ट करने के लिए JavaScript या सीएसएस कोड.

    चेतावनी: code पैरामीटर का इस्तेमाल सावधानी से करें. इसका गलत इस्तेमाल करने से, आपके ऐप्लिकेशन पर क्रॉस साइट स्क्रिप्टिंग के हमले हो सकते हैं.

  • फ़ाइल

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

    इंजेक्ट करने के लिए JavaScript या सीएसएस फ़ाइल.

InjectionItems

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

इंजेक्शन आइटम का टाइप: कोड या फ़ाइलों का सेट.

प्रॉपर्टी

  • कोड

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

    JavaScript कोड या सीएसएस, जिसे मिलते-जुलते पेजों में इंजेक्ट किया जाना है.

  • फ़ाइलें

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

    यह उन JavaScript या सीएसएस फ़ाइलों की सूची है जिन्हें मिलते-जुलते पेजों में इंजेक्ट किया जाना है. इन्हें इस ऐरे में दिए गए क्रम में इंजेक्ट किया जाता है.

LoadAbortReason

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

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

Enum

"ERR_ABORTED"

"ERR_INVALID_URL"

"ERR_DISALLOWED_URL_SCHEME"

"ERR_BLOCKED_BY_CLIENT"

"ERR_ADDRESS_UNREACHABLE"

"ERR_EMPTY_RESPONSE"

"ERR_FILE_NOT_FOUND"

"ERR_UNKNOWN_URL_SCHEME"

LoadPluginPermissionRequest

यह request ऑब्जेक्ट का टाइप है, जो loadplugin permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • पहचानकर्ता

    स्ट्रिंग

    प्लगिन की आइडेंटिफ़ायर स्ट्रिंग.

  • नाम

    स्ट्रिंग

    प्लगिन का डिसप्ले नेम.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें. अगर deny को कॉल नहीं किया जाता है, तो यह डिफ़ॉल्ट व्यवहार होता है..

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

MediaPermissionRequest

यह request ऑब्जेक्ट का टाइप है, जो media permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • url

    स्ट्रिंग

    उस फ़्रेम का यूआरएल जो उपयोगकर्ता के मीडिया को ऐक्सेस करने का अनुरोध कर रहा है.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें.

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें. अगर allow को कॉल नहीं किया जाता है, तो यह डिफ़ॉल्ट व्यवहार होता है.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

NewWindow

यह इंटरफ़ेस, newwindow DOM इवेंट से अटैच होता है.

प्रॉपर्टी

  • अटैच करें

    अमान्य

    अनुरोध किए गए टारगेट पेज को किसी मौजूदा webview एलिमेंट से अटैच करें.

    attach फ़ंक्शन इस तरह दिखता है: 

    (webview: object) => {...}

    • webview

      ऑब्जेक्ट

      वह webview एलिमेंट जिससे टारगेट पेज को अटैच किया जाना चाहिए.

  • खारिज करें

    अमान्य

    नई विंडो खोलने का अनुरोध रद्द करें.

    discard फ़ंक्शन इस तरह दिखता है: 

    () => {...}

PermissionType

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

अनुरोध की जा रही अनुमति का टाइप.

Enum

"media"

"geolocation"

"pointerLock"

"download"

"loadplugin"

"filesystem"

"fullscreen"

"hid"

PointerLockPermissionRequest

यह request ऑब्जेक्ट का टाइप है, जो pointerLock permissionrequest DOM इवेंट के साथ होता है.

प्रॉपर्टी

  • lastUnlockedBySelf

    बूलियन

    अनुरोध करने वाला फ़्रेम, पॉइंटर लॉक करने वाला सबसे हाल का क्लाइंट था या नहीं.

  • url

    स्ट्रिंग

    उस फ़्रेम का यूआरएल जिसने पॉइंटर लॉक करने का अनुरोध किया है.

  • userGesture

    बूलियन

    उपयोगकर्ता के इनपुट जेस्चर की वजह से, पॉइंटर लॉक करने का अनुरोध किया गया था या नहीं.

  • अनुमति देना

    अमान्य

    अनुमति के अनुरोध को स्वीकार करें.

    allow फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • अनुमति नहीं देना

    अमान्य

    अनुमति के अनुरोध को अस्वीकार करें. अगर allow को कॉल नहीं किया जाता है, तो यह डिफ़ॉल्ट व्यवहार होता है.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

SelectionRect

स्क्रीन के निर्देशांकों में किसी रेक्टैंगल के बारे में बताता है.

इसमें शामिल करने के लिए, ऐरे जैसी सिमैंटिक्स का इस्तेमाल किया जाता है. इसका मतलब है कि आयत में कोऑर्डिनेट (left, top) को शामिल किया जाता है, लेकिन कोऑर्डिनेट (left + width, top) को शामिल नहीं किया जाता.

प्रॉपर्टी

  • ऊंचाई

    संख्या

    रेक्टैंगल की ऊंचाई.

  • बाएं

    संख्या

    स्क्रीन के बाएं किनारे से लेकर आयत के बाएं किनारे तक की दूरी.

  • ऊपर

    संख्या

    स्क्रीन के सबसे ऊपर वाले किनारे से लेकर रेक्टैंगल के सबसे ऊपर वाले किनारे तक की दूरी.

  • चौड़ाई

    संख्या

    आयत की चौड़ाई.

StopFindingAction

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

यह कुकी तय करती है कि फ़ाइंड सेशन खत्म होने के बाद, ऐक्टिव मैच का क्या करना है. clear से, ऐक्टिव मैच पर हाइलाइट किया गया हिस्सा हट जाएगा; keep से, ऐक्टिव मैच हाइलाइट रहेगा; activate से, ऐक्टिव मैच हाइलाइट रहेगा और उस मैच पर उपयोगकर्ता के क्लिक करने की कार्रवाई को सिम्युलेट किया जाएगा. डिफ़ॉल्ट कार्रवाई keep है.

Enum

"clear"

"keep"

"activate"

WebRequestEventInterface

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

यह इंटरफ़ेस, गेस्ट पेज पर webRequest इवेंट को ऐक्सेस करने की सुविधा देता है. WebRequest के लाइफ़ साइकल और इससे जुड़े कॉन्सेप्ट के बारे में ज़्यादा जानने के लिए, chrome.webRequest एक्सटेंशन एपीआई देखें. ध्यान दें: chrome.webRequest.onActionIgnored इवेंट, वेबव्यू के लिए काम नहीं करता.

एक्सटेंशन के webRequest API के मुकाबले, इस एपीआई का इस्तेमाल कैसे अलग है, यह बताने के लिए यहां दिए गए उदाहरण कोड को देखें. यह कोड, *://www.evil.com/* से मेल खाने वाले यूआरएल के लिए, मेहमान के तौर पर किए गए सभी अनुरोधों को ब्लॉक करता है:

webview.request.onBeforeRequest.addListener(
  function(details) { return {cancel: true}; },
  {urls: ["*://www.evil.com/*"]},
  ["blocking"]);

इसके अलावा, यह इंटरफ़ेस onRequest और onMessage इवेंट के ज़रिए, webRequest के नियमों को लागू करने की सुविधा देता है. एपीआई के बारे में ज़्यादा जानने के लिए, declarativeWebRequest पर जाएं.

ध्यान दें कि वेबव्यू वेब अनुरोधों के लिए, शर्तों और कार्रवाइयों को उनके chrome.webViewRequest.* काउंटरपार्ट से इंस्टैंटिएट किया जाना चाहिए. यहां दिए गए उदाहरण कोड में, वेबव्यू myWebview पर "example.com" के सभी अनुरोधों को ब्लॉक करने का तरीका बताया गया है:

var rule = {
  conditions: [
    new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
  ],
  actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);

WindowOpenDisposition

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

नई विंडो के लिए अनुरोध किया गया डिसपोज़िशन.

Enum

"ignore"

"save_to_disk"

"current_tab"

"new_background_tab"

"new_foreground_tab"

"new_window"

"new_popup"

ZoomMode

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

इससे यह तय होता है कि webview में ज़ूम करने की सुविधा कैसे काम करती है.

Enum

"per-origin"
ज़ूम किए गए पेज के ऑरिजिन में, ज़ूम के बदलाव बने रहेंगे. इसका मतलब है कि एक ही पार्टीशन में मौजूद अन्य सभी वेबव्यू, जो उसी ऑरिजिन पर नेविगेट किए जाते हैं वे भी ज़ूम किए जाएंगे. इसके अलावा, per-originज़ूम के बदलाव, ओरिजिन के साथ सेव किए जाते हैं. इसका मतलब है कि एक ही ओरिजिन के अन्य पेजों पर नेविगेट करने पर, वे सभी एक ही ज़ूम फ़ैक्टर पर ज़ूम किए जाएंगे.

"हर व्यू के हिसाब से"
ज़ूम के बदलाव सिर्फ़ इस वेबव्यू में लागू होंगे. साथ ही, अन्य वेबव्यू में ज़ूम के बदलावों का असर इस वेबव्यू के ज़ूम पर नहीं पड़ेगा. इसके अलावा, per-view नेविगेशन पर ज़ूम के बदलाव रीसेट हो जाते हैं. वेबव्यू पर नेविगेट करने पर, पेज हमेशा अपने ऑरिजिन के हिसाब से ज़ूम फ़ैक्टर के साथ लोड होंगे (पार्टिशन के दायरे में).

"disabled"
इससे वेबव्यू में ज़ूम करने की सुविधा बंद हो जाती है. कॉन्टेंट, ज़ूम के डिफ़ॉल्ट लेवल पर वापस आ जाएगा. साथ ही, ज़ूम के लेवल में किए गए सभी बदलावों को अनदेखा कर दिया जाएगा.

प्रॉपर्टी

contentWindow

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

टाइप

ContentWindow

contextMenus

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

यह Chrome के ContextMenus API की तरह ही है. हालांकि, यह ब्राउज़र के बजाय webview पर लागू होता है. webview के संदर्भ मेन्यू में आइटम जोड़ने के लिए, webview.contextMenus API का इस्तेमाल करें. आपके पास यह चुनने का विकल्प होता है कि कॉन्टेक्स्ट मेन्यू में जोड़े गए आइटम, किस तरह के ऑब्जेक्ट पर लागू हों. जैसे, इमेज, हाइपरलिंक, और पेज.

टाइप

ContextMenus

request

यह इंटरफ़ेस, मेहमान के तौर पर इस्तेमाल किए जा रहे पेज पर webRequest इवेंट को ऐक्सेस करने की सुविधा देता है.

टाइप

WebRequestEventInterface

तरीके

addContentScripts()

Chrome 44 या इसके बाद का वर्शन 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
): void

webview में कॉन्टेंट स्क्रिप्ट इंजेक्ट करने के नियम जोड़ता है. जब webview किसी ऐसे पेज पर जाता है जो एक या उससे ज़्यादा नियमों से मेल खाता है, तब उससे जुड़ी स्क्रिप्ट को इंजेक्ट किया जाएगा. प्रोग्राम के हिसाब से नियम जोड़े जा सकते हैं या मौजूदा नियमों को अपडेट किया जा सकता है.

यहां दिए गए उदाहरण में, webview में दो नियम जोड़े गए हैं: 'myRule' और 'anotherRule'.

webview.addContentScripts([
  {
    name: 'myRule',
    matches: ['http://www.foo.com/*'],
    css: { files: ['mystyles.css'] },
    js: { files: ['jquery.js', 'myscript.js'] },
    run_at: 'document_start'
  },
  {
    name: 'anotherRule',
    matches: ['http://www.bar.com/*'],
    js: { code: "document.body.style.backgroundColor = 'red';" },
    run_at: 'document_end'
  }]);
 ...

// Navigates webview.
webview.src = 'http://www.foo.com';

जब तक स्क्रिप्ट इंजेक्ट करने की ज़रूरत न हो, तब तक addContentScripts कॉल को टाला जा सकता है.

यहां दिए गए उदाहरण में, मौजूदा नियम को बदलने का तरीका बताया गया है.

webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.foo.com/*'],
    js: { files: ['scriptA.js'] },
    run_at: 'document_start'}]);

// Do something.
webview.src = 'http://www.foo.com/*';
 ...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.bar.com/*'],
    js: { files: ['scriptB.js'] },
    run_at: 'document_end'}]);

अगर webview को ऑरिजिन (जैसे, foo.com) पर नेविगेट किया गया है और यह 'myRule' को जोड़ने के लिए webview.addContentScripts को कॉल करता है, तो आपको स्क्रिप्ट को इंजेक्ट करने के लिए अगले नेविगेशन का इंतज़ार करना होगा. अगर आपको तुरंत इंजेक्शन लगवाना है, तो executeScript सही विकल्प है.

गेस्ट प्रोसेस क्रैश होने, बंद होने या webview के फिर से पैरंट बनने पर भी नियम बने रहते हैं.

ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट का दस्तावेज़ देखें.

पैरामीटर

back()

chrome.webviewTag.back(
  callback?: function,
): void

अगर हो सके, तो इतिहास की पिछली एंट्री पर वापस जाता है. go(-1) के बराबर.

पैरामीटर

  • कॉलबैक

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

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

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

    (success: boolean) => void

    • सफलता

      बूलियन

      इससे पता चलता है कि नेविगेशन पूरा हुआ या नहीं.

canGoBack()

chrome.webviewTag.canGoBack(): boolean

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

रिटर्न

  • बूलियन

canGoForward()

chrome.webviewTag.canGoForward(): boolean

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

रिटर्न

  • बूलियन

captureVisibleRegion()

Chrome 50+ 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
): void

इससे वेबव्यू के दिखने वाले हिस्से को कैप्चर किया जाता है.

पैरामीटर

  • विकल्प

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

  • कॉलबैक

    फ़ंक्शन

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

    (dataUrl: string) => void

    • dataUrl

      स्ट्रिंग

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

clearData()

chrome.webviewTag.clearData(
  options: ClearDataOptions,
  types: ClearDataTypeSet,
  callback?: function,
): void

यह कुकी, webview पार्टीशन के लिए ब्राउज़िंग डेटा मिटाती है.

पैरामीटर

  • विकल्प

    ClearDataOptions

    यह तय करने के विकल्प कि कौनसा डेटा मिटाना है.

  • प्रकार

    ClearDataTypeSet

    मिटाए जाने वाले डेटा के टाइप.

  • कॉलबैक

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

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

    () => void

executeScript()

chrome.webviewTag.executeScript(
  details: InjectDetails,
  callback?: function,
): void

यह कुकी, गेस्ट पेज में JavaScript कोड इंजेक्ट करती है.

यहां दिए गए सैंपल कोड में, स्क्रिप्ट इंजेक्शन का इस्तेमाल करके मेहमान के पेज के बैकग्राउंड का रंग लाल पर सेट किया गया है:

webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });

पैरामीटर

  • विवरण

    InjectDetails

    चलाई जाने वाली स्क्रिप्ट की जानकारी.

  • कॉलबैक

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

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

    (result?: any[]) => void

    • नतीजा

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

      इंजेक्ट किए गए हर फ़्रेम में स्क्रिप्ट का नतीजा.

find()

chrome.webviewTag.find(
  searchText: string,
  options?: FindOptions,
  callback?: function,
): void

इस कुकी का इस्तेमाल, पेज पर मौजूद किसी शब्द को खोजने के अनुरोध को शुरू करने के लिए किया जाता है.

पैरामीटर

  • searchText

    स्ट्रिंग

    वह स्ट्रिंग जिसे पेज में ढूंढना है.

  • विकल्प

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

    ढूंढने के अनुरोध के लिए विकल्प.

  • कॉलबैक

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

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

    (results?: FindCallbackResults) => void

    • नतीजे

      FindCallbackResults optional

      इसमें 'ढूंढें' अनुरोध के सभी नतीजे शामिल होते हैं. अगर इसका इस्तेमाल कॉलबैक फ़ंक्शन के मुख्य हिस्से में नहीं किया जाता है, तो इसे हटाया जा सकता है. उदाहरण के लिए, अगर कॉलबैक का इस्तेमाल सिर्फ़ यह पता लगाने के लिए किया जाता है कि खोज का अनुरोध कब पूरा हुआ.results

forward()

chrome.webviewTag.forward(
  callback?: function,
): void

अगर हो सके, तो इतिहास की एक एंट्री आगे ले जाता है. go(1) के बराबर.

पैरामीटर

  • कॉलबैक

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

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

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

    (success: boolean) => void

    • सफलता

      बूलियन

      इससे पता चलता है कि नेविगेशन पूरा हुआ या नहीं.

getAudioState()

Chrome 62 या इसके बाद के वर्शन 
chrome.webviewTag.getAudioState(
  callback: function,
): void

ऑडियो की स्थिति के बारे में क्वेरी करता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (audible: boolean) => void

    • Audible

      बूलियन

getProcessId()

chrome.webviewTag.getProcessId(): number

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

रिटर्न

  • संख्या

getUserAgent()

chrome.webviewTag.getUserAgent(): string

यह कुकी, मेहमान के तौर पर पेज के लिए किए गए अनुरोधों के लिए, webview की ओर से इस्तेमाल की गई उपयोगकर्ता एजेंट स्ट्रिंग दिखाती है.

रिटर्न

  • स्ट्रिंग

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
): void

ज़ूम लेवल की मौजूदा वैल्यू मिलती है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (zoomFactor: number) => void

    • zoomFactor

      संख्या

      ज़ूम का मौजूदा लेवल.

getZoomMode()

Chrome 43 या इसके बाद के वर्शन 
chrome.webviewTag.getZoomMode(
  callback: function,
): void

ज़ूम के मौजूदा मोड का पता लगाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      ZoomMode

      webview का मौजूदा ज़ूम मोड.

go()

chrome.webviewTag.go(
  relativeIndex: number,
  callback?: function,
): void

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

पैरामीटर

  • relativeIndex

    संख्या

    इतिहास का वह इंडेक्स जिस पर webview को नेविगेट किया जाना चाहिए. उदाहरण के लिए, 2 वैल्यू से, इतिहास में दो एंट्री आगे बढ़ेंगी. हालांकि, ऐसा तब होगा, जब दो एंट्री आगे बढ़ने की सुविधा उपलब्ध हो. वहीं, -3 वैल्यू से, इतिहास में तीन एंट्री पीछे जाएंगी.

  • कॉलबैक

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

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

    (success: boolean) => void

    • सफलता

      बूलियन

      इससे पता चलता है कि नेविगेशन पूरा हुआ या नहीं.

insertCSS()

chrome.webviewTag.insertCSS(
  details: InjectDetails,
  callback?: function,
): void

यह कुकी, गेस्ट पेज में सीएसएस इंजेक्ट करती है.

पैरामीटर

  • विवरण

    InjectDetails

    सीएसएस डालने की जानकारी.

  • कॉलबैक

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

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

    () => void

isAudioMuted()

Chrome 62 या इसके बाद के वर्शन 
chrome.webviewTag.isAudioMuted(
  callback: function,
): void

यह क्वेरी करती है कि ऑडियो म्यूट है या नहीं.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (muted: boolean) => void

    • म्यूट किया गया

      बूलियन

isSpatialNavigationEnabled()

Chrome 71 या इसके बाद के वर्शन 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
): void

यह कुकी यह क्वेरी करती है कि वेबव्यू के लिए स्पेशल नेविगेशन की सुविधा चालू है या नहीं.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (enabled: boolean) => void

    • चालू किया गया

      बूलियन

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

इससे पता चलता है कि webview के उपयोगकर्ता एजेंट स्ट्रिंग को webviewTag.setUserAgentOverride ने बदला है या नहीं.

loadDataWithBaseUrl()

chrome.webviewTag.loadDataWithBaseUrl(
  dataUrl: string,
  baseUrl: string,
  virtualUrl?: string,
): void

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

पैरामीटर

  • dataUrl

    स्ट्रिंग

    लोड किए जाने वाले डेटा का यूआरएल.

  • baseUrl

    स्ट्रिंग

    वह बेस यूआरएल जिसका इस्तेमाल रिलेटिव लिंक के लिए किया जाएगा.

  • virtualUrl

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

    वह यूआरएल जो उपयोगकर्ता को (पता बार में) दिखेगा.

print()

chrome.webviewTag.print(): void

इससे webview का कॉन्टेंट प्रिंट होता है. यह webview से स्क्रिप्ट किए गए प्रिंट फ़ंक्शन को कॉल करने के बराबर होता है.

reload()

chrome.webviewTag.reload(): void

यह कुकी, सबसे ऊपर के मौजूदा पेज को फिर से लोड करती है.

removeContentScripts()

Chrome 44 या इसके बाद का वर्शन 
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
): void

यह कुकी, webview से कॉन्टेंट स्क्रिप्ट हटाती है.

यहां दिए गए उदाहरण में, पहले से जोड़ी गई "myRule" को हटाया गया है.

webview.removeContentScripts(['myRule']);

इन नंबरों पर कॉल करके, सभी नियम हटाए जा सकते हैं:

webview.removeContentScripts();

पैरामीटर

  • scriptNameList

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

    उन कॉन्टेंट स्क्रिप्ट के नामों की सूची जिन्हें हटाया जाएगा. अगर सूची खाली है, तो webview में जोड़ी गई सभी कॉन्टेंट स्क्रिप्ट हटा दी जाएंगी.

setAudioMuted()

Chrome 62 या इसके बाद के वर्शन 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
): void

इस कुकी से, वेबव्यू के ऑडियो को म्यूट करने की स्थिति सेट की जाती है.

पैरामीटर

  • म्यूट करें

    बूलियन

    ऑडियो म्यूट करने की वैल्यू

setSpatialNavigationEnabled()

Chrome 71 या इसके बाद के वर्शन 
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
): void

इससे वेबव्यू की स्पेशल नेविगेशन की स्थिति सेट की जाती है.

पैरामीटर

  • चालू किया गया

    बूलियन

    स्पेशल नेविगेशन की स्थिति की वैल्यू.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
): void

मेहमान पेज के अनुरोधों के लिए, webview की ओर से इस्तेमाल की गई उपयोगकर्ता एजेंट स्ट्रिंग को बदलें. बदलाव करने पर, मेहमान के तौर पर किए गए पेज के अनुरोधों के लिए, User-Agent Client Hint हेडर की वैल्यू और navigator.userAgentData से मिली वैल्यू खाली हो जाएंगी. ऐसा उन अनुरोधों के लिए होगा जिन पर यह बदलाव लागू किया गया है.

पैरामीटर

  • userAgent

    स्ट्रिंग

    इस्तेमाल की जाने वाली उपयोगकर्ता एजेंट स्ट्रिंग.

setZoom()

chrome.webviewTag.setZoom(
  zoomFactor: number,
  callback?: function,
): void

इससे पेज के ज़ूम फ़ैक्टर में बदलाव होता है. इस बदलाव का दायरा और यह कितने समय तक लागू रहेगा, यह वेबव्यू के मौजूदा ज़ूम मोड से तय होता है. इसके बारे में जानने के लिए, webviewTag.ZoomMode देखें.

पैरामीटर

  • zoomFactor

    संख्या

    ज़ूम का नया लेवल.

  • कॉलबैक

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

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

    () => void

setZoomMode()

Chrome 43 या इसके बाद के वर्शन 
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
): void

यह विकल्प, webview के ज़ूम मोड को सेट करता है.

पैरामीटर

  • ZoomMode

    ZoomMode

    इससे यह तय होता है कि webview में ज़ूम करने की सुविधा कैसे काम करती है.

  • कॉलबैक

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

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

    () => void

stop()

chrome.webviewTag.stop(): void

अगर मौजूदा webview नेविगेशन लोड हो रहा है, तो उसे बंद कर देता है.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: StopFindingAction,
): void

इससे मौजूदा ढूंढने का सेशन खत्म हो जाता है. साथ ही, हाइलाइट की गई सभी चीज़ें हट जाती हैं और ढूंढने के सभी अनुरोध रद्द हो जाते हैं.

पैरामीटर

  • ऐक्शन गेम

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

    यह कुकी तय करती है कि फ़ाइंड सेशन खत्म होने के बाद, ऐक्टिव मैच का क्या करना है. clear से, ऐक्टिव मैच पर हाइलाइट किया गया हिस्सा हट जाएगा; keep से, ऐक्टिव मैच हाइलाइट रहेगा; activate से, ऐक्टिव मैच हाइलाइट रहेगा और उस मैच पर उपयोगकर्ता के क्लिक करने की कार्रवाई को सिम्युलेट किया जाएगा. डिफ़ॉल्ट कार्रवाई keep है.

terminate()

chrome.webviewTag.terminate(): void

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

इवेंट

close

chrome.webviewTag.close.addListener(
  callback: function,
)

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

यहां दिए गए उदाहरण कोड में, जब मेहमान खुद को बंद करने की कोशिश करता है, तब webview को about:blank पर ले जाने का तरीका बताया गया है.

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    () => void

consolemessage

chrome.webviewTag.consolemessage.addListener(
  callback: function,
)

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

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

webview.addEventListener('consolemessage', function(e) {
  console.log('Guest page logged a message: ', e.message);
});

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (level: number, message: string, line: number, sourceId: string) => void

    • लेवल

      संख्या

    • मैसेज

      स्ट्रिंग

    • लाइन

      संख्या

    • sourceId

      स्ट्रिंग

contentload

chrome.webviewTag.contentload.addListener(
  callback: function,
)

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

यहां दिए गए उदाहरण कोड में, पेज लोड होने के बाद मेहमान के body एलिमेंट के डिफ़ॉल्ट फ़ॉन्ट साइज़ में बदलाव किया गया है:

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    () => void

dialog

chrome.webviewTag.dialog.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब गेस्ट विंडो window.alert, window.confirm या window.prompt के ज़रिए मोडल डायलॉग खोलने की कोशिश करती है.

इस इवेंट को हैंडल करने से, मेहमान की प्रोसेस तब तक ब्लॉक हो जाएगी, जब तक हर इवेंट लिसनर वापस नहीं आ जाता या dialog ऑब्जेक्ट ऐक्सेस नहीं किया जा सकता (अगर preventDefault() को कॉल किया गया था).

डिफ़ॉल्ट रूप से, डायलॉग बॉक्स बंद हो जाता है.

पैरामीटर

exit

chrome.webviewTag.exit.addListener(
  callback: function,
)

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

यहां दिए गए उदाहरण कोड में, मेहमान के तौर पर इस्तेमाल किए जा रहे पेज के क्रैश होने पर, विदाई का मैसेज दिखेगा:

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,Goodbye, world!';
  }
});

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • processID

        संख्या

        यह उस प्रोसेस का Chrome इंटरनल आईडी है जो बंद हो गई है.

      • वजह

        ExitReason

        स्ट्रिंग, जिससे यह पता चलता है कि उपयोगकर्ता ने ऐप्लिकेशन क्यों छोड़ा.

findupdate

chrome.webviewTag.findupdate.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब खोज के लिए किए गए चालू अनुरोध के लिए नए नतीजे उपलब्ध होते हैं. मिलते-जुलते कॉन्टेंट मिलने पर, ऐसा एक ही खोज के अनुरोध के लिए कई बार हो सकता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

    • searchText

      स्ट्रिंग

    • numberOfMatches

      संख्या

    • activeMatchOrdinal

      संख्या

    • selectionRect

      SelectionRect

    • रद्द किया गया

      बूलियन

    • finalUpdate

      स्ट्रिंग

loadabort

chrome.webviewTag.loadabort.addListener(
  callback: function,
)

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

ध्यान दें: जब किसी संसाधन को लोड करने की प्रोसेस को बीच में ही रोक दिया जाता है, तो loadabort इवेंट के बाद loadstop इवेंट ट्रिगर होता है. भले ही, पिछले loadstop इवेंट के बाद से लोड किए गए सभी संसाधन (अगर कोई हो) लोड न हो पाए हों.

ध्यान दें: जब किसी 'इसके बारे में जानकारी' वाले यूआरएल या JavaScript यूआरएल को लोड होने से रोका जाता है, तो loadabort ट्रिगर हो जाएगा. इसके बाद, webview को 'about:blank' पर नेविगेट किया जाएगा.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void

    • url

      स्ट्रिंग

    • isTopLevel

      बूलियन

    • कोड

      संख्या

    • वजह

      LoadAbortReason

loadcommit

chrome.webviewTag.loadcommit.addListener(
  callback: function,
)

यह तब ट्रिगर होता है, जब लोड पूरा हो जाता है. इसमें मौजूदा दस्तावेज़ में नेविगेशन के साथ-साथ सबफ़्रेम दस्तावेज़-लेवल के लोड भी शामिल हैं. हालांकि, इसमें एसिंक्रोनस रिसॉर्स लोड शामिल नहीं हैं.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (url: string, isTopLevel: boolean) => void

    • url

      स्ट्रिंग

    • isTopLevel

      बूलियन

loadredirect

chrome.webviewTag.loadredirect.addListener(
  callback: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

    • oldUrl

      स्ट्रिंग

    • newUrl

      स्ट्रिंग

    • isTopLevel

      बूलियन

loadstart

chrome.webviewTag.loadstart.addListener(
  callback: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (url: string, isTopLevel: boolean) => void

    • url

      स्ट्रिंग

    • isTopLevel

      बूलियन

loadstop

chrome.webviewTag.loadstop.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब मेहमान पेज में फ़्रेम-लेवल के सभी लोड पूरे हो जाते हैं. इसमें सभी सबफ़्रेम शामिल हैं. इसमें मौजूदा दस्तावेज़ में नेविगेशन के साथ-साथ सबफ़्रेम दस्तावेज़-लेवल के लोड भी शामिल हैं. हालांकि, इसमें एसिंक्रोनस रिसॉर्स लोड शामिल नहीं हैं. यह इवेंट तब ट्रिगर होता है, जब दस्तावेज़-लेवल के लोड की संख्या एक (या इससे ज़्यादा) से बदलकर शून्य हो जाती है. उदाहरण के लिए, अगर कोई पेज पहले ही लोड हो चुका है (यानी, loadstop पहले ही एक बार ट्रिगर हो चुका है) एक नया iframe बनाता है, जो एक पेज लोड करता है. इसके बाद, iframe पेज लोड होने पर दूसरा loadstop ट्रिगर होगा. आम तौर पर, यह पैटर्न उन पेजों पर दिखता है जो विज्ञापन लोड करते हैं.

ध्यान दें: जब कमिट किए गए लोड को रद्द किया जाता है, तो loadstop इवेंट के बाद loadabort इवेंट ट्रिगर होगा. भले ही, पिछले loadstop इवेंट के बाद से कमिट किए गए सभी लोड (अगर कोई हो) रद्द कर दिए गए हों.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    () => void

newwindow

chrome.webviewTag.newwindow.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब मेहमान पेज कोई नई ब्राउज़र विंडो खोलने की कोशिश करता है.

यहां दिए गए उदाहरण कोड से, हर नई विंडो के लिए एम्बेडर में एक नया webview बनाया जाएगा और उस पर नेविगेट किया जाएगा:

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void

    • विंडो

      NewWindow

    • targetUrl

      स्ट्रिंग

    • initialWidth

      संख्या

    • initialHeight

      संख्या

    • नाम

      स्ट्रिंग

    • windowOpenDisposition

      WindowOpenDisposition

permissionrequest

chrome.webviewTag.permissionrequest.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब मेहमान पेज को एम्बेड करने वाले व्यक्ति से खास अनुमति का अनुरोध करना होता है.

यहां दिए गए उदाहरण कोड से, मेहमान के तौर पर शामिल पेज को webkitGetUserMedia API का ऐक्सेस मिल जाएगा. ध्यान दें कि इस उदाहरण कोड का इस्तेमाल करने वाले ऐप्लिकेशन को, मेनिफ़ेस्ट फ़ाइल में audioCapture और/या videoCapture अनुमतियां खुद तय करनी होंगी:

webview.addEventListener('permissionrequest', function(e) {
  if (e.permission === 'media') {
    e.request.allow();
  }
});

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (permission: PermissionType, request: object) => void

    • अनुमति

      PermissionType

    • CANNOT TRANSLATE

      ऑब्जेक्ट

responsive

chrome.webviewTag.responsive.addListener(
  callback: function,
)

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

यहां दिए गए उदाहरण कोड की मदद से, webview एलिमेंट को तब फ़ेड इन या फ़ेड आउट किया जा सकता है, जब वह काम कर रहा हो या काम न कर रहा हो:

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (processID: number) => void

    • processID

      संख्या

sizechanged

chrome.webviewTag.sizechanged.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब एम्बेड किए गए वेब कॉन्टेंट का साइज़ autosize के ज़रिए बदला जाता है. यह सिर्फ़ तब ट्रिगर होता है, जब autosize चालू हो.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

    • oldWidth

      संख्या

    • oldHeight

      संख्या

    • newWidth

      संख्या

    • newHeight

      संख्या

unresponsive

chrome.webviewTag.unresponsive.addListener(
  callback: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (processID: number) => void

    • processID

      संख्या

zoomchange

chrome.webviewTag.zoomchange.addListener(
  callback: function,
)

जब पेज का ज़ूम लेवल बदलता है, तब यह इवेंट ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (oldZoomFactor: number, newZoomFactor: number) => void

    • oldZoomFactor

      संख्या

    • newZoomFactor

      संख्या