chrome.extensionTypes

الوصف

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

الأنواع

CSSOrigin

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

أصل محتوى CSS الذي تم إدخاله.

التعداد

DeleteInjectionDetails

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

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

أماكن إقامة

  • allFrames

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

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

  • رمز

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

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

  • cssOrigin

    CSSOrigin اختيارية

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

  • ملف

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

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

  • frameId

    الرقم اختياري

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

  • matchAboutBlank

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

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

DocumentLifecycle

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

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

التعداد

ExecutionWorld

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

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

التعداد

"ISOLATED"

FrameType

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

نوع الإطار

التعداد

"outermost_frame"

"fenced_frame"

"sub_frame"

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 اختيارية

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

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

  • ملف

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

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

  • frameId

    الرقم اختياري

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

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

  • matchAboutBlank

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

    إذا كانت قيمة 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.