توضیحات
از برچسب webview
برای بارگیری فعال محتوای زنده از وب از طریق شبکه و جاسازی آن در برنامه Chrome خود استفاده کنید. برنامه شما میتواند ظاهر webview
را کنترل کند و با محتوای وب تعامل داشته باشد، پیمایشها را در یک صفحه وب تعبیهشده آغاز کند، به رویدادهای خطایی که در آن رخ میدهد واکنش نشان دهد و موارد دیگر (به استفاده مراجعه کنید).
مجوزها
webview
انواع
ClearDataOptions
گزینه هایی که تعیین می کنند چه داده هایی باید توسط clearData
پاک شوند.
خواص
- از آنجایی که
شماره اختیاری
پاک کردن دادههای جمعآوریشده در این تاریخ یا بعد از آن، که در میلیثانیه از آن دوره نشان داده میشوند (قابل دسترسی از طریق روش getTime شی جاوا اسکریپت
Date
). در صورت عدم وجود، به طور پیش فرض روی0
قرار می گیرد (که همه داده های مرور را حذف می کند).
ClearDataTypeSet
مجموعه ای از انواع داده ها ویژگی های از دست رفته به عنوان false
تفسیر می شوند.
خواص
- appcache
بولی اختیاری
اپ کش های وب سایت ها
- حافظه پنهان
بولی اختیاری
Chrome 44+از Chrome 43. حافظه پنهان مرورگر. توجه: هنگام حذف داده ها، این کار کل کش را پاک می کند. به محدوده ای که شما مشخص می کنید محدود نمی شود.
- کوکی ها
بولی اختیاری
کوکی های پارتیشن
- فایل سیستم ها
بولی اختیاری
فایل سیستم های وب سایت ها
- indexedDB
بولی اختیاری
داده های IndexedDB وب سایت ها.
- محل ذخیره سازی
بولی اختیاری
داده های ذخیره سازی محلی وب سایت ها
- کوکی های ماندگار
بولی اختیاری
Chrome 58+کوکی های ماندگار پارتیشن.
- sessionCookies
بولی اختیاری
Chrome 58+کوکی های جلسه پارتیشن.
- webSQL
بولی اختیاری
داده های WebSQL وب سایت ها.
ContentScriptDetails
جزئیات اسکریپت محتوا برای تزریق. برای جزئیات بیشتر به مستندات اسکریپت های محتوا مراجعه کنید.
خواص
- all_frames
بولی اختیاری
اگر
all_frames
true
باشد، به این معنی است که جاوا اسکریپت یا CSS باید به تمام فریمهای صفحه فعلی تزریق شود. به طور پیش فرض،all_frames
false
است و جاوا اسکریپت یا CSS فقط به فریم بالایی تزریق می شود. - css
InjectionItems اختیاری است
کد CSS یا لیستی از فایل های CSS که باید به صفحات منطبق تزریق شوند. اینها به ترتیبی که ظاهر می شوند، قبل از ساخته شدن یا نمایش DOM برای صفحه، تزریق می شوند.
- exclude_globs
رشته[] اختیاری است
برای حذف نشانیهای وب که با این glob مطابقت دارند، پس از مطابقت اعمال میشود. در نظر گرفته شده برای تقلید از کلمه کلیدی @exclude Greasemonkey.
- exclude_match
رشته[] اختیاری است
صفحاتی را که این اسکریپت محتوا در غیر این صورت به آنها تزریق می شد، استثنا نمی کند.
- include_globs
رشته[] اختیاری است
پس از منطبقها اعمال میشود تا فقط نشانیهایی را شامل شود که با این glob مطابقت دارند. در نظر گرفته شده برای تقلید از کلمه کلیدی @include Greasemonkey.
- js
InjectionItems اختیاری است
کد جاوا اسکریپت یا لیستی از فایل های جاوا اسکریپت که باید به صفحات منطبق تزریق شوند. اینها به ترتیبی که ظاهر می شوند تزریق می شوند.
- match_about_blank
بولی اختیاری
درج اسکریپت محتوا در about:blank و about:srcdoc. اسکریپت های محتوا تنها زمانی به صفحات تزریق می شوند که URL ارثی آنها با یکی از الگوهای اعلام شده در قسمت مطابقت مطابقت داشته باشد. URL ارثی نشانی اینترنتی سندی است که قاب یا پنجره را ایجاد کرده است. اسکریپت های محتوا را نمی توان در فریم های جعبه ایمنی درج کرد.
- مسابقات
رشته[]
مشخص می کند که این اسکریپت محتوا به چه صفحاتی تزریق شود.
- نام
رشته
نام اسکریپت محتوا برای تزریق.
- run_at
RunAt اختیاری است
به زودی که جاوا اسکریپت یا CSS به برگه تزریق می شود. پیشفرض «document_idle» است.
ContentWindow
دسته پیام به پنجره مهمان.
خواص
- پست پیام
باطل
تا زمانی که محتوای جاسازی شده صفحه ای را از مبدا هدف نمایش می دهد، پیامی را به محتوای وب جاسازی شده ارسال می کند. این روش پس از اتمام بارگیری صفحه در دسترس است. به رویداد
contentload
گوش دهید و سپس متد را فراخوانی کنید.مهمان میتواند با ارسال پیام به
event.source
در رویداد پیامی که دریافت میکند، پاسخها را به embedder ارسال کند.این API با API postMessage HTML5 برای ارتباط بین صفحات وب یکسان است. جاسازیکننده ممکن است با افزودن شنونده رویداد
message
به قاب خودش، به پاسخها گوش دهد.تابع
postMessage
به شکل زیر است:(message: any, targetOrigin: string) => {...}
- پیام
هر
شیء پیام برای ارسال به مهمان.
- targetOrigin
رشته
مشخص میکند که مبدأ پنجره مهمان باید چه باشد تا رویداد ارسال شود.
ContextMenuCreateProperties
خواص
- بررسی شد
بولی اختیاری
وضعیت اولیه یک چک باکس یا آیتم رادیویی: درست برای انتخاب شده و نادرست برای انتخاب نشده. فقط یک آیتم رادیویی را می توان در یک زمان در یک گروه معین از آیتم های رادیویی انتخاب کرد.
- زمینه ها
[ ContextType , ... ContextType []] اختیاری است
فهرست زمینههایی که این آیتم منو در آنها ظاهر میشود. اگر مشخص نشده باشد، پیشفرض ['صفحه'] است.
- documentUrl Patterns
رشته[] اختیاری است
به شما امکان می دهد مورد را محدود کنید تا فقط برای اسنادی اعمال شود که URL آنها با یکی از الگوهای داده شده مطابقت دارد. (این در مورد قاب ها نیز صدق می کند.) برای جزئیات بیشتر در مورد قالب یک الگو، به الگوهای مطابقت مراجعه کنید.
- فعال شد
بولی اختیاری
آیا این آیتم منوی زمینه فعال یا غیرفعال است. پیش فرض ها به
true
- شناسه
رشته اختیاری
شناسه منحصر به فرد برای اختصاص دادن به این مورد. برای صفحات رویداد اجباری است. نمی تواند با شناسه دیگری برای این افزونه یکسان باشد.
- شناسه والدین
رشته | شماره اختیاری
شناسه یک آیتم منوی والدین؛ این باعث می شود که مورد فرزند آیتمی که قبلاً اضافه شده باشد.
- الگوهای targetUrl
رشته[] اختیاری است
شبیه documentUrlPatterns است، اما به شما امکان میدهد بر اساس ویژگی
src
تگهای img/audio/video وhref
تگهای انکر فیلتر کنید. - عنوان
رشته اختیاری
متنی که در مورد نمایش داده می شود. این مورد نیاز است مگر اینکه
type
"جداکننده" باشد. وقتی زمینه "انتخاب" است، می توانید از%s
در رشته برای نمایش متن انتخاب شده استفاده کنید. به عنوان مثال، اگر مقدار این پارامتر "Translate '%s' to Pig Latin" باشد و کاربر کلمه "cool" را انتخاب کند، مورد منوی زمینه برای انتخاب "Translate 'cool' to Pig Latin" است. - نوع
ItemType اختیاری است
نوع آیتم منو اگر مشخص نشده باشد، پیشفرض به «عادی» میرسد.
- onclick
باطل اختیاری
تابعی که با کلیک روی آیتم منو دوباره فراخوانی می شود.
تابع
onclick
به شکل زیر است:(info: OnClickData) => {...}
- اطلاعات
اطلاعاتی درباره مورد کلیک شده و زمینه ای که کلیک روی آن انجام شده است.
ContextMenus
خواص
- در نمایش
رویداد<functionvoidvoid>
قبل از نمایش منوی زمینه در این
webview
فعال شد. برای غیرفعال کردن این منوی زمینه با فراخوانیevent.preventDefault()
قابل استفاده است.تابع
onShow.addListener
به شکل زیر است:(callback: function) => {...}
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(event: object) => void
- رویداد
شی
- جلوگیری از پیش فرض
باطل
برای جلوگیری از نمایش منوی زمینه با این تماس بگیرید.
تابع
preventDefault
به شکل زیر است:() => {...}
- ایجاد کنید
باطل
یک آیتم منوی زمینه جدید ایجاد می کند. توجه داشته باشید که اگر در حین ایجاد خطایی رخ دهد، ممکن است تا زمانی که پاسخ تماس ایجاد نشود، متوجه آن نشوید (جزئیات در
runtime.lastError
خواهد بود).تابع
create
به نظر می رسد:(createProperties: object, callback?: function) => {...}
- createProperties
شی
خصوصیات مورد استفاده برای ایجاد آیتم
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
- برمی گرداند
رشته | شماره
شناسه مورد جدید ایجاد شده.
- حذف کنید
باطل
یک مورد منوی زمینه را حذف می کند.
تابع
remove
به نظر می رسد:(menuItemId: string | number, callback?: function) => {...}
رشته | شماره
شناسه مورد منوی زمینه برای حذف.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
- حذف همه
باطل
تمام موارد منوی زمینه اضافه شده به این
webview
را حذف می کند.تابع
removeAll
به شکل زیر است:(callback?: function) => {...}
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
- به روز رسانی کنید
باطل
آیتم منوی زمینه ایجاد شده قبلی را به روز می کند.
عملکرد
update
به نظر می رسد:(id: string | number, updateProperties: object, callback?: function) => {...}
- شناسه
رشته | شماره
شناسه مورد برای به روز رسانی.
- updateProperties
شی
خواص برای به روز رسانی مقادیر مشابه تابع create را می پذیرد.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
ContextMenuUpdateProperties
خواص
- بررسی شد
بولی اختیاری
وضعیت یک چک باکس یا آیتم رادیویی: درست برای انتخاب شده و نادرست برای انتخاب نشده. فقط یک آیتم رادیویی را می توان در یک زمان در یک گروه معین از آیتم های رادیویی انتخاب کرد.
- زمینه ها
[ ContextType , ... ContextType []] اختیاری است
فهرست زمینه هایی که این آیتم منو در آنها ظاهر می شود.
- documentUrl Patterns
رشته[] اختیاری است
به شما امکان می دهد مورد را محدود کنید تا فقط برای اسنادی اعمال شود که URL آنها با یکی از الگوهای داده شده مطابقت دارد. (این در مورد قاب ها نیز صدق می کند.) برای جزئیات بیشتر در مورد قالب یک الگو، به الگوهای مطابقت مراجعه کنید.
- فعال شد
بولی اختیاری
آیا این آیتم منوی زمینه فعال یا غیرفعال است.
- شناسه والدین
رشته | شماره اختیاری
شناسه یک آیتم منوی والدین؛ این باعث می شود که مورد فرزند آیتمی که قبلاً اضافه شده باشد. توجه: شما نمی توانید یک مورد را به فرزند یکی از فرزندان خود تغییر دهید.
- الگوهای targetUrl
رشته[] اختیاری است
شبیه documentUrlPatterns است، اما به شما امکان میدهد بر اساس ویژگی
src
تگهای img/audio/video وhref
تگهای انکر فیلتر کنید. - عنوان
رشته اختیاری
متنی که باید در مورد نمایش داده شود
- نوع
ItemType اختیاری است
نوع آیتم منو
- onclick
باطل اختیاری
تابعی که با کلیک روی آیتم منو دوباره فراخوانی می شود.
تابع
onclick
به شکل زیر است:(info: OnClickData) => {...}
- اطلاعات
اطلاعاتی درباره مورد کلیک شده و زمینه ای که کلیک روی آن انجام شده است.
ContextType
زمینه های مختلفی که یک منو می تواند در آنها ظاهر شود. مشخص کردن "همه" معادل ترکیبی از همه زمینه های دیگر است.
Enum
"همه" "صفحه" "قاب" "انتخاب" "پیوند" "قابل ویرایش" "تصویر" "ویدئو" "صوتی"
DialogController
رابط متصل به رویدادهای DOM dialog
.
خواص
- لغو
باطل
گفتگو را رد کنید. معادل کلیک بر روی لغو در گفتگوی
confirm
یاprompt
.تابع
cancel
به نظر می رسد:() => {...}
- باشه
باطل
گفتگو را بپذیرید. معادل کلیک کردن روی تأیید در یک گفتگوی
alert
،confirm
یاprompt
.تابع
ok
به نظر می رسد:(response?: string) => {...}
- پاسخ
رشته اختیاری
رشته پاسخی که هنگام پذیرش یک گفتگوی
prompt
به مهمان ارائه می شود.
DownloadPermissionRequest
نوع شی request
که همراه با یک رویداد DOM permissionrequest
download
درخواست است.
خواص
- روش درخواست
رشته
نوع درخواست HTTP (به عنوان مثال
GET
) مرتبط با درخواست دانلود. - آدرس اینترنتی
رشته
URL دانلود درخواستی.
- اجازه می دهد
باطل
اجازه درخواست مجوز.
تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید. اگر
allow
نشود، این رفتار پیشفرض است.تابع
deny
به نظر می رسد:() => {...}
FileSystemPermissionRequest
نوع شیء request
که یک رویداد DOM permissionrequest
filesystem
را همراهی می کند.
خواص
- آدرس اینترنتی
رشته
URL قاب درخواست دسترسی به سیستم فایل محلی.
- اجازه می دهد
باطل
اجازه درخواست مجوز.
تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید.
تابع
deny
به نظر می رسد:() => {...}
FindCallbackResults
شامل تمام نتایج درخواست یافتن است.
خواص
- activeMatchOrdinal
شماره
شماره ترتیبی مسابقه فعلی.
- لغو شد
بولی
نشان می دهد که آیا این درخواست یافتن لغو شده است یا خیر.
- numberOfMatches
شماره
تعداد دفعاتی که
searchText
در صفحه مطابقت داشت. - انتخاب راست
یک مستطیل را در اطراف منطبق فعال در مختصات صفحه توصیف می کند.
FindOptions
گزینه هایی برای درخواست یافتن
خواص
- عقب مانده
بولی اختیاری
برای یافتن موارد منطبق به ترتیب معکوس پرچم گذاری کنید. مقدار پیش فرض
false
است. - کبریت کیس
بولی اختیاری
پرچم برای مطابقت با حساسیت کوچک و بزرگ. مقدار پیش فرض
false
است.
FullscreenPermissionRequest
نوع شی request
که یک رویداد DOM permissionrequest
fullscreen
را همراهی می کند.
خواص
- منشاء
رشته
مبدأ قاب داخل
webview
که درخواست تمام صفحه را آغاز کرد. - اجازه می دهد
باطل
اجازه درخواست مجوز.
تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید.
تابع
deny
به نظر می رسد:() => {...}
GeolocationPermissionRequest
نوع شی request
که همراه با رویداد DOM permissionrequest
geolocation
است.
خواص
- آدرس اینترنتی
رشته
URL قاب درخواست دسترسی به داده های موقعیت جغرافیایی.
- اجازه می دهد
باطل
اجازه درخواست مجوز.
تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید. اگر
allow
نشود، این رفتار پیشفرض است.تابع
deny
به نظر می رسد:() => {...}
HidPermissionRequest
نوع شی request
که با یک رویداد DOM permissionrequest
hid
همراه است.
خواص
- آدرس اینترنتی
رشته
URL قاب درخواست دسترسی به HID API.
- اجازه می دهد
باطل
اجازه درخواست مجوز.
تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید. اگر
allow
نشود، این رفتار پیشفرض است.تابع
deny
به نظر می رسد:() => {...}
InjectDetails
جزئیات اسکریپت یا CSS برای تزریق. کد یا ویژگی فایل باید تنظیم شود، اما ممکن است هر دو به طور همزمان تنظیم نشوند.
خواص
- کد
رشته اختیاری
کد جاوا اسکریپت یا CSS برای تزریق.
هشدار: در استفاده از پارامتر
code
دقت کنید. استفاده نادرست از آن ممکن است برنامه شما را به حملات اسکریپت نویسی متقابل سایت باز کند. - فایل
رشته اختیاری
فایل جاوا اسکریپت یا CSS برای تزریق.
InjectionItems
نوع آیتم تزریق: کد یا مجموعه ای از فایل ها.
خواص
- کد
رشته اختیاری
کد جاوا اسکریپت یا CSS برای تزریق به صفحات مطابقت.
- فایل ها
رشته[] اختیاری است
لیستی از فایل های جاوا اسکریپت یا CSS که باید به صفحات منطبق تزریق شوند. اینها به ترتیبی که در این آرایه ظاهر می شوند تزریق می شوند.
LoadPluginPermissionRequest
نوع شی request
که یک رویداد DOM permissionrequest
loadplugin
را همراهی میکند.
خواص
- شناسه
رشته
رشته شناسه افزونه.
- نام
رشته
نام نمایشی افزونه
- اجازه می دهد
باطل
اجازه درخواست مجوز. اگر
deny
نامیده نشود، این رفتار پیشفرض است.تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید.
تابع
deny
به نظر می رسد:() => {...}
MediaPermissionRequest
نوع شیء request
که با رویداد DOM permissionrequest
media
همراه است.
خواص
- آدرس اینترنتی
رشته
URL قاب درخواست دسترسی به رسانه کاربر.
- اجازه می دهد
باطل
اجازه درخواست مجوز.
تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید. اگر
allow
نشود، این رفتار پیشفرض است.تابع
deny
به نظر می رسد:() => {...}
NewWindow
رابط متصل به رویدادهای DOM newwindow
.
خواص
- ضمیمه کردن
باطل
صفحه هدف درخواستی را به یک عنصر
webview
موجود وصل کنید.تابع
attach
به نظر می رسد:(webview: object) => {...}
- مشاهده وب
شی
عنصر
webview
که صفحه هدف باید به آن پیوست شود.
- دور انداختن
باطل
درخواست پنجره جدید را لغو کنید.
تابع
discard
به نظر می رسد:() => {...}
PointerLockPermissionRequest
نوع شی request
که با یک رویداد DOM pointerLock
permissionrequest
همراه است.
خواص
- lastUnlockedBySelf
بولی
آیا فریم درخواستکننده جدیدترین سرویس گیرندهای است که قفل نشانگر را نگه داشته است یا خیر.
- آدرس اینترنتی
رشته
نشانی وب قفل نشانگر فریم درخواست کننده.
- کاربر ژست
بولی
اینکه آیا قفل اشاره گر در نتیجه حرکت ورودی کاربر درخواست شده است یا خیر.
- اجازه می دهد
باطل
اجازه درخواست مجوز.
تابع
allow
به نظر می رسد:() => {...}
- انکار کند
باطل
درخواست مجوز را رد کنید. اگر
allow
نشود، این رفتار پیشفرض است.تابع
deny
به نظر می رسد:() => {...}
SelectionRect
یک مستطیل را در مختصات صفحه توصیف می کند.
معناشناسی مهار آرایه مانند است. یعنی مختصات (left, top)
توسط مستطیل در نظر گرفته می شود، اما مختصات (left + width, top)
نیست.
خواص
- ارتفاع
شماره
ارتفاع مستطیل.
- سمت چپ
شماره
فاصله از لبه چپ صفحه تا لبه سمت چپ مستطیل.
- بالا
شماره
فاصله از لبه بالای صفحه تا لبه بالایی مستطیل.
- عرض
شماره
عرض مستطیل.
WebRequestEventInterface
رابطی که دسترسی به رویدادهای webRequest در صفحه مهمان را فراهم می کند. برای جزئیات بیشتر در مورد چرخه عمر webRequest و مفاهیم مرتبط، به API افزونه های chrome.webRequest مراجعه کنید. توجه: رویداد chrome.webRequest.onActionIgnored برای بازدید از وب پشتیبانی نمی شود.
برای نشان دادن تفاوت استفاده از برنامه افزودنی webRequest API، کد مثال زیر را در نظر بگیرید که هرگونه درخواست مهمان برای URL هایی را که مطابقت دارند با *://www.evil.com/*
مسدود می کند:
webview.request.onBeforeRequest.addListener(
function(details) { return {cancel: true}; },
{urls: ["*://www.evil.com/*"]},
["blocking"]);
علاوه بر این، این رابط از قوانین webRequest اعلامی از طریق رویدادهای onRequest
و onMessage
پشتیبانی می کند. برای جزئیات API به declarativeWebRequest
مراجعه کنید.
توجه داشته باشید که شرایط و اقدامات برای webRequestهای نمایشی وب باید از نمونههای مشابه chrome.webViewRequest.*
آنها استفاده شود. کد مثال زیر به طور آشکار همه درخواستهای "example.com"
را در webview myWebview
مسدود میکند:
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-view
در ناوبری بازنشانی میشوند. پیمایش در یک نمای وب همیشه صفحات را با فاکتورهای بزرگنمایی هر منبع (در محدوده پارتیشن) بارگذاری می کند.
تمام بزرگنمایی در نمای وب را غیرفعال می کند. محتوا به سطح بزرگنمایی پیشفرض برمیگردد و تمام تغییرات زوم تلاش شده نادیده گرفته میشوند.
خواص
contentWindow
مرجع شی که می تواند برای ارسال پیام به صفحه مهمان استفاده شود.
تایپ کنید
contextMenus
شبیه به ContextMenus API کروم است، اما به جای مرورگر، برای webview
اعمال می شود. از webview.contextMenus
API برای افزودن موارد به منوی زمینه webview
استفاده کنید. میتوانید انتخاب کنید که افزودههای منوی زمینهتان برای چه نوع شیهایی مانند تصاویر، پیوندها و صفحات اعمال میشود.
تایپ کنید
request
رابطی که دسترسی به رویدادهای webRequest در صفحه مهمان را فراهم می کند.
تایپ کنید
روش ها
addContentScripts()
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) و webview.addContentScripts
را برای افزودن "myRule" فراخوانی می کند، باید منتظر پیمایش بعدی باشید تا اسکریپت ها تزریق شوند. اگر می خواهید تزریق فوری انجام شود، 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.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
ناحیه قابل مشاهده نمای وب را می گیرد.
پارامترها
- گزینه ها
ImageDetails اختیاری است
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(dataUrl: string) => void
- dataUrl
رشته
URL داده ای که تصویری از ناحیه قابل مشاهده برگه گرفته شده را رمزگذاری می کند. ممکن است برای نمایش به ویژگی 'src' یک عنصر HTML Image اختصاص داده شود.
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
داده های مرور را برای پارتیشن webview
پاک می کند.
پارامترها
- گزینه ها
گزینه هایی که تعیین می کنند کدام داده ها پاک شوند.
- انواع
انواع داده هایی که باید پاک شوند.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
کد جاوا اسکریپت را به صفحه مهمان تزریق می کند.
کد نمونه زیر از تزریق اسکریپت برای تنظیم رنگ پسزمینه صفحه مهمان به رنگ قرمز استفاده میکند:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
پارامترها
- جزئیات
جزئیات اسکریپت برای اجرا.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(result?: any[]) => void
- نتیجه
هر[] اختیاری
نتیجه فیلمنامه در هر فریم تزریق شده.
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
)
درخواست یافتن در صفحه را آغاز می کند.
پارامترها
- متن جستجو
رشته
رشته ای که در صفحه پیدا می شود.
- گزینه ها
FindOptions اختیاری است
گزینه هایی برای درخواست یافتن
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(results?: FindCallbackResults) => void
- نتایج
FindCallbackResults اختیاری است
شامل تمام نتایج درخواست یافتن است.
results
می توان حذف کرد اگر در بدنه تابع callback استفاده نشود. به عنوان مثال، اگر پاسخ تماس فقط برای تشخیص اینکه درخواست یافتن تکمیل شده است استفاده می شود.
forward()
chrome.webviewTag.forward(
callback?: function,
)
در صورت امکان یک ورودی تاریخچه را به جلو هدایت می کند. معادل go(1)
.
پارامترها
- پاسخ به تماس
عملکرد اختیاری
Chrome 44+پارامتر
callback
به نظر می رسد:(success: boolean) => void
- موفقیت
بولی
نشان می دهد که آیا پیمایش موفقیت آمیز بوده است یا خیر.
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
)
وضعیت صوتی را جستجو می کند.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(audible: boolean) => void
- قابل شنیدن
بولی
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,
)
با استفاده از فهرست تاریخچه نسبت به پیمایش فعلی به ورودی تاریخ میرود. اگر پیمایش درخواستی غیرممکن باشد، این روش تاثیری ندارد.
پارامترها
- نسبت شاخص
شماره
فهرست تاریخچه نسبی که
webview
باید به آن هدایت شود. به عنوان مثال، مقدار2
در صورت امکان، 2 ورودی تاریخ را به جلو هدایت می کند. مقدار-3
3 ورودی را به عقب هدایت می کند. - پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(success: boolean) => void
- موفقیت
بولی
نشان می دهد که آیا پیمایش موفقیت آمیز بوده است یا خیر.
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
)
CSS را به صفحه مهمان تزریق می کند.
پارامترها
- جزئیات
جزئیات CSS برای درج.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
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,
)
یک URL داده را با یک URL پایه مشخص شده بارگیری می کند که برای پیوندهای نسبی استفاده می شود. به صورت اختیاری، یک URL مجازی می تواند ارائه شود تا به جای URL داده به کاربر نشان داده شود.
پارامترها
- dataUrl
رشته
URL داده برای بارگیری.
- baseUrl
رشته
URL اصلی که برای پیوندهای نسبی استفاده خواهد شد.
- virtualUrl
رشته اختیاری
URL که به کاربر نمایش داده می شود (در نوار آدرس).
print()
chrome.webviewTag.print()
محتویات webview
را چاپ می کند. این معادل فراخوانی تابع چاپ اسکریپت شده از خود webview
است.
reload()
chrome.webviewTag.reload()
صفحه سطح بالای فعلی را دوباره بارگیری می کند.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
اسکریپت های محتوا را از webview
حذف می کند.
مثال زیر "myRule" را که قبلا اضافه شده بود حذف می کند.
webview.removeContentScripts(['myRule']);
با تماس تلفنی می توانید تمام قوانین را حذف کنید:
webview.removeContentScripts();
پارامترها
- اسکریپتNameList
رشته[] اختیاری است
فهرستی از نام اسکریپت های محتوا که حذف خواهند شد. اگر لیست خالی باشد، تمام اسکریپت های محتوای اضافه شده به
webview
حذف خواهند شد.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
وضعیت بیصدا کردن نمای وب را تنظیم میکند.
پارامترها
- بی صدا
بولی
مقدار صدا را بی صدا کنید
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
)
وضعیت ناوبری فضایی نمای وب را تنظیم می کند.
پارامترها
بولی
مقدار وضعیت ناوبری فضایی
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
)
رشته عامل کاربر مورد استفاده توسط webview
برای درخواستهای صفحه مهمان را لغو کنید. نادیده گرفتن باعث می شود که مقادیر سرصفحه User-Agent Client Hint و مقادیر بازگردانده شده توسط 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,
)
هنگامی که پنجره مهمان یک پیام کنسول را ثبت می کند فعال می شود.
کد مثال زیر همه پیامهای گزارش را بدون در نظر گرفتن سطح گزارش یا ویژگیهای دیگر به کنسول embedder ارسال میکند.
webview.addEventListener('consolemessage', function(e) {
console.log('Guest page logged a message: ', e.message);
});
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(level: number, message: string, line: number, sourceId: string) => void
- سطح
شماره
- پیام
رشته
- خط
شماره
- شناسه منبع
رشته
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- نوع پیام
"هشدار"
| "تأیید"
| "سریع" - پیام متن
رشته
- گفتگو
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- شناسه فرآیند
شماره
- دلیل
"عادی"
| "غیرطبیعی"
| "تصادف"
| "کشتن"
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
هنگامی که نتایج یافتن جدید برای یک درخواست یافتن فعال در دسترس باشد فعال می شود. این ممکن است چندین بار برای یک درخواست یافتن به عنوان موارد منطبق پیدا شود.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
- متن جستجو
رشته
- numberOfMatches
شماره
- activeMatchOrdinal
شماره
- انتخاب راست
- لغو شد
بولی
- به روز رسانی نهایی
رشته
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
زمانی شلیک می شود که یک بار سطح بالا بدون ارتکاب سقط شود. یک پیام خطا در کنسول چاپ می شود مگر اینکه رویداد به طور پیش فرض جلوگیری شود.
توجه: هنگامی که یک بار منبع لغو می شود، یک رویداد loadabort
در نهایت با یک رویداد loadstop
دنبال می شود، حتی اگر تمام بارهای متعهد از آخرین رویداد loadstop
(در صورت وجود) لغو شده باشند.
توجه: هنگامی که بارگذاری یک URL درباره یا یک URL جاوا اسکریپت متوقف شد، 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- آدرس اینترنتی
رشته
- 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
- آدرس اینترنتی
رشته
- isTopLevel
بولی
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
زمانی فعال می شود که یک درخواست بارگیری سطح بالا به یک URL دیگر هدایت شود.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
- oldUrl
رشته
- آدرس جدید
رشته
- isTopLevel
بولی
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
هنگامی که یک بار شروع شده است شلیک می شود.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(url: string, isTopLevel: boolean) => void
- آدرس اینترنتی
رشته
- 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
جدید در embedder ایجاد می کند و پیمایش می کند:
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
رشته
- عرض اولیه
شماره
- ارتفاع اولیه
شماره
- نام
رشته
- windowOpenDisposition
"نادیده گرفتن"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "tab_foreground_new"
| "پنجره_جدید"
| "new_popup"
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
زمانی فعال می شود که صفحه مهمان نیاز به درخواست مجوز ویژه از embedder داشته باشد.
کد مثال زیر به صفحه مهمان اجازه دسترسی به webkitGetUserMedia
API را می دهد. توجه داشته باشید که برنامهای که از این کد مثال استفاده میکند باید خودش مجوزهای مانیفست 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"
| "دانلود"
| "لود پلاگین"
| "فایل سیستم"
| "تمام صفحه"
| "پنهان" - درخواست کنید
شی
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
- شناسه فرآیند
شماره
sizechanged
chrome.webviewTag.sizechanged.addListener(
callback: function,
)
زمانی فعال می شود که محتوای وب جاسازی شده از طریق autosize
تغییر اندازه داده شود. فقط در صورتی فعال می شود که autosize
فعال باشد.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
- عرض قدیمی
شماره
- قد قدیمی
شماره
- newWidth
شماره
- ارتفاع جدید
شماره
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
زمانی فعال می شود که فرآیند ارائه محتوای وب مهمان پاسخگو نباشد. اگر مهمان دوباره شروع به پاسخگویی کند، این رویداد یک بار با یک رویداد پاسخگو منطبق ایجاد می شود.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(processID: number) => void
- شناسه فرآیند
شماره
zoomchange
chrome.webviewTag.zoomchange.addListener(
callback: function,
)
هنگامی که بزرگنمایی صفحه تغییر می کند فعال می شود.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(oldZoomFactor: number, newZoomFactor: number) => void
- oldZoomFactor
شماره
- newZoomFactor
شماره