browser.extensionTypes

شرح

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

انواع

ColorArray

Chrome نسخه ۱۳۹ به بالا browser.* ‎ از Chrome نسخه ۱۴۸

نوع

[number, number, number, number]

CSSOrigin

Chrome نسخه ۶۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

مبدأ CSS تزریق‌شده.

شمارشی

«نویسنده»

«کاربر»

DeleteInjectionDetails

Chrome نسخه ۸۷ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸

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

مشخصات

  • allFrames

    بولی اختیاری

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

  • کد

    رشته اختیاری

    کد CSS برای حذف.

  • cssOrigin

    CSSOrigin اختیاری

    مبدأ CSS برای حذف. پیش‌فرض‌ها به "author".

  • فایل

    رشته اختیاری

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

  • frameId

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

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

  • matchAboutBlank

    بولی اختیاری

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

DocumentLifecycle

Chrome 106+ browser.* از Chrome 148

چرخه حیات سند قاب.

شمارشی

«پیش‌پرداز»

«فعال»

«cached»

«pending_deletion»

ExecutionWorld

Chrome 111+ browser.* از Chrome 148

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

شمارشی

"ISOLATED"

«MAIN»

"USER_SCRIPT"

FrameType

Chrome 106+ browser.* از Chrome 148

نوع قاب.

شمارشی

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome نسخه ۱۳۹ به بالا browser.* ‎ از Chrome نسخه ۱۴۸

داده‌های پیکسل برای تصویر. باید یک شیء ImageData باشد؛ برای مثال، از یک عنصر canvas.

نوع

ImageData

ImageDetails

جزئیات مربوط به قالب، کیفیت، و ناحیه تصویر.

مشخصات

  • قالب

    ImageFormat اختیاری

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

  • کیفیت

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

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

ImageFormat

Chrome نسخه ۴۴ و بالاتر browser.* از Chrome نسخه ۱۴۸

قالب تصویر.

شمارشی

"jpeg"

"png"

InjectDetails

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

مشخصات

  • allFrames

    بولی اختیاری

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

  • کد

    رشته اختیاری

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

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

  • cssOrigin

    CSSOrigin اختیاری

    Chrome نسخه ۶۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

    مبدأ CSS برای تزریق. این مورد فقط برای CSS قابل‌تعیین است، نه جاوا اسکریپت. پیش‌فرض‌ها به "author".

  • فایل

    رشته اختیاری

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

  • frameId

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

    Chrome 50+ browser.* از Chrome 148

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

  • matchAboutBlank

    بولی اختیاری

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

  • runAt

    RunAt اختیاری

    زودترین زمانی که جاوا اسکریپت یا CSS به برگه تزریق خواهد شد. به‌طور پیش‌فرض روی «document_idle» تنظیم شده است.

RunAt

Chrome نسخه ۴۴ و بالاتر browser.* از Chrome نسخه ۱۴۸

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

شمارشی

«document_start»
دستورات پس‌از هر فایلی از css تزریق می‌شود، اما قبل‌از اینکه DOM دیگری ساخته شود یا دستورات دیگری اجرا شود.

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

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