chrome.extensionTypes

الوصف

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

الأنواع

ColorArray

في انتظار المراجعة

النوع

[عدد, عدد, عدد, عدد]

CSSOrigin

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

مصدر ملف CSS المُدرَج

التعداد

"author"

"user"

DeleteInjectionDetails

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

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

الخصائص

  • allFrames

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

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

  • رمز

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

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

  • cssOrigin

    ‫CSSOrigin اختياري

    مصدر خدمة مقارنة الأسعار المطلوب إزالتها. الإعداد التلقائي هو "author".

  • ملف

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

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

  • frameId

    رقم اختياري

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

  • matchAboutBlank

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

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

DocumentLifecycle

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

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

التعداد

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

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

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

التعداد

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

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

نوع اللقطة

التعداد

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

في انتظار المراجعة

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

النوع

ImageData

ImageDetails

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

الخصائص

  • التنسيق

    ‫ImageFormat اختياري

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

  • الجودة

    رقم اختياري

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

ImageFormat

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

تنسيق الصورة

التعداد

"jpeg"

"png"

InjectDetails

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

الخصائص

  • allFrames

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

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

  • رمز

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

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

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

  • cssOrigin

    ‫CSSOrigin اختياري

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

  • ملف

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

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

  • frameId

    رقم اختياري

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

  • matchAboutBlank

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

    إذا كان matchAboutBlank صحيحًا، يتم أيضًا إدخال الرمز في إطارَي about:blank وabout:srcdoc إذا كانت الإضافة يمكنها الوصول إلى المستند الرئيسي. لا يمكن إدراج الرمز في إطارات about:- ذات المستوى الأعلى. القيمة التلقائية هي 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.