ब्यौरा
नेटवर्क पर वेब से लाइव कॉन्टेंट को लगातार लोड करने और उसे अपने Chrome ऐप्लिकेशन में एम्बेड करने के लिए, webview
टैग का इस्तेमाल करें. आपका ऐप्लिकेशन, webview
के दिखाए जाने के तरीके को कंट्रोल कर सकता है और वेब कॉन्टेंट के साथ इंटरैक्ट कर सकता है. साथ ही, वह एम्बेड किए गए वेब पेज में नेविगेशन शुरू कर सकता है, उसमें होने वाली गड़बड़ी का जवाब दे सकता है, और बहुत कुछ कर सकता है. ज़्यादा जानने के लिए, इस्तेमाल देखें.
अनुमतियां
webview
टाइप
ClearDataOptions
ऐसे विकल्प जो यह तय करते हैं कि clearData
तक कौनसा डेटा मिटा देना चाहिए.
प्रॉपर्टी
-
प्रारंभ
नंबर वैकल्पिक
इस तारीख को या इसके बाद इकट्ठा हुआ डेटा मिटाएं. यह epoch के बाद, मिलीसेकंड में दिखाया जाता है. इसे JavaScript
Date
ऑब्जेक्ट के getTime तरीके से ऐक्सेस किया जा सकता है. अगर यह मौजूद नहीं है, तो डिफ़ॉल्ट तौर पर0
होता है (इससे पूरा ब्राउज़िंग डेटा हट जाएगा).
ClearDataTypeSet
डेटा टाइप का सेट. जो प्रॉपर्टी मौजूद नहीं हैं उन्हें false
समझा जाता है.
प्रॉपर्टी
-
ऐप्लिकेशन कैश
बूलियन ज़रूरी नहीं
वेबसाइटों की appcaches.
-
कैश मेमोरी
बूलियन ज़रूरी नहीं
Chrome 44 और उसके बाद वाले वर्शन के लिएChrome 43 के बाद से. ब्राउज़र की कैश मेमोरी. ध्यान दें: डेटा हटाते समय, इससे कैश मेमोरी में सेव किया गया पूरा डेटा मिट जाता है; यह आपकी बताई गई रेंज तक सीमित नहीं है.
-
कुकी का इस्तेमाल करता है
बूलियन ज़रूरी नहीं
सेगमेंट की कुकी.
-
fileSystems
बूलियन ज़रूरी नहीं
वेबसाइटों की फ़ाइल सिस्टम.
-
indexedDB
बूलियन ज़रूरी नहीं
वेबसाइटों की IndexedDB डेटा.
-
localStorage
बूलियन ज़रूरी नहीं
वेबसाइटों की लोकल स्टोरेज का डेटा सेव कर सकें.
-
persistentCookies
बूलियन ज़रूरी नहीं
Chrome 58 और उसके बाद वाले वर्शन के लिएसेगमेंट की स्थायी कुकी.
-
sessionCookies
बूलियन ज़रूरी नहीं
Chrome 58 और उसके बाद वाले वर्शन के लिएसेगमेंट की सेशन कुकी.
-
webSQL
बूलियन ज़रूरी नहीं
वेबसाइटों की WebSQL डेटा.
ContentScriptDetails
इंजेक्ट की जाने वाली कॉन्टेंट स्क्रिप्ट की जानकारी. ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट के दस्तावेज़ देखें.
प्रॉपर्टी
-
all_frames
बूलियन ज़रूरी नहीं
अगर
all_frames
की वैल्यूtrue
है, तो इसका मतलब है कि JavaScript या सीएसएस को मौजूदा पेज के सभी फ़्रेम में इंजेक्ट किया जाना चाहिए. डिफ़ॉल्ट रूप से,all_frames
false
होता है और JavaScript या सीएसएस को सिर्फ़ सबसे ऊपर वाले फ़्रेम में डाला जाता है. -
css
InjectionItems ज़रूरी नहीं
सीएसएस कोड या सीएसएस फ़ाइलों की सूची, जिसे मिलते-जुलते पेजों में डाला जाना है. पेज के लिए किसी भी डीओएम के बनाए जाने या दिखाए जाने से पहले, इन्हें उसी क्रम में इंजेक्ट किया जाता है जिस क्रम में ये दिखते हैं.
-
exclude_globs
स्ट्रिंग[] ज़रूरी नहीं
इस ग्लोब से मेल खाने वाले यूआरएल को बाहर रखने के लिए, मैच होने के बाद लागू किया गया. इसका मकसद @remove Greasemonkey कीवर्ड को एम्युलेट करना है.
-
exclude_matches
स्ट्रिंग[] ज़रूरी नहीं
इसमें वे पेज शामिल नहीं हैं जिनमें इस कॉन्टेंट स्क्रिप्ट को डाला जाएगा.
-
include_globs
स्ट्रिंग[] ज़रूरी नहीं
मैच होने के बाद, सिर्फ़ वे यूआरएल शामिल किए जाते हैं जो इस ग्लोब से मेल खाते हैं. इसका मकसद @include Greasemonkey कीवर्ड को एम्युलेट करना है.
-
जेएस
InjectionItems ज़रूरी नहीं
JavaScript कोड या JavaScript फ़ाइलों की सूची, जिसे मिलते-जुलते पेजों में डाला जाएगा. इन्हें उसी क्रम में इंजेक्ट किया जाता है जिस क्रम में ये दिखते हैं.
-
match_about_blank
बूलियन ज़रूरी नहीं
क्या about:blank और about:srcdoc पर, कॉन्टेंट स्क्रिप्ट शामिल करनी है. कॉन्टेंट स्क्रिप्ट सिर्फ़ पेजों पर तब शामिल की जाएंगी, जब उनके इनहेरिट यूआरएल का मिलान, मैच फ़ील्ड में बताए गए किसी पैटर्न से होता है. इनहेरिट यूआरएल, उस दस्तावेज़ का यूआरएल होता है जिससे फ़्रेम या विंडो बनाई गई है. सैंडबॉक्स किए गए फ़्रेम में कॉन्टेंट स्क्रिप्ट नहीं डाली जा सकतीं.
-
मैच
स्ट्रिंग[]
इससे पता चलता है कि कॉन्टेंट की इस स्क्रिप्ट को किन पेजों में डाला जाएगा.
-
नाम
स्ट्रिंग
उस कॉन्टेंट स्क्रिप्ट का नाम जिसे इंजेक्ट करना है.
-
run_at
RunAt ज़रूरी नहीं है
JavaScript या सीएसएस को टैब में सबसे जल्दी शामिल किया जाएगा. डिफ़ॉल्ट तौर पर, "document_idle" होता है.
ContentWindow
मेहमान विंडो के लिए बनाया गया मैसेजिंग हैंडल.
प्रॉपर्टी
-
postMessage
अमान्य
एम्बेड किए गए वेब कॉन्टेंट पर तब तक मैसेज पोस्ट करता है, जब तक एम्बेड किया गया कॉन्टेंट, टारगेट ऑरिजिन से कोई पेज दिखा रहा हो. यह तरीका, पेज के लोड होने के बाद उपलब्ध होता है.
contentload
इवेंट सुनें और फिर तरीके को कॉल करें.मेहमान, एम्बेड करने वाले को जवाब भेज सकेगा. इसके लिए, उसे
event.source
पर मैसेज पोस्ट करना होगा.यह एपीआई, वेब पेजों के बीच कम्यूनिकेट करने के लिए, HTML5 postMessage API की तरह है. एम्बेड करने वाला व्यक्ति,
message
इवेंट लिसनर को अपने फ़्रेम में जोड़कर, जवाबों को सुन सकता है.postMessage
फ़ंक्शन इस तरह दिखता है:(message: any, targetOrigin: string) => {...}
-
मैसेज
कोई
मेहमान को भेजने के लिए मैसेज ऑब्जेक्ट.
-
targetOrigin
स्ट्रिंग
इससे पता चलता है कि इवेंट को भेजने के लिए, मेहमान विंडो का ऑरिजिन क्या होना चाहिए.
-
ContextMenuCreateProperties
प्रॉपर्टी
-
सही का निशान लगाया गया
बूलियन ज़रूरी नहीं
चेकबॉक्स या रेडियो आइटम की शुरुआती स्थिति: चुने गए के लिए सही और नहीं चुने जाने के लिए गलत. रेडियो आइटम के दिए गए ग्रुप में, एक बार में सिर्फ़ एक रेडियो आइटम चुना जा सकता है.
-
कॉन्टेक्स्ट
[ContextType, ...ContextType[]] ज़रूरी नहीं है
उन कॉन्टेक्स्ट की सूची जिनमें यह मेन्यू आइटम दिखेगा. अगर बताया नहीं गया है, तो डिफ़ॉल्ट तौर पर ['page'] होता है.
-
documentUrlPatterns
स्ट्रिंग[] ज़रूरी नहीं
इससे आइटम को सिर्फ़ उन दस्तावेज़ों पर लागू किया जा सकता है जिनका यूआरएल दिए गए किसी पैटर्न से मेल खाता है. (यह फ़्रेम पर भी लागू होता है.) पैटर्न के फ़ॉर्मैट की जानकारी के लिए, मैच पैटर्न देखें.
-
चालू किया गया
बूलियन ज़रूरी नहीं
यह संदर्भ मेन्यू आइटम चालू है या बंद है. डिफ़ॉल्ट तौर पर, यह
true
पर सेट होता है. -
आईडी
स्ट्रिंग ज़रूरी नहीं
इस आइटम को असाइन किया जाने वाला यूनीक आईडी. इवेंट के पेजों के लिए ज़रूरी है. इस एक्सटेंशन के लिए किसी अन्य आईडी के समान नहीं हो सकता.
-
parentId
string | नंबर वैकल्पिक
पैरंट मेन्यू आइटम का आईडी; इससे आइटम पहले जोड़े गए आइटम का चाइल्ड बन जाता है.
-
targetUrlPatterns
स्ट्रिंग[] ज़रूरी नहीं
यह documentUrlPatterns की तरह ही होता है, लेकिन इसे img/audio/video टैग के
src
एट्रिब्यूट और ऐंकर टैग केhref
के आधार पर फ़िल्टर करने की सुविधा मिलती है. -
title
स्ट्रिंग ज़रूरी नहीं
आइटम में दिखाया जाने वाला टेक्स्ट; यह ज़रूरी है, अगर
type
'सेपरेटर' न हो. जब संदर्भ 'चुनें' पर सेट हो, तो चुने गए टेक्स्ट को दिखाने के लिए स्ट्रिंग के अंदर%s
का इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर इस पैरामीटर का मान "Translate '%s' है टू पिग लैटिन" और जब उपयोगकर्ता "कूल" शब्द चुनता है, तो कॉन्टेक्स्ट मेन्यू आइटम यह होता है: "'कूल' का अनुवाद करें' टू पिग लैटिन". -
टाइप
ItemType ज़रूरी नहीं
मेन्यू आइटम का टाइप. डिफ़ॉल्ट रूप से 'सामान्य' होता है अगर बताया नहीं गया है.
-
onclick
अमान्य ज़रूरी नहीं
यह एक फ़ंक्शन है, जिसे मेन्यू आइटम पर क्लिक करने पर वापस कॉल किया जाता है.
onclick
फ़ंक्शन इस तरह दिखता है:(info: OnClickData) => {...}
-
जानकारी
क्लिक किए गए आइटम की जानकारी और उस संदर्भ की जानकारी जहां क्लिक किया गया.
-
ContextMenus
प्रॉपर्टी
-
onShow
इवेंट<Functionvoid>
इस
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 | नंबर
नए आइटम का आईडी.
-
-
कॉन्टेंट हटाना
अमान्य
संदर्भ मेन्यू से आइटम हटाता है.
remove
फ़ंक्शन इस तरह दिखता है:(menuItemId: string | number, callback?: function) => {...}
-
string | नंबर
उस संदर्भ मेन्यू आइटम का आईडी जिसे हटाना है.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
-
-
सभी निकालें
अमान्य
इस
webview
में जोड़े गए, संदर्भ मेन्यू के सभी आइटम हटा देता है.removeAll
फ़ंक्शन इस तरह दिखता है:(callback?: function) => {...}
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
-
-
अपडेट करें
अमान्य
पहले बनाए गए संदर्भ मेन्यू के आइटम को अपडेट करता है.
update
फ़ंक्शन इस तरह दिखता है:(id: string | number, updateProperties: object, callback?: function) => {...}
-
आईडी
string | नंबर
अपडेट किए जाने वाले आइटम का आईडी.
-
updateProperties
ऑब्जेक्ट
अपडेट की जाने वाली प्रॉपर्टी. 'बनाएं' फ़ंक्शन में दी गई वैल्यू को स्वीकार करता है.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
-
ContextMenuUpdateProperties
प्रॉपर्टी
-
सही का निशान लगाया गया
बूलियन ज़रूरी नहीं
चेकबॉक्स या रेडियो आइटम की स्थिति: चुने गए के लिए सही और नहीं चुने जाने के लिए गलत. रेडियो आइटम के दिए गए ग्रुप में, एक बार में सिर्फ़ एक रेडियो आइटम चुना जा सकता है.
-
कॉन्टेक्स्ट
[ContextType, ...ContextType[]] ज़रूरी नहीं है
उन कॉन्टेक्स्ट की सूची जिनमें यह मेन्यू आइटम दिखेगा.
-
documentUrlPatterns
स्ट्रिंग[] ज़रूरी नहीं
इससे आइटम को सिर्फ़ उन दस्तावेज़ों पर लागू किया जा सकता है जिनका यूआरएल दिए गए किसी पैटर्न से मेल खाता है. (यह फ़्रेम पर भी लागू होता है.) पैटर्न के फ़ॉर्मैट की जानकारी के लिए, मैच पैटर्न देखें.
-
चालू किया गया
बूलियन ज़रूरी नहीं
यह संदर्भ मेन्यू आइटम चालू है या बंद है.
-
parentId
string | नंबर वैकल्पिक
पैरंट मेन्यू आइटम का आईडी; इससे आइटम पहले जोड़े गए आइटम का चाइल्ड बन जाता है. ध्यान दें: किसी आइटम को उसके किसी डिसेंडेंट का चाइल्ड नहीं बनाया जा सकता.
-
targetUrlPatterns
स्ट्रिंग[] ज़रूरी नहीं
यह documentUrlPatterns की तरह ही होता है, लेकिन इसे img/audio/video टैग के
src
एट्रिब्यूट और ऐंकर टैग केhref
के आधार पर फ़िल्टर करने की सुविधा मिलती है. -
title
स्ट्रिंग ज़रूरी नहीं
आइटम में दिखाया जाने वाला टेक्स्ट
-
टाइप
ItemType ज़रूरी नहीं
मेन्यू आइटम का टाइप.
-
onclick
अमान्य ज़रूरी नहीं
यह एक फ़ंक्शन है, जिसे मेन्यू आइटम पर क्लिक करने पर वापस कॉल किया जाता है.
onclick
फ़ंक्शन इस तरह दिखता है:(info: OnClickData) => {...}
-
जानकारी
क्लिक किए गए आइटम की जानकारी और उस संदर्भ की जानकारी जहां क्लिक किया गया.
-
ContextType
मेन्यू के अलग-अलग कॉन्टेक्स्ट. 'सभी' को चुना जा रहा है अन्य सभी कॉन्टेक्स्ट के कॉम्बिनेशन के बराबर है.
Enum
"सभी"
"पेज"
"फ़्रेम"
"चुनना"
"लिंक"
"बदलाव किया जा सकता है"
"इमेज"
"वीडियो"
"ऑडियो"
DialogController
इंटरफ़ेस को dialog
डीओएम इवेंट से अटैच किया गया है.
प्रॉपर्टी
-
अभी नहीं
अमान्य
डायलॉग को अस्वीकार करें.
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
स्क्रीन निर्देशांक में, सक्रिय मिलान के चारों ओर एक आयत की जानकारी देता है.
FindOptions
ढूंढने के अनुरोध के लिए विकल्प.
प्रॉपर्टी
-
पीछे
बूलियन ज़रूरी नहीं
उल्टे क्रम में मिलान ढूंढने के लिए फ़्लैग करें. डिफ़ॉल्ट वैल्यू
false
है. -
matchCase
बूलियन ज़रूरी नहीं
केस-सेंसिटिविटी (बड़े और छोटे अक्षरों में अंतर) से मैच करने के लिए फ़्लैग करें. डिफ़ॉल्ट वैल्यू
false
है.
FullscreenPermissionRequest
request
ऑब्जेक्ट का टाइप, जो fullscreen
permissionrequest
DOM इवेंट के साथ होता है.
प्रॉपर्टी
-
origin
स्ट्रिंग
webview
में मौजूद फ़्रेम का वह ऑरिजिन, जिसने फ़ुलस्क्रीन करने का अनुरोध किया था. -
अनुमति देना
अमान्य
अनुमति के अनुरोध की अनुमति दें.
allow
फ़ंक्शन इस तरह दिखता है:() => {...}
-
अस्वीकार करें
अमान्य
अनुमति के अनुरोध को अस्वीकार करें.
deny
फ़ंक्शन इस तरह दिखता है:() => {...}
GeolocationPermissionRequest
request
ऑब्जेक्ट का टाइप, जो geolocation
permissionrequest
DOM इवेंट के साथ होता है.
प्रॉपर्टी
-
url
स्ट्रिंग
भौगोलिक स्थान के डेटा के ऐक्सेस का अनुरोध करने वाले फ़्रेम का यूआरएल.
-
अनुमति देना
अमान्य
अनुमति के अनुरोध की अनुमति दें.
allow
फ़ंक्शन इस तरह दिखता है:() => {...}
-
अस्वीकार करें
अमान्य
अनुमति के अनुरोध को अस्वीकार करें. अगर
allow
को कॉल नहीं किया जाता है, तो यह तरीका डिफ़ॉल्ट तौर पर लागू होता है.deny
फ़ंक्शन इस तरह दिखता है:() => {...}
HidPermissionRequest
request
ऑब्जेक्ट का टाइप, जो hid
permissionrequest
DOM इवेंट के साथ होता है.
प्रॉपर्टी
-
url
स्ट्रिंग
एचआईडी एपीआई के ऐक्सेस का अनुरोध करने वाले फ़्रेम का यूआरएल.
-
अनुमति देना
अमान्य
अनुमति के अनुरोध की अनुमति दें.
allow
फ़ंक्शन इस तरह दिखता है:() => {...}
-
अस्वीकार करें
अमान्य
अनुमति के अनुरोध को अस्वीकार करें. अगर
allow
को कॉल नहीं किया जाता है, तो यह तरीका डिफ़ॉल्ट तौर पर लागू होता है.deny
फ़ंक्शन इस तरह दिखता है:() => {...}
InjectDetails
इंजेक्ट की जाने वाली स्क्रिप्ट या सीएसएस की जानकारी. कोड या फ़ाइल प्रॉपर्टी में से किसी एक को सेट करना ज़रूरी है, लेकिन दोनों को एक साथ सेट नहीं किया जा सकता.
प्रॉपर्टी
-
कोड
स्ट्रिंग ज़रूरी नहीं
इंजेक्ट करने के लिए JavaScript या सीएसएस कोड.
चेतावनी:
code
पैरामीटर का इस्तेमाल करते समय सावधानी बरतें. इसका गलत इस्तेमाल करने से, आपके ऐप्लिकेशन पर क्रॉस साइट स्क्रिप्टिंग के हमले हो सकते हैं. -
फ़ाइल
स्ट्रिंग ज़रूरी नहीं
इंजेक्ट करने के लिए JavaScript या CSS फ़ाइल.
InjectionItems
इंजेक्शन आइटम का टाइप: कोड या फ़ाइलों का सेट.
प्रॉपर्टी
-
कोड
स्ट्रिंग ज़रूरी नहीं
JavaScript कोड या सीएसएस को, मिलते-जुलते पेजों में डाला जाना चाहिए.
-
फ़ाइलें
स्ट्रिंग[] ज़रूरी नहीं
मिलते-जुलते पेजों पर डाली जाने वाली JavaScript या सीएसएस फ़ाइलों की सूची. इन्हें उसी क्रम में डाला जाता है जिस क्रम में ये इस अरे में दिखते हैं.
LoadPluginPermissionRequest
request
ऑब्जेक्ट का टाइप, जो loadplugin
permissionrequest
DOM इवेंट के साथ होता है.
प्रॉपर्टी
-
पहचानकर्ता
स्ट्रिंग
प्लगिन की आइडेंटिफ़ायर स्ट्रिंग.
-
नाम
स्ट्रिंग
प्लग इन का डिसप्ले नेम.
-
अनुमति देना
अमान्य
अनुमति के अनुरोध की अनुमति दें. अगर
deny
को कॉल नहीं किया जाता है, तो यह डिफ़ॉल्ट तरीका होता है..allow
फ़ंक्शन इस तरह दिखता है:() => {...}
-
अस्वीकार करें
अमान्य
अनुमति के अनुरोध को अस्वीकार करें.
deny
फ़ंक्शन इस तरह दिखता है:() => {...}
MediaPermissionRequest
request
ऑब्जेक्ट का टाइप, जो media
permissionrequest
DOM इवेंट के साथ होता है.
प्रॉपर्टी
-
url
स्ट्रिंग
उपयोगकर्ता के मीडिया के ऐक्सेस का अनुरोध करने वाले फ़्रेम का यूआरएल.
-
अनुमति देना
अमान्य
अनुमति के अनुरोध की अनुमति दें.
allow
फ़ंक्शन इस तरह दिखता है:() => {...}
-
अस्वीकार करें
अमान्य
अनुमति के अनुरोध को अस्वीकार करें. अगर
allow
को कॉल नहीं किया जाता है, तो यह तरीका डिफ़ॉल्ट तौर पर लागू होता है.deny
फ़ंक्शन इस तरह दिखता है:() => {...}
NewWindow
इंटरफ़ेस को newwindow
डीओएम इवेंट से अटैच किया गया है.
प्रॉपर्टी
-
अटैच करें
अमान्य
अनुरोध किए गए टारगेट पेज को किसी मौजूदा
webview
एलिमेंट में अटैच करें.attach
फ़ंक्शन इस तरह दिखता है:(webview: object) => {...}
-
वेबव्यू
ऑब्जेक्ट
webview
एलिमेंट, जिससे टारगेट पेज अटैच होना चाहिए.
-
-
खारिज करें
अमान्य
नई विंडो का अनुरोध रद्द करें.
discard
फ़ंक्शन इस तरह दिखता है:() => {...}
PointerLockPermissionRequest
request
ऑब्जेक्ट का टाइप, जो pointerLock
permissionrequest
DOM इवेंट के साथ होता है.
प्रॉपर्टी
-
lastUnlockedBySelf
बूलियन
यह अनुरोध करने वाला फ़्रेम, सबसे हाल ही में इस्तेमाल किया गया क्लाइंट था. इस क्लाइंट ने पॉइंटर लॉक को पकड़ा था.
-
url
स्ट्रिंग
पॉइंटर लॉक का अनुरोध करने वाले फ़्रेम का यूआरएल.
-
userGesture
बूलियन
उपयोगकर्ता इनपुट जेस्चर की वजह से, पॉइंटर लॉक का अनुरोध किया गया था या नहीं.
-
अनुमति देना
अमान्य
अनुमति के अनुरोध की अनुमति दें.
allow
फ़ंक्शन इस तरह दिखता है:() => {...}
-
अस्वीकार करें
अमान्य
अनुमति के अनुरोध को अस्वीकार करें. अगर
allow
को कॉल नहीं किया जाता है, तो यह तरीका डिफ़ॉल्ट तौर पर लागू होता है.deny
फ़ंक्शन इस तरह दिखता है:() => {...}
SelectionRect
स्क्रीन निर्देशांक में एक आयत के बारे में बताता है.
कंटेनमेंट सिमेंटिक्स एक कलेक्शन की तरह होता है; इसका मतलब है कि निर्देशांक (left, top)
को आयत में शामिल माना जाता है, लेकिन निर्देशांक (left + width, top)
को नहीं माना जाता है.
प्रॉपर्टी
-
ऊंचाई
संख्या
रेक्टैंगल की ऊंचाई.
-
बाएं
संख्या
स्क्रीन के बाएं किनारे से आयत के बाएं किनारे की दूरी.
-
ऊपर
संख्या
स्क्रीन के ऊपरी किनारे से रेक्टैंगल के ऊपरी किनारे तक की दूरी.
-
चौड़ाई
संख्या
रेक्टैंगल की चौड़ाई.
WebRequestEventInterface
ऐसा इंटरफ़ेस जो मेहमान पेज पर 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]);
ZoomMode
यह बताता है कि webview
में ज़ूम करने का तरीका कैसे मैनेज किया जाता है.
Enum
"per-origin"
ज़ूम किए गए बदलाव, ज़ूम किए गए पेज के ऑरिजिन में बने रहेंगे. इसका मतलब है कि जिस ऑरिजिन पर नेविगेट किया गया है उसके बाकी सभी वेबव्यू भी ज़ूम हो जाएंगे. इसके अलावा, ज़ूम में किए गए per-origin
बदलाव, ऑरिजिन के साथ सेव किए जाते हैं. इसका मतलब है कि एक ही ऑरिजिन में दूसरे पेजों पर जाने पर, वे सभी एक ही ज़ूम फ़ैक्टर पर ज़ूम होंगे.
"हर व्यू"
ज़ूम में किए गए बदलाव सिर्फ़ इस वेबव्यू में लागू होते हैं. अन्य वेबव्यू में ज़ूम करने से, इस वेबव्यू की ज़ूमिंग पर कोई असर नहीं पड़ता. साथ ही, नेविगेशन पर ज़ूम करने के per-view
बदलाव रीसेट होते हैं; किसी वेबव्यू को नेविगेट करने पर, वे पेज हमेशा अपने हर ऑरिजिन ज़ूम फ़ैक्टर के साथ लोड होंगे (बंटिशन के दायरे में).
"बंद"
वेबव्यू में सभी ज़ूम इन करने की सुविधा बंद करता है. इसके बाद, कॉन्टेंट फिर से डिफ़ॉल्ट ज़ूम लेवल पर सेट हो जाएगा. साथ ही, ज़ूम में किए गए बदलावों को अनदेखा कर दिया जाएगा.
प्रॉपर्टी
contentWindow
ऑब्जेक्ट रेफ़रंस जिसका इस्तेमाल मेहमान पेज पर मैसेज पोस्ट करने के लिए किया जा सकता है.
टाइप
contextMenus
यह Chrome के Context ब्राउज़र एपीआई की तरह ही होता है, लेकिन ब्राउज़र के बजाय webview
पर लागू होता है. webview
के संदर्भ मेन्यू में आइटम जोड़ने के लिए, webview.contextMenus
एपीआई का इस्तेमाल करें. आपके पास यह चुनने का विकल्प होता है कि संदर्भ मेन्यू में जोड़े गए ऑब्जेक्ट किस तरह के हों, जैसे कि इमेज, हाइपरलिंक, और पेज.
टाइप
request
ऐसा इंटरफ़ेस जो मेहमान पेज पर webRequest इवेंट का ऐक्सेस देता है.
तरीके
addContentScripts()
chrome.webviewTag.addContentScripts(
contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
webview
में कॉन्टेंट स्क्रिप्ट इंजेक्शन के नियम जोड़ता है. जब webview
एक या उससे ज़्यादा नियमों से मेल खाने वाले पेज पर नेविगेट करता है, तो उससे जुड़ी स्क्रिप्ट शामिल कर दी जाती हैं. आपके पास प्रोग्राम के हिसाब से नियम जोड़ने या मौजूदा नियमों को अपडेट करने का विकल्प होता है.
नीचे दिया गया उदाहरण webview
में दो नियम जोड़ता है: 'myRule' और 'otherRule'.
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) पर नेविगेट किया गया है और webview.addContentScripts
को 'myRule' जोड़ने के लिए कॉल करता है, तो आपको स्क्रिप्ट शामिल करने के लिए अगले नेविगेशन का इंतज़ार करना होगा. अगर आपको तुरंत इंजेक्शन चाहिए, तो executeScript
सही काम करेगा.
मेहमान प्रोसेस के बंद हो जाने या खत्म हो जाने पर या webview
को दोहराए जाने के बावजूद भी नियमों को बनाए रखा जाता है.
ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट के दस्तावेज़ देखें.
पैरामीटर
-
contentScriptList
जोड़ी जाने वाली कॉन्टेंट स्क्रिप्ट की जानकारी.
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.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
यह वेबव्यू के दिखने वाले इलाके को कैप्चर करता है.
पैरामीटर
-
विकल्प
ImageDetails ज़रूरी नहीं
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(dataUrl: string) => void
-
dataUrl
स्ट्रिंग
कैप्चर किए गए टैब के दिखने वाले हिस्से की इमेज को कोड में बदलने वाला डेटा यूआरएल. 'src' को असाइन किया जा सकता है दिखाने के लिए एचटीएमएल इमेज एलिमेंट की प्रॉपर्टी.
-
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
यह webview
पार्टीशन के लिए ब्राउज़िंग डेटा को मिटाता है.
पैरामीटर
-
विकल्प
विकल्प तय करते हैं कि किस डेटा को मिटाना है.
-
प्रकार
किस तरह का डेटा मिटाना है.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
मेहमान पेज में JavaScript कोड इंजेक्ट करता है.
नीचे दिया गया सैंपल कोड, मेहमान पेज के बैकग्राउंड कलर को लाल पर सेट करने के लिए स्क्रिप्ट इंजेक्शन का इस्तेमाल करता है:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
पैरामीटर
-
विवरण
चलाने के लिए स्क्रिप्ट की जानकारी.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(result?: any[]) => void
-
नतीजा
कोई भी[] ज़रूरी नहीं
हर इंजेक्ट किए गए फ़्रेम में स्क्रिप्ट का नतीजा.
-
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.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.webviewTag.getZoomMode(
callback: function,
)
इससे मौजूदा ज़ूम मोड चालू किया जाता है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(ZoomMode: ZoomMode) => void
-
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,
)
सीएसएस को मेहमान पेज में इंजेक्ट करता है.
पैरामीटर
-
विवरण
शामिल की जाने वाली सीएसएस की जानकारी.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
)
क्वेरी करती है कि ऑडियो को म्यूट किया गया है या नहीं.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(muted: boolean) => void
-
म्यूट किया गया
बूलियन
-
isSpatialNavigationEnabled()
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.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
यह webview
से कॉन्टेंट स्क्रिप्ट हटाता है.
नीचे दिए गए उदाहरण में, "myRule" को हटाया गया है जिसे पहले जोड़ा गया था.
webview.removeContentScripts(['myRule']);
इस नंबर पर कॉल करके, सभी नियमों को हटाया जा सकता है:
webview.removeContentScripts();
पैरामीटर
-
scriptNameList
स्ट्रिंग[] ज़रूरी नहीं
उन कॉन्टेंट स्क्रिप्ट के नाम की सूची जिन्हें हटाया जाएगा. अगर सूची खाली है, तो
webview
में जोड़ी गई सभी कॉन्टेंट स्क्रिप्ट हटा दी जाएंगी.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
इससे वेबव्यू की ऑडियो म्यूट स्थिति सेट की जाती है.
पैरामीटर
-
म्यूट करें
बूलियन
ऑडियो म्यूट करें
setSpatialNavigationEnabled()
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.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
)
webview
का ज़ूम मोड सेट करता है.
पैरामीटर
-
ZoomMode
यह तय करता है कि
webview
में ज़ूम करने की सुविधा कैसे हैंडल की जाती है. -
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
stop()
chrome.webviewTag.stop()
अगर अभी चल रहा है, तो मौजूदा webview
नेविगेशन को लोड करना बंद कर देता है.
stopFinding()
chrome.webviewTag.stopFinding(
action?: "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
"सूचना"
| "पुष्टि करें"
| "प्रॉम्प्ट"
-
messageText
स्ट्रिंग
-
संवाद
-
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
संख्या
-
कारण
"सामान्य"
| "असामान्य"
| "क्रैश"
| "किल"
-
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
-
रद्द किया गया
बूलियन
-
finalUpdate
स्ट्रिंग
-
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
यह तब ट्रिगर होता है, जब टॉप-लेवल लोड तय किए बिना रद्द हो जाता है. जब तक इवेंट को डिफ़ॉल्ट रूप से रोका नहीं जाता, तब तक कंसोल पर गड़बड़ी का मैसेज प्रिंट किया जाएगा.
ध्यान दें: जब कोई रिसॉर्स लोड रद्द किया जाता है, तो loadabort
इवेंट के बाद loadstop
इवेंट होगा. भले ही, पिछले loadstop
इवेंट (अगर कोई है) के बाद से किए गए सभी लोड रद्द कर दिए गए हों.
ध्यान दें: जब 'इसके बारे में जानकारी' पेज या 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
ट्रिगर होगा. यह पैटर्न, आम तौर पर विज्ञापन लोड करने वाले पेजों पर दिखता है.
ध्यान दें: जब तय किए गए लोड को रद्द किया जाता है, तो 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: "ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
) => void-
विंडो
-
targetUrl
स्ट्रिंग
-
initialWidth
संख्या
-
initialHeight
संख्या
-
नाम
स्ट्रिंग
-
windowOpenDisposition
"ध्यान न दें"
| "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-
अनुमति
"मीडिया"
| "जियोलोकेशन"
| "pointerLock"
| "डाउनलोड करें"
| "loadplugin"
| "फ़ाइल सिस्टम"
| "फ़ुलस्क्रीन"
| "छिपाया गया"
-
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
संख्या
-