chrome.webviewTag

توضیحات

از برچسب 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

Chrome 44+

جزئیات اسکریپت محتوا برای تزریق. برای جزئیات بیشتر به مستندات اسکریپت های محتوا مراجعه کنید.

خواص

  • 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

Chrome 44+

خواص

  • بررسی شد

    بولی اختیاری

    وضعیت اولیه یک چک باکس یا آیتم رادیویی: درست برای انتخاب شده و نادرست برای انتخاب نشده. فقط یک آیتم رادیویی را می توان در یک زمان در یک گروه معین از آیتم های رادیویی انتخاب کرد.

  • زمینه ها

    [ 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 به شکل زیر است: 

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

    • اطلاعات

      OnClickData

      اطلاعاتی درباره مورد کلیک شده و زمینه ای که کلیک روی آن انجام شده است.

ContextMenus

Chrome 44+

خواص

  • در نمایش

    رویداد<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) => {...}

    • menuItemId

      رشته | شماره

      شناسه مورد منوی زمینه برای حذف.

    • پاسخ به تماس

      عملکرد اختیاری

      پارامتر callback به نظر می رسد: 

      () => void

  • حذف همه

    باطل

    تمام موارد منوی زمینه اضافه شده به این webview را حذف می کند.

    تابع removeAll به شکل زیر است: 

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

    • پاسخ به تماس

      عملکرد اختیاری

      پارامتر callback به نظر می رسد: 

      () => void

  • به روز رسانی کنید

    باطل

    آیتم منوی زمینه ایجاد شده قبلی را به روز می کند.

    عملکرد update به نظر می رسد: 

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

    • شناسه

      رشته | شماره

      شناسه مورد برای به روز رسانی.

    • updateProperties

      شی

      خواص برای به روز رسانی مقادیر مشابه تابع create را می پذیرد.

    • پاسخ به تماس

      عملکرد اختیاری

      پارامتر callback به نظر می رسد: 

      () => void

ContextMenuUpdateProperties

Chrome 44+

خواص

  • بررسی شد

    بولی اختیاری

    وضعیت یک چک باکس یا آیتم رادیویی: درست برای انتخاب شده و نادرست برای انتخاب نشده. فقط یک آیتم رادیویی را می توان در یک زمان در یک گروه معین از آیتم های رادیویی انتخاب کرد.

  • زمینه ها

    [ ContextType , ... ContextType []] اختیاری است

    فهرست زمینه هایی که این آیتم منو در آنها ظاهر می شود.

  • documentUrl Patterns

    رشته[] اختیاری است

    به شما امکان می دهد مورد را محدود کنید تا فقط برای اسنادی اعمال شود که URL آنها با یکی از الگوهای داده شده مطابقت دارد. (این در مورد قاب ها نیز صدق می کند.) برای جزئیات بیشتر در مورد قالب یک الگو، به الگوهای مطابقت مراجعه کنید.

  • فعال شد

    بولی اختیاری

    آیا این آیتم منوی زمینه فعال یا غیرفعال است.

  • شناسه والدین

    رشته | شماره اختیاری

    شناسه یک آیتم منوی والدین؛ این باعث می شود که مورد فرزند آیتمی که قبلاً اضافه شده باشد. توجه: شما نمی توانید یک مورد را به فرزند یکی از فرزندان خود تغییر دهید.

  • الگوهای targetUrl

    رشته[] اختیاری است

    شبیه documentUrlPatterns است، اما به شما امکان می‌دهد بر اساس ویژگی src تگ‌های img/audio/video و href تگ‌های انکر فیلتر کنید.

  • عنوان

    رشته اختیاری

    متنی که باید در مورد نمایش داده شود

  • نوع

    ItemType اختیاری است

    نوع آیتم منو

  • کلیک کنید

    باطل اختیاری

    تابعی که با کلیک روی آیتم منو دوباره فراخوانی می شود.

    تابع onclick به شکل زیر است: 

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

    • اطلاعات

      OnClickData

      اطلاعاتی درباره مورد کلیک شده و زمینه ای که کلیک روی آن انجام شده است.

ContextType

Chrome 44+

زمینه های مختلفی که یک منو می تواند در آنها ظاهر شود. مشخص کردن "همه" معادل ترکیبی از همه زمینه های دیگر است.

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 در صفحه مطابقت داشت.

  • انتخاب راست

    SelectionRect

    یک مستطیل را در اطراف منطبق فعال در مختصات صفحه توصیف می کند.

FindOptions

گزینه هایی برای درخواست یافتن

خواص

  • عقب مانده

    بولی اختیاری

    برای یافتن موارد منطبق به ترتیب معکوس پرچم گذاری کنید. مقدار پیش فرض false است.

  • کبریت کیس

    بولی اختیاری

    پرچم برای مطابقت با حساسیت کوچک و بزرگ. مقدار پیش فرض false است.

FullscreenPermissionRequest

Chrome 43+

نوع شی request که یک رویداد DOM permissionrequest fullscreen را همراهی می کند.

خواص

  • منشاء

    رشته

    مبدأ قاب داخل webview که درخواست تمام صفحه را آغاز کرد.

  • اجازه می دهد

    باطل

    اجازه درخواست مجوز.

    تابع allow به نظر می رسد: 

    () => {...}

  • انکار کند

    باطل

    درخواست مجوز را رد کنید.

    تابع deny به نظر می رسد: 

    () => {...}

GeolocationPermissionRequest

نوع شی request که همراه با رویداد DOM permissionrequest geolocation است.

خواص

  • آدرس اینترنتی

    رشته

    URL قاب درخواست دسترسی به داده های موقعیت جغرافیایی.

  • اجازه می دهد

    باطل

    اجازه درخواست مجوز.

    تابع allow به نظر می رسد: 

    () => {...}

  • انکار کند

    باطل

    درخواست مجوز را رد کنید. اگر allow نشود، این رفتار پیش‌فرض است.

    تابع deny به نظر می رسد: 

    () => {...}

HidPermissionRequest

Chrome 125+

نوع شی request که با یک رویداد DOM permissionrequest hid همراه است.

خواص

  • آدرس اینترنتی

    رشته

    URL قاب درخواست دسترسی به HID API.

  • اجازه می دهد

    باطل

    اجازه درخواست مجوز.

    تابع allow به نظر می رسد: 

    () => {...}

  • انکار کند

    باطل

    درخواست مجوز را رد کنید. اگر allow نشود، این رفتار پیش‌فرض است.

    تابع deny به نظر می رسد: 

    () => {...}

InjectDetails

جزئیات اسکریپت یا CSS برای تزریق. کد یا ویژگی فایل باید تنظیم شود، اما ممکن است هر دو به طور همزمان تنظیم نشوند.

خواص

  • کد

    رشته اختیاری

    کد جاوا اسکریپت یا CSS برای تزریق.

    هشدار: در استفاده از پارامتر code دقت کنید. استفاده نادرست از آن ممکن است برنامه شما را به حملات اسکریپت نویسی متقابل سایت باز کند.

  • فایل

    رشته اختیاری

    فایل جاوا اسکریپت یا CSS برای تزریق.

InjectionItems

Chrome 44+

نوع آیتم تزریق: کد یا مجموعه ای از فایل ها.

خواص

  • کد

    رشته اختیاری

    کد جاوا اسکریپت یا 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

Chrome 44+

رابطی که دسترسی به رویدادهای 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

Chrome 43+

نحوه انجام زوم در webview را مشخص می کند.

Enum

"بر اساس مبدا"
تغییرات بزرگ‌نمایی در مبدا صفحه بزرگ‌نمایی شده باقی می‌ماند، یعنی تمام نمای‌های وب دیگر در همان پارتیشن که به همان مبدا هدایت می‌شوند نیز بزرگ‌نمایی خواهند شد. علاوه بر این، تغییرات بزرگ‌نمایی per-origin با مبدا ذخیره می‌شوند، به این معنی که هنگام پیمایش به صفحات دیگر در همان مبدا، همه آنها به همان ضریب بزرگنمایی بزرگ‌نمایی می‌شوند.

"برای هر نمایش"
تغییرات بزرگنمایی فقط در این نمای وب اعمال می شود و تغییرات بزرگنمایی در سایر نمای وب تأثیری بر بزرگنمایی این نمای وب نخواهد داشت. همچنین، تغییرات زوم per-view در ناوبری بازنشانی می‌شوند. پیمایش در یک نمای وب همیشه صفحات را با فاکتورهای بزرگنمایی هر منبع (در محدوده پارتیشن) بارگذاری می کند.

"معلول"
تمام بزرگنمایی در نمای وب را غیرفعال می کند. محتوا به سطح بزرگنمایی پیش‌فرض برمی‌گردد و تمام تغییرات زوم تلاش شده نادیده گرفته می‌شوند.

خواص

contentWindow

مرجع شی که می تواند برای ارسال پیام به صفحه مهمان استفاده شود.

تایپ کنید

ContentWindow

contextMenus

Chrome 44+

شبیه به ContextMenus API کروم است، اما به جای مرورگر، برای webview اعمال می شود. از webview.contextMenus API برای افزودن موارد به منوی زمینه webview استفاده کنید. می‌توانید انتخاب کنید که افزوده‌های منوی زمینه‌تان برای چه نوع شی‌هایی مانند تصاویر، پیوندها و صفحات اعمال می‌شود.

تایپ کنید

منوهای زمینه

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) و webview.addContentScripts را برای افزودن "myRule" فراخوانی می کند، باید منتظر پیمایش بعدی باشید تا اسکریپت ها تزریق شوند. اگر می خواهید تزریق فوری انجام شود، executeScript کار درست را انجام می دهد.

قوانین حفظ می شوند حتی اگر فرآیند مهمان از کار بیفتد یا از بین برود یا حتی اگر webview مجدداً ایجاد شود.

برای جزئیات بیشتر به مستندات اسکریپت های محتوا مراجعه کنید.

پارامترها

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

      رشته

      URL داده ای که تصویری از ناحیه قابل مشاهده برگه گرفته شده را رمزگذاری می کند. ممکن است برای نمایش به ویژگی 'src' یک عنصر HTML Image اختصاص داده شود.

clearData()

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

داده های مرور را برای پارتیشن webview پاک می کند.

پارامترها

  • گزینه ها

    ClearDataOptions

    گزینه هایی که تعیین می کنند کدام داده ها پاک شوند.

  • انواع

    ClearDataTypeSet

    انواع داده هایی که باید پاک شوند.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    () => void

executeScript()

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

کد جاوا اسکریپت را به صفحه مهمان تزریق می کند.

کد نمونه زیر از تزریق اسکریپت برای تنظیم رنگ پس‌زمینه صفحه مهمان به رنگ قرمز استفاده می‌کند: 

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

پارامترها

  • جزئیات

    InjectDetails

    جزئیات اسکریپت برای اجرا.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر 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 62+
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 43+
chrome.webviewTag.getZoomMode(
  callback: function,
)

حالت زوم فعلی را دریافت می کند.

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      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 را به صفحه مهمان تزریق می کند.

پارامترها

  • جزئیات

    InjectDetails

    جزئیات CSS برای درج.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر 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,
)

یک URL داده را با یک URL پایه مشخص شده بارگیری می کند که برای پیوندهای نسبی استفاده می شود. به صورت اختیاری، یک URL مجازی می تواند ارائه شود تا به جای URL داده به کاربر نشان داده شود.

پارامترها

  • dataUrl

    رشته

    URL داده برای بارگیری.

  • baseUrl

    رشته

    URL اصلی که برای پیوندهای نسبی استفاده خواهد شد.

  • virtualUrl

    رشته اختیاری

    URL که به کاربر نمایش داده می شود (در نوار آدرس).

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();

پارامترها

  • اسکریپتNameList

    رشته[] اختیاری است

    فهرستی از نام اسکریپت های محتوا که حذف خواهند شد. اگر لیست خالی باشد، تمام اسکریپت های محتوای اضافه شده به webview حذف خواهند شد.

setAudioMuted()

Chrome 62+
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

وضعیت بی‌صدا کردن نمای وب را تنظیم می‌کند.

پارامترها

  • بی صدا

    بولی

    مقدار صدا را بی صدا کنید

setSpatialNavigationEnabled()

Chrome 71+
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 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 مطابقت فعال را هایلایت نگه می دارد و کلیک کاربر روی آن مسابقه را شبیه سازی می کند. عمل پیش فرض 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

    • نوع پیام

      "هشدار"
      | "تأیید"
      | "سریع"

    • پیام متن

      رشته

    • گفتگو

      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

    • شناسه فرآیند

      شماره

    • دلیل

      "عادی"
      | "غیرطبیعی"
      | "تصادف"
      | "کشتن"

findupdate

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

هنگامی که نتایج یافتن جدید برای یک درخواست یافتن فعال در دسترس باشد فعال می شود. این ممکن است چندین بار برای یک درخواست یافتن به عنوان موارد منطبق پیدا شود.

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

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

    • متن جستجو

      رشته

    • numberOfMatches

      شماره

    • activeMatchOrdinal

      شماره

    • انتخاب راست

      SelectionRect

    • لغو شد

      بولی

    • به روز رسانی نهایی

      رشته

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

    • پنجره

      NewWindow

    • 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

      شماره