chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

الوصف

تحتوي واجهة برمجة التطبيقات chrome.extensionTypes على تعريفات الأنواع لإضافات Chrome.

الأنواع

ColorArray

الإصدار 139 من Chrome والإصدارات الأحدث

النوع

[number, number, number, number]

CSSOrigin

الإصدار 66 من Chrome والإصدارات الأحدث

مصدر CSS الذي تم إدخاله

Enum

‫"author"

"user"

DeleteInjectionDetails

الإصدار 87 من Chrome أو الإصدارات الأحدث

تفاصيل خدمة CSS المطلوب إزالتها يجب ضبط سمة الرمز أو الملف، ولكن لا يمكن ضبط كليهما في الوقت نفسه.

الخصائص

  • allFrames

    قيمة منطقية اختيارية

    إذا كانت قيمة allFrames هي true، يعني ذلك أنّه يجب إزالة CSS من جميع الإطارات في الصفحة الحالية. يكون الإعداد التلقائي هو false وتتم إزالته من الإطار العلوي فقط. إذا تم ضبط true وframeId، تتم إزالة الرمز من الإطار المحدّد وجميع الإطارات الفرعية.

  • رمز

    string اختياري

    رمز CSS المطلوب إزالته

  • cssOrigin

    CSSOrigin اختيارية

    مصدر CSS المطلوب إزالته القيمة التلقائية هي "author".

  • ملف واحد

    string اختياري

    ملف CSS المطلوب إزالته

  • frameId

    number اختيارية

    الإطار الذي يجب إزالة CSS منه تكون القيمة التلقائية هي 0 (الإطار ذو المستوى الأعلى).

  • matchAboutBlank

    قيمة منطقية اختيارية

    إذا كانت قيمة matchAboutBlank صحيحة، تتم أيضًا إزالة الرمز من إطارات about:blank وabout:srcdoc إذا كان بإمكان الإضافة الوصول إلى المستند الرئيسي. القيمة التلقائية هي false.

DocumentLifecycle

الإصدار 106 من Chrome والإصدارات الأحدث

دورة حياة المستند للإطار

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

الإصدار 111 من Chrome والإصدارات الأحدث

تمثّل هذه السمة بيئة JavaScript التي يتم تنفيذ النص البرمجي فيها. يمكن أن يكون إما بيئة معزولة فريدة لهذه الإضافة، أو البيئة الرئيسية لنموذج DOM التي تتم مشاركتها مع JavaScript في الصفحة، أو بيئة نصوص برمجية للمستخدمين لا تتوفّر إلا للنصوص البرمجية المسجّلة باستخدام User Scripts API.

Enum

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

الإصدار 106 من Chrome والإصدارات الأحدث

نوع الإطار

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

الإصدار 139 من Chrome والإصدارات الأحدث

بيانات البكسل للصورة يجب أن يكون عنصر ImageData، على سبيل المثال، من عنصر canvas.

النوع

ImageData

ImageDetails

تفاصيل حول تنسيق الصورة وجودتها ومساحتها

الخصائص

  • التنسيق

    ImageFormat اختيارية

    تنسيق الصورة الناتجة القيمة التلقائية هي "jpeg".

  • الجودة

    number اختيارية

    عندما يكون التنسيق "jpeg"، يتحكّم في جودة الصورة الناتجة. يتم تجاهل هذه القيمة لصور PNG. ومع انخفاض الجودة، ستظهر في الصورة الناتجة المزيد من العيوب المرئية، وسيقل عدد وحدات البايت اللازمة لتخزينها.

ImageFormat

الإصدار 44 من Chrome أو الإصدارات الأحدث

تنسيق الصورة

Enum

"jpeg"

"png"

InjectDetails

تفاصيل النص البرمجي أو CSS المطلوب إدخالهما يجب ضبط سمة الرمز أو الملف، ولكن لا يمكن ضبط كليهما في الوقت نفسه.

الخصائص

  • allFrames

    قيمة منطقية اختيارية

    إذا كانت قيمة allFrames هي true، يعني ذلك أنّه يجب إدخال JavaScript أو CSS في جميع إطارات الصفحة الحالية. تكون القيمة التلقائية هي false ويتم إدخالها في الإطار العلوي فقط. إذا تم ضبط true وframeId، يتم إدراج الرمز في الإطار المحدّد وجميع الإطارات الفرعية.

  • رمز

    string اختياري

    رمز JavaScript أو CSS المطلوب إدخاله

    تحذير: يجب توخّي الحذر عند استخدام المَعلمة code. قد يؤدي الاستخدام غير الصحيح إلى تعرُّض الإضافة لهجمات النصوص البرمجية عبر المواقع الإلكترونية

  • cssOrigin

    CSSOrigin اختيارية

    الإصدار 66 من Chrome والإصدارات الأحدث

    مصدر CSS المطلوب إدخاله. يمكن تحديد ذلك لملفات CSS فقط، وليس لملفات JavaScript. القيمة التلقائية هي "author".

  • ملف واحد

    string اختياري

    ملف JavaScript أو CSS المطلوب إدخاله

  • frameId

    number اختيارية

    الإصدار 50 من Chrome أو الإصدارات الأحدث

    الإطار الذي يجب إدخال النص البرمجي أو CSS فيه تكون القيمة التلقائية هي 0 (الإطار ذو المستوى الأعلى).

  • matchAboutBlank

    قيمة منطقية اختيارية

    إذا كانت قيمة matchAboutBlank هي "صحيح"، يتم أيضًا إدخال الرمز في إطارَي about:blank وabout:srcdoc إذا كان بإمكان الإضافة الوصول إلى المستند الرئيسي. لا يمكن إدراج الرمز في إطارات about:-frames ذات المستوى الأعلى. القيمة التلقائية هي false.

  • runAt

    RunAt اختيارية

    أقرب وقت سيتم فيه إدخال JavaScript أو CSS في علامة التبويب. القيمة التلقائية هي "document_idle".

RunAt

الإصدار 44 من Chrome أو الإصدارات الأحدث

أقرب وقت سيتم فيه إدخال JavaScript أو CSS في علامة التبويب.

Enum

‫"document_start"
يتم إدخال النص البرمجي بعد أي ملفات من CSS، ولكن قبل إنشاء أي نموذج DOM آخر أو تشغيل أي نص برمجي آخر.

"document_end"
يتم إدخال النص البرمجي فور اكتمال نموذج العناصر في المستند (DOM)، ولكن قبل تحميل الموارد الفرعية، مثل الصور والإطارات.

"document_idle"
يختار المتصفّح وقتًا لإدخال النص البرمجي بين "document_end" وبعد بدء الحدث window.onload مباشرةً. تعتمد اللحظة المحددة للإدخال على مدى تعقيد المستند والوقت الذي يستغرقه تحميله، ويتم تحسينها لزيادة سرعة تحميل الصفحة. لا تحتاج نصوص المحتوى البرمجية التي تعمل في "document_idle" إلى الاستماع إلى الحدث window.onload، ويُضمن تشغيلها بعد اكتمال DOM. إذا كان من الضروري تشغيل نص برمجي بعد window.onload، يمكن للإضافة التحقّق مما إذا كان قد تم تشغيل onload من قبل باستخدام السمة document.readyState.