chrome.extensionTypes

شرح

chrome.extensionTypes API حاوی اعلان‌های نوع برای برنامه‌های افزودنی Chrome است.

انواع

CSSOrigin

Chrome 66+

منشا CSS تزریق شده

Enum

"نویسنده"

"کاربر"

DeleteInjectionDetails

Chrome 87+

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

خواص

  • همه فریم ها

    بولی اختیاری

    اگر allFrames true باشد، به این معنی است که CSS باید از تمام فریم‌های صفحه فعلی حذف شود. به طور پیش فرض، false است و فقط از فریم بالایی حذف می شود. اگر true و frameId تنظیم شده باشد، کد از فریم انتخاب شده و تمام فریم های فرزند آن حذف می شود.

  • کد

    رشته اختیاری

    کد CSS برای حذف.

  • cssOrigin

    CSSOorigin اختیاری است

    منشا CSS برای حذف. پیش‌فرض "author" است.

  • فایل

    رشته اختیاری

    فایل CSS برای حذف.

  • frameId

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

    فریمی که باید CSS از آن حذف شود. به طور پیش فرض 0 (قاب سطح بالا).

  • matchAboutBlank

    بولی اختیاری

    اگر matchAboutBlank درست باشد، اگر برنامه افزودنی شما به سند والد خود دسترسی داشته باشد، کد از فریم‌های about:blank و about:srcdoc نیز حذف می‌شود. به طور پیش فرض false است.

DocumentLifecycle

Chrome 106+

چرخه عمر سند قاب.

Enum

"پیش اجرا"

"فعال"

"کش شده"

"در انتظار_حذف"

ExecutionWorld

Chrome 111+

دنیای جاوا اسکریپت برای اجرای یک اسکریپت در داخل. می تواند یک دنیای جدا شده منحصر به فرد برای این برنامه افزودنی باشد، دنیای اصلی DOM که با جاوا اسکریپت صفحه به اشتراک گذاشته شده است، یا یک دنیای اسکریپت های کاربر که فقط برای اسکریپت های ثبت شده با User Scripts API در دسترس است.

Enum

"جدا شده"

"اصلی"

"USER_SCRIPT"

FrameType

Chrome 106+

نوع قاب.

Enum

"outermost_frame"

"قاب_حصاری"

"sub_frame"

ImageDetails

جزئیات در مورد فرمت و کیفیت یک تصویر.

خواص

  • قالب

    ImageFormat اختیاری است

    فرمت تصویر حاصل. پیش فرض "jpeg" است.

  • کیفیت

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

    هنگامی که فرمت "jpeg" است، کیفیت تصویر حاصل را کنترل می کند. این مقدار برای تصاویر PNG نادیده گرفته می شود. با کاهش کیفیت، تصویر به دست آمده مصنوعات بصری بیشتری خواهد داشت و تعداد بایت های مورد نیاز برای ذخیره آن کاهش می یابد.

ImageFormat

Chrome 44+

فرمت یک تصویر

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

Chrome 44+

به زودی که جاوا اسکریپت یا CSS به برگه تزریق می شود.

Enum

"سند_شروع"
اسکریپت بعد از هر فایلی از css تزریق می شود، اما قبل از اینکه هر DOM دیگری ساخته شود یا هر اسکریپت دیگری اجرا شود.

"document_end"
اسکریپت بلافاصله پس از تکمیل DOM، اما قبل از بارگیری منابع فرعی مانند تصاویر و فریم ها تزریق می شود.

"document_idle"
مرورگر زمانی را برای تزریق اسکریپت بین "document_end" و بلافاصله پس از فعال شدن رویداد window.onload انتخاب می کند. لحظه دقیق تزریق بستگی به پیچیدگی سند و مدت زمان بارگذاری آن دارد و برای سرعت بارگذاری صفحه بهینه شده است. اسکریپت های محتوایی که در "document_idle" اجرا می شوند، نیازی به گوش دادن به رویداد window.onload ندارند. آنها تضمین می شوند که پس از تکمیل DOM اجرا شوند. اگر یک اسکریپت قطعاً باید بعد از window.onload اجرا شود، برنامه افزودنی می‌تواند با استفاده از ویژگی document.readyState بررسی کند که آیا onload قبلاً اجرا شده است یا خیر.