شرح
chrome.extensionTypes API حاوی اعلان‌های نوع برای برنامه‌های افزودنی Chrome است.
انواع
Enum
"نویسنده" "کاربر"
DeleteInjectionDetails
جزئیات CSS برای حذف. کد یا ویژگی فایل باید تنظیم شود، اما ممکن است هر دو به طور همزمان تنظیم نشوند.
خواص
- همه فریم ها
بولی اختیاری
اگر allFrames
trueباشد، به این معنی است که CSS باید از تمام فریم‌های صفحه فعلی حذف شود. به طور پیش فرض،falseاست و فقط از فریم بالایی حذف می شود. اگرtrueوframeIdتنظیم شده باشد، کد از فریم انتخاب شده و تمام فریم های فرزند آن حذف می شود. - کد
رشته اختیاری
کد CSS برای حذف.
- cssOrigin
CSSOorigin اختیاری است
منشا CSS برای حذف. پیش‌فرض
"author"است. - فایل
رشته اختیاری
فایل CSS برای حذف.
- frameId
شماره اختیاری
فریمی که باید CSS از آن حذف شود. به طور پیش فرض 0 (قاب سطح بالا).
- matchAboutBlank
بولی اختیاری
اگر matchAboutBlank درست باشد، اگر برنامه افزودنی شما به سند والد خود دسترسی داشته باشد، کد از فریم‌های about:blank و about:srcdoc نیز حذف می‌شود. به طور پیش فرض
falseاست.
DocumentLifecycle
چرخه عمر سند قاب.
Enum
"پیش اجرا" "فعال" "کش شده" "در انتظار_حذف"
ExecutionWorld
دنیای جاوا اسکریپت برای اجرای یک اسکریپت در داخل. می تواند یک دنیای جدا شده منحصر به فرد برای این برنامه افزودنی باشد، دنیای اصلی DOM که با جاوا اسکریپت صفحه به اشتراک گذاشته شده است، یا یک دنیای اسکریپت های کاربر که فقط برای اسکریپت های ثبت شده با User Scripts API در دسترس است.
Enum
"جدا شده" "اصلی" "USER_SCRIPT"
FrameType
نوع قاب.
Enum
"outermost_frame" "قاب_حصاری" "sub_frame"
ImageDetails
جزئیات در مورد فرمت و کیفیت یک تصویر.
خواص
- قالب
ImageFormat اختیاری است
فرمت تصویر حاصل. پیش فرض
"jpeg"است. - کیفیت
شماره اختیاری
هنگامی که فرمت
"jpeg"است، کیفیت تصویر حاصل را کنترل می کند. این مقدار برای تصاویر PNG نادیده گرفته می شود. با کاهش کیفیت، تصویر به دست آمده مصنوعات بصری بیشتری خواهد داشت و تعداد بایت های مورد نیاز برای ذخیره آن کاهش می یابد.
ImageFormat
فرمت یک تصویر
Enum
"jpeg" "png"
InjectDetails
جزئیات اسکریپت یا CSS برای تزریق. کد یا ویژگی فایل باید تنظیم شود، اما ممکن است هر دو به طور همزمان تنظیم نشوند.
خواص
- همه فریم ها
بولی اختیاری
اگر allFrames
trueباشد، به این معنی است که جاوا اسکریپت یا CSS باید به تمام فریم‌های صفحه فعلی تزریق شود. به طور پیش فرض،falseاست و فقط به فریم بالایی تزریق می شود. اگرtrueوframeIdتنظیم شده باشد، کد در فریم انتخاب شده و تمام فریم های فرزند آن درج می شود. - کد
رشته اختیاری
کد جاوا اسکریپت یا CSS برای تزریق.
هشدار: در استفاده از پارامتر
codeدقت کنید. استفاده نادرست از آن ممکن است برنامه افزودنی شما را به حملات اسکریپت نویسی متقابل سایت باز کند - cssOrigin
CSSOorigin اختیاری است
Chrome 66+منشا CSS برای تزریق. این ممکن است فقط برای CSS مشخص شود، نه جاوا اسکریپت. پیش‌فرض
"author"است. - فایل
رشته اختیاری
فایل جاوا اسکریپت یا CSS برای تزریق.
- frameId
شماره اختیاری
Chrome 50+فریمی که اسکریپت یا CSS باید در آن تزریق شود. به طور پیش فرض 0 (قاب سطح بالا).
- matchAboutBlank
بولی اختیاری
اگر matchAboutBlank درست باشد، اگر برنامه افزودنی شما به سند والد خود دسترسی داشته باشد، کد در فریم‌های about:blank و about:srcdoc نیز تزریق می‌شود. کد را نمی توان در سطح بالا در مورد:-frames درج کرد. به طور پیش فرض
falseاست. - runAt
RunAt اختیاری است
به زودی که جاوا اسکریپت یا CSS به برگه تزریق می شود. پیش‌فرض «document_idle» است.
RunAt
به زودی که جاوا اسکریپت یا CSS به برگه تزریق می شود.
Enum
"سند_شروع" "document_end" "document_idle"
اسکریپت بعد از هر فایلی از css تزریق می شود، اما قبل از اینکه هر DOM دیگری ساخته شود یا هر اسکریپت دیگری اجرا شود.
اسکریپت بلافاصله پس از تکمیل DOM، اما قبل از بارگیری منابع فرعی مانند تصاویر و فریم ها تزریق می شود.
مرورگر زمانی را برای تزریق اسکریپت بین "document_end" و بلافاصله پس از فعال شدن رویداد window.onload انتخاب می کند. لحظه دقیق تزریق بستگی به پیچیدگی سند و مدت زمان بارگذاری آن دارد و برای سرعت بارگذاری صفحه بهینه شده است. اسکریپت های محتوایی که در "document_idle" اجرا می شوند، نیازی به گوش دادن به رویداد window.onload ندارند. آنها تضمین می شوند که پس از تکمیل DOM اجرا شوند. اگر یک اسکریپت قطعاً باید بعد از window.onload اجرا شود، برنامه افزودنی می‌تواند با استفاده از ویژگی document.readyState بررسی کند که آیا onload قبلاً اجرا شده است یا خیر.