chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأنواع

ColorArray

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

النوع

[عدد، عدد، عدد، عدد]

CSSOrigin

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

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

تعداد

"author"

"user"

DeleteInjectionDetails

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

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

الخصائص

  • allFrames

    boolean اختياري

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

  • رمز

    سلسلة اختيارية

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

  • cssOrigin

    CSSOrigin اختياري

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

  • ملف واحد

    سلسلة اختيارية

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

  • frameId

    number اختياري

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

  • matchAboutBlank

    boolean اختياري

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

DocumentLifecycle

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

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

تعداد

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

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

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

تعداد

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

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

تمثّل هذه السمة نوع الإطار.

تعداد

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

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

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

النوع

ImageData

ImageDetails

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

الخصائص

  • التنسيق

    ‫ImageFormat اختيارية

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

  • الجودة

    number اختياري

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

ImageFormat

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

تنسيق الصورة

تعداد

"jpeg"

"png"

InjectDetails

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

الخصائص

  • allFrames

    boolean اختياري

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

  • رمز

    سلسلة اختيارية

    رمز JavaScript أو CSS المطلوب إضافته

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

  • cssOrigin

    CSSOrigin اختياري

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

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

  • ملف واحد

    سلسلة اختيارية

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

  • frameId

    number اختياري

    Chrome 50+

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

  • matchAboutBlank

    boolean اختياري

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

  • runAt

    RunAt اختياري

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

RunAt

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

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

تعداد

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

‫"document_end"
يتم إدخال النص البرمجي مباشرةً بعد اكتمال DOM، ولكن قبل تحميل الموارد الفرعية، مثل الصور والإطارات.

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