chrome.webviewTag

ब्यौरा

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

अनुमतियां

webview

टाइप

ClearDataOptions

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

प्रॉपर्टी

• प्रारंभ

  number ज़रूरी नहीं

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

ClearDataTypeSet

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

प्रॉपर्टी

• appcache

  बूलियन ज़रूरी नहीं है

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

• कैश मेमोरी

  बूलियन ज़रूरी नहीं है

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

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

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

  बूलियन ज़रूरी नहीं है

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

• fileSystems

  बूलियन ज़रूरी नहीं है

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

• indexedDB

  बूलियन ज़रूरी नहीं है

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

• localStorage

  बूलियन ज़रूरी नहीं है

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

• persistentCookies

  बूलियन ज़रूरी नहीं है

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

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

• sessionCookies

  बूलियन ज़रूरी नहीं है

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

  सेशन की कुकी.

• webSQL

  बूलियन ज़रूरी नहीं है

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

ContentScriptDetails

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

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

प्रॉपर्टी

• all_frames

  बूलियन ज़रूरी नहीं है

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

• css

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

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

• exclude_globs

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

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

• exclude_matches

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

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

• include_globs

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

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

• js

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

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

• match_about_blank

  बूलियन ज़रूरी नहीं है

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

• मैच

  string[]

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

• नाम

  स्ट्रिंग

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

• run_at

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

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

ContentWindow

मेहमान मोड में, मैसेजिंग हैंडल.

प्रॉपर्टी

• postMessage

  अमान्य

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

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

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

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

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

  • मैसेज

    कोई

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

  • targetOrigin

    स्ट्रिंग

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

ContextMenuCreateProperties

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

प्रॉपर्टी

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

  बूलियन ज़रूरी नहीं है

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

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

  [ContextType, ...ContextType[]] ज़रूरी नहीं

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

• documentUrlPatterns

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

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

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

  बूलियन ज़रूरी नहीं है

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

• आईडी

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

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

• parentId

  स्ट्रिंग | संख्या ज़रूरी नहीं

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

• targetUrlPatterns

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

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

• title

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

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

• टाइप

  ItemType ज़रूरी नहीं

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

• 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

    स्ट्रिंग | संख्या

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

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

  अमान्य

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

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

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

  • menuItemId

    स्ट्रिंग | संख्या

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

  • कॉलबैक

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

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

    () => void

• removeAll

  अमान्य

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

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

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

  • कॉलबैक

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

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

    () => void

• अपडेट करें

  अमान्य

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

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

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

  • आईडी

    स्ट्रिंग | संख्या

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

  • updateProperties

    ऑब्जेक्ट

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

  • कॉलबैक

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

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

    () => void

ContextMenuUpdateProperties

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

प्रॉपर्टी

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

  बूलियन ज़रूरी नहीं है

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

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

  [ContextType, ...ContextType[]] ज़रूरी नहीं

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

• documentUrlPatterns

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

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

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

  बूलियन ज़रूरी नहीं है

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

• parentId

  स्ट्रिंग | संख्या ज़रूरी नहीं

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

• targetUrlPatterns

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

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

• title

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

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

• टाइप

  ItemType ज़रूरी नहीं

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

• onclick

  void ज़रूरी नहीं

  मेन्यू आइटम पर क्लिक करने पर, कॉल किया जाने वाला फ़ंक्शन.

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

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

  • जानकारी

    OnClickData

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

ContextType

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

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

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

dialog DOM इवेंट से जुड़ा इंटरफ़ेस.

प्रॉपर्टी

• अभी नहीं

  अमान्य

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

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

  () => {...}

• ठीक है

  अमान्य

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

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

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

  • जवाब

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

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

DownloadPermissionRequest

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

प्रॉपर्टी

• requestMethod

  स्ट्रिंग

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

• url

  स्ट्रिंग

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

• अनुमति देना

  अमान्य

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

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

  () => {...}

• अस्वीकार करें

  अमान्य

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

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

  () => {...}

FileSystemPermissionRequest

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

प्रॉपर्टी

• url

  स्ट्रिंग

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

• अनुमति देना

  अमान्य

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

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

  () => {...}

• अस्वीकार करें

  अमान्य

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

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

  () => {...}

FindCallbackResults

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

प्रॉपर्टी

• activeMatchOrdinal

  संख्या

  मौजूदा मैच का ऑर्डिनल नंबर.

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

  बूलियन

  इससे पता चलता है कि आइटम ढूंढने का यह अनुरोध रद्द किया गया था या नहीं.

• numberOfMatches

  संख्या

  पेज पर searchText से कितनी बार मैच हुआ.

• selectionRect

  SelectionRect

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

FindOptions

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

प्रॉपर्टी

• पीछे

  बूलियन ज़रूरी नहीं है

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

• matchCase

  बूलियन ज़रूरी नहीं है

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

  स्ट्रिंग

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

• अनुमति देना

  अमान्य

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

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

  () => {...}

• अस्वीकार करें

  अमान्य

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

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

  () => {...}

InjectDetails

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

प्रॉपर्टी

• कोड

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

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

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

• फ़ाइल

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

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

InjectionItems

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

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

प्रॉपर्टी

• कोड

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

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

• फ़ाइलें

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

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

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 एलिमेंट जिससे टारगेट पेज को अटैच करना है.

• खारिज करें

  अमान्य

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

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

  () => {...}

PointerLockPermissionRequest

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

प्रॉपर्टी

• lastUnlockedBySelf

  बूलियन

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

• url

  स्ट्रिंग

  पॉइंटर लॉक का अनुरोध करने वाले फ़्रेम का यूआरएल.

• userGesture

  बूलियन

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

• अनुमति देना

  अमान्य

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

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

  () => {...}

• अस्वीकार करें

  अमान्य

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

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

  () => {...}

SelectionRect

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

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

प्रॉपर्टी

• ऊंचाई

  संख्या

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

• बाएं

  संख्या

  स्क्रीन के बाएं किनारे से रेक्टैंगल के बाएं किनारे की दूरी.

• ऊपर

  संख्या

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

• चौड़ाई

  संख्या

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

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 इवेंट के ज़रिए, वेब अनुरोध के एलान वाले नियमों के साथ काम करता है. एपीआई की जानकारी के लिए, 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]);

ZoomMode

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

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

Enum

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

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

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

प्रॉपर्टी

contentWindow

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

टाइप

ContentWindow

contextMenus

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

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

टाइप

ContextMenus

request

इंटरफ़ेस, जो मेहमान पेज पर webRequest इवेंट का ऐक्सेस देता है.

टाइप

WebRequestEventInterface

तरीके

addContentScripts()

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

chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)

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 को फिर से पैरंट के तौर पर सेट करने पर भी नियम सुरक्षित रहते हैं.

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

पैरामीटर

• contentScriptList

  [ContentScriptDetails, ...ContentScriptDetails[]]

  जोड़ने के लिए कॉन्टेंट स्क्रिप्ट की जानकारी.

back()

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

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

पैरामीटर

• कॉलबैक

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

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

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

  (success: boolean) => void

  • सफलता

    बूलियन

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

canGoBack()

chrome.webviewTag.canGoBack()

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

रिटर्न

• बूलियन

canGoForward()

chrome.webviewTag.canGoForward()

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

रिटर्न

• बूलियन

captureVisibleRegion()

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

chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)

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

पैरामीटर

• विकल्प

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

• कॉलबैक

  फ़ंक्शन

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

  (dataUrl: string) => void

  • dataUrl

    स्ट्रिंग

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

clearData()

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

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

पैरामीटर

• विकल्प

  ClearDataOptions

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

• प्रकार

  ClearDataTypeSet

  जिस तरह का डेटा मिटाना है.

• कॉलबैक

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

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

  () => void

executeScript()

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

यह मेहमान पेज में 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,
)

पेज पर खोजने का अनुरोध शुरू करता है.

पैरामीटर

• searchText

  स्ट्रिंग

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

• विकल्प

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

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

• कॉलबैक

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

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

  (results?: FindCallbackResults) => void

  • नतीजे

    FindCallbackResults ज़रूरी नहीं

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

forward()

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

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

पैरामीटर

• कॉलबैक

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

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

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

  (success: boolean) => void

  • सफलता

    बूलियन

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

getAudioState()

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

chrome.webviewTag.getAudioState(
  callback: function,
)

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (audible: boolean) => void

  • Audible

    बूलियन

getProcessId()

chrome.webviewTag.getProcessId()

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

रिटर्न

• संख्या

getUserAgent()

chrome.webviewTag.getUserAgent()

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

रिटर्न

• स्ट्रिंग

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)

ज़ूम का मौजूदा फ़ैक्टर दिखाता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (zoomFactor: number) => void

  • zoomFactor

    संख्या

    ज़ूम का मौजूदा फ़ैक्टर.

getZoomMode()

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

chrome.webviewTag.getZoomMode(
  callback: function,
)

ज़ूम का मौजूदा मोड दिखाता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (ZoomMode: ZoomMode) => void

  • ZoomMode

    ZoomMode

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

go()

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

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

पैरामीटर

• relativeIndex

  संख्या

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

• कॉलबैक

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

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

  (success: boolean) => void

  • सफलता

    बूलियन

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

insertCSS()

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

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

पैरामीटर

• विवरण

  InjectDetails

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

• कॉलबैक

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

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

  () => void

isAudioMuted()

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

chrome.webviewTag.isAudioMuted(
  callback: function,
)

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (muted: boolean) => void

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

    बूलियन

isSpatialNavigationEnabled()

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

chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (enabled: boolean) => void

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

    बूलियन

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

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

loadDataWithBaseUrl()

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

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

पैरामीटर

• dataUrl

  स्ट्रिंग

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

• baseUrl

  स्ट्रिंग

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

• virtualUrl

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

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

print()

chrome.webviewTag.print()

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

reload()

chrome.webviewTag.reload()

मौजूदा टॉप-लेवल पेज को फिर से लोड करता है.

removeContentScripts()

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

chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)

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

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

webview.removeContentScripts(['myRule']);

सभी नियमों को हटाने के लिए, यह तरीका अपनाएं:

webview.removeContentScripts();

पैरामीटर

• scriptNameList

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

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

setAudioMuted()

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

chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

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

पैरामीटर

• म्यूट करें

  बूलियन

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

setSpatialNavigationEnabled()

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

chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

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

पैरामीटर

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

  बूलियन

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

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

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

पैरामीटर

• userAgent

  स्ट्रिंग

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

setZoom()

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

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

पैरामीटर

• zoomFactor

  संख्या

  नया ज़ूम फ़ैक्टर.

• कॉलबैक

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

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

  () => void

setZoomMode()

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

chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

webview का ज़ूम मोड सेट करता है.

पैरामीटर

• ZoomMode

  ZoomMode

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

• कॉलबैक

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

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

  () => void

stop()

chrome.webviewTag.stop()

अगर webview नेविगेशन लोड हो रहा है, तो उसे लोड होने से रोकता है.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: "clear" 
  | "keep" 
  | "activate" 
 ,
)

इससे, खोज का मौजूदा सेशन खत्म हो जाता है. साथ ही, खोज के सभी अनुरोध रद्द हो जाते हैं.

पैरामीटर

• ऐक्शन गेम

  "clear"
   | "keep"
   | "activate"
   ज़रूरी नहीं

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

terminate()

chrome.webviewTag.terminate()

मेहमान वेब पेज को रेंडर करने की प्रोसेस को जबरन बंद कर देता है. अगर मौजूदा ऐप्लिकेशन में एक ही प्रोसेस का इस्तेमाल करके कई 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() को कॉल किया गया था).

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (messageType: "alert" 
    | "confirm" 
    | "prompt" 
   , messageText: string, dialog: DialogController) => void

  • messageType

    "alert"
     | "confirm"
     | "prompt"
    

  • messageText

    स्ट्रिंग

  • संवाद

    DialogController

exit

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

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

नीचे दिए गए उदाहरण के कोड से, मेहमान पेज के क्रैश होने पर, 'अब तक के लिए धन्यवाद' मैसेज दिखेगा:

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (processID: number, reason: "normal" 
    | "abnormal" 
    | "crash" 
    | "kill" 
   ) => void

  • processID

    संख्या

  • वजह

    "normal"
     | "abnormal"
     | "crash"
     | "kill"
    

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 इवेंट (अगर कोई है) के बाद, सभी कमिट किए गए लोड को बीच में रोक दिया गया हो.

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (url: string, isTopLevel: boolean, code: number, reason: "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" 
   ) => void

  • url

    स्ट्रिंग

  • isTopLevel

    बूलियन

  • कोड

    संख्या

  • वजह

    "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"
    

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 ट्रिगर होगा. आम तौर पर, यह पैटर्न उन पेजों पर देखा जाता है जिन पर विज्ञापन लोड होते हैं.

ध्यान दें: जब कोई लोड पूरा होने से पहले ही रोक दिया जाता है, तो loadabort इवेंट के बाद loadstop इवेंट रिकॉर्ड किया जाएगा. भले ही, पिछले 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: "ignore" 
    | "save_to_disk" 
    | "current_tab" 
    | "new_background_tab" 
    | "new_foreground_tab" 
    | "new_window" 
    | "new_popup" 
   ) => void

  • विंडो

    NewWindow

  • targetUrl

    स्ट्रिंग

  • initialWidth

    संख्या

  • initialHeight

    संख्या

  • नाम

    स्ट्रिंग

  • windowOpenDisposition

    "ignore"
     | "save_to_disk"
     | "current_tab"
     | "new_background_tab"
     | "new_foreground_tab"
     | "new_window"
     | "new_popup"
    

permissionrequest

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

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

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (permission: "media" 
    | "geolocation" 
    | "pointerLock" 
    | "download" 
    | "loadplugin" 
    | "filesystem" 
    | "fullscreen" 
    | "hid" 
   , request: object) => void

  • अनुमति

    "media"
     | "geolocation"
     | "pointerLock"
     | "download"
     | "loadplugin"
     | "filesystem"
     | "fullscreen"
     | "hid"
    

  • 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

    संख्या