تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex
توضیحات
API chrome.extensionTypes شامل اعلان‌های نوع برای افزونه‌های کروم است.
انواع
ColorArray
نوع
[عدد، عدد، عدد، عدد]
شمارشی
«نویسنده» "کاربر"
DeleteInjectionDetails
جزئیات CSS برای حذف. یا کد یا ویژگی فایل باید تنظیم شوند، اما هر دو را نمی‌توان همزمان تنظیم کرد.
خواص
- همه فریم‌ها
بولی اختیاری
اگر allFrames
trueباشد، به این معنی است که CSS باید از تمام فریم‌های صفحه فعلی حذف شود. به طور پیش‌فرض،falseاست و فقط از فریم بالایی حذف می‌شود. اگرtrueوframeIdتنظیم شده باشد، کد از فریم انتخاب شده و تمام فریم‌های فرزند آن حذف می‌شود. - کد
رشته اختیاری
کد CSS برای حذف.
- cssOrigin
CSSOrigin اختیاری
مبدا CSS که باید حذف شود. مقدار پیش‌فرض آن
"author"است. - فایل
رشته اختیاری
فایل CSS برای حذف.
- شناسه قاب
شماره اختیاری
فریمی که CSS باید از آن حذف شود. مقدار پیش‌فرض آن 0 است (فریم سطح بالا).
- matchAboutBlank
بولی اختیاری
اگر matchAboutBlank مقدار true داشته باشد، در صورتی که افزونه شما به سند والد خود دسترسی داشته باشد، کد از فریم‌های about:blank و about:srcdoc نیز حذف می‌شود. به طور پیش‌فرض مقدار
falseاست.
DocumentLifecycle
چرخه حیات سند فریم.
شمارشی
"پیش‌رندر" "فعال" "ذخیره شده" "در انتظار حذف"
ExecutionWorld
دنیای جاوا اسکریپت برای اجرای یک اسکریپت. می‌تواند یک دنیای ایزوله و منحصر به فرد برای این افزونه باشد، دنیای اصلی DOM که با جاوا اسکریپت صفحه به اشتراک گذاشته شده است، یا یک دنیای اسکریپت‌های کاربر که فقط برای اسکریپت‌های ثبت شده در API اسکریپت‌های کاربر در دسترس است.
شمارشی
«منزوی» "اصلی" "اسکریپت کاربر"
FrameType
نوع قاب.
شمارشی
"بیرونی‌ترین_قاب" "قاب_حصارکشی شده" "زیر_فریم"
ImageDataType
داده‌های پیکسلی برای یک تصویر. باید یک شیء ImageData باشد؛ برای مثال، از یک عنصر canvas .
نوع
داده تصویر
ImageDetails
جزئیات مربوط به فرمت، کیفیت و مساحت یک تصویر.
خواص
- قالب
قالب تصویر اختیاری
فرمت تصویر حاصل. پیش‌فرض
"jpeg"است. - کیفیت
شماره اختیاری
وقتی فرمت
"jpeg"باشد، کیفیت تصویر حاصل را کنترل می‌کند. این مقدار برای تصاویر PNG نادیده گرفته می‌شود. با کاهش کیفیت، تصویر حاصل مصنوعات بصری بیشتری خواهد داشت و تعداد بایت‌های مورد نیاز برای ذخیره آن کاهش می‌یابد.
ImageFormat
فرمت یک تصویر.
شمارشی
«جی‌پی‌جی» "پی ان جی"
InjectDetails
جزئیات اسکریپت یا CSS برای تزریق. یا کد یا ویژگی فایل باید تنظیم شوند، اما هر دو را نمی‌توان همزمان تنظیم کرد.
خواص
- همه فریم‌ها
بولی اختیاری
اگر allFrames
trueباشد، به این معنی است که جاوا اسکریپت یا CSS باید به تمام فریم‌های صفحه فعلی تزریق شود. به طور پیش‌فرض، مقدار آنfalseاست و فقط به فریم بالایی تزریق می‌شود. اگرtrueوframeIdتنظیم شده باشد، کد در فریم انتخاب شده و تمام فریم‌های فرزند آن وارد می‌شود. - کد
رشته اختیاری
کد جاوا اسکریپت یا CSS برای تزریق.
هشدار: در استفاده از پارامتر
codeدقت کنید. استفاده نادرست از آن ممکن است افزونه شما را در معرض حملات اسکریپت نویسی بین سایتی قرار دهد. - cssOrigin
CSSOrigin اختیاری
کروم ۶۶+مبدا CSS برای تزریق. این مورد فقط می‌تواند برای CSS مشخص شود، نه جاوا اسکریپت. مقدار پیش‌فرض
"author"است. - فایل
رشته اختیاری
فایل جاوا اسکریپت یا CSS برای تزریق.
- شناسه قاب
شماره اختیاری
کروم ۵۰+فریمی که اسکریپت یا CSS باید در آن تزریق شود. مقدار پیش‌فرض آن 0 است (فریم سطح بالا).
- matchAboutBlank
بولی اختیاری
اگر matchAboutBlank مقدار true داشته باشد، در صورتی که افزونه شما به سند والد خود دسترسی داشته باشد، کد در فریم‌های about:blank و about:srcdoc نیز تزریق می‌شود. کد را نمی‌توان در فریم‌های سطح بالای about:-frames وارد کرد. به طور پیش‌فرض مقدار
falseاست. - اجرا کن
اجرای اختیاری
زودترین زمانی که جاوا اسکریپت یا CSS به تب تزریق شود. مقدار پیش‌فرض "document_idle" است.
RunAt
هرچه زودتر جاوا اسکریپت یا CSS به تب تزریق شود.
شمارشی
"شروع_سند" "پایان سند" "سند_بی‌کار"
اسکریپت بعد از هر فایلی از css تزریق می‌شود، اما قبل از اینکه هر DOM دیگری ساخته شود یا هر اسکریپت دیگری اجرا شود.
اسکریپت بلافاصله پس از تکمیل DOM تزریق می‌شود، اما قبل از اینکه منابع فرعی مانند تصاویر و فریم‌ها بارگذاری شوند.
مرورگر زمانی را برای تزریق اسکریپت بین "document_end" و بلافاصله پس از اجرای رویداد window.onload انتخاب می‌کند. لحظه دقیق تزریق به پیچیدگی سند و مدت زمان بارگذاری آن بستگی دارد و برای سرعت بارگذاری صفحه بهینه شده است. اسکریپت‌های محتوایی که در "document_idle" اجرا می‌شوند نیازی به گوش دادن به رویداد window.onload ندارند. آنها تضمین می‌کنند که پس از تکمیل DOM اجرا شوند. اگر یک اسکریپت قطعاً نیاز به اجرا پس از window.onload داشته باشد، افزونه می‌تواند با استفاده از ویژگی document.readyState بررسی کند که آیا onload قبلاً اجرا شده است یا خیر.