chrome.types

الوصف

تحتوي واجهة برمجة التطبيقات chrome.types على نماذج بيانات خاصة بمتصفِّح Chrome.

إعدادات Chrome

يوفّر النوع ChromeSetting مجموعة مشترَكة من الدوال (get() وset() وclear()). وناشر الحدث (onChange) للاطّلاع على إعدادات متصفّح Chrome. إعدادات الخادم الوكيل الأمثلة على ذلك الطريقة التي من المفترض أن يتم بها استخدام هذه الدوال.

النطاق ودورة الحياة

يميّز Chrome بين ثلاثة نطاقات مختلفة لإعدادات المتصفّح:

regular
تنطبق الإعدادات التي تم ضبطها في نطاق regular على نوافذ المتصفِّح العادية، ويتم اكتسابها من خلال وضع التصفُّح المتخفي. النوافذ إذا لم يتم استبدالها. يتم تخزين هذه الإعدادات على القرص وتظل كما هي حتى سيتم محوها من خلال الإضافة السارية أو تم إيقاف الإضافة المطبَّقة أو إلغاء تثبيتها.
incognito_persistent
لا تسري الإعدادات التي يتم ضبطها في نطاق incognito_persistent إلا على نوافذ التصفّح المتخفي. بالنسبة لهؤلاء، إلغاء إعدادات regular. يتم تخزين هذه الإعدادات على القرص وتظل كما هي حتى يتم أو تم محوها من خلال الإضافة السارية، أو تم إيقاف الإضافة الحاكمة أو إلغاء تثبيتها.
incognito_session_only
لا تسري الإعدادات التي يتم ضبطها في نطاق incognito_session_only إلا على نوافذ التصفّح المتخفي. بالنسبة لهؤلاء، إلغاء إعدادات regular وincognito_persistent. لا يتم تخزين هذه الإعدادات على القرص يتم محوها عند إغلاق آخر نافذة للتصفح المتخفي. ولا يمكن ضبطها إلا عندما يكون حقل واحد على الأقل نافذة التصفّح المتخفي مفتوحة.

الأولوية

يدير Chrome الإعدادات على طبقات مختلفة. تصف القائمة التالية الطبقات التي قد التأثير في الإعدادات الفعالة، من خلال زيادة ترتيب الأولوية.

  1. إعدادات النظام التي يوفرها نظام التشغيل
  2. مَعلمات سطر الأوامر
  3. الإعدادات التي توفّرها الإضافات
  4. السياسات

وكما تشير القائمة، قد تبطل السياسات أي تغييرات تحدّدها للإضافة. إِنْتَ استخدام الدالة get() لتحديد ما إذا كانت إضافتك قادرة على توفير إعدادات أو ما إذا كان سيتم إلغاء هذا الإعداد.

كما أشرنا سابقًا، يسمح Chrome باستخدام إعدادات مختلفة للنوافذ العادية والتصفح المتخفي . يوضح المثال التالي هذا السلوك. لنفترض أنه لا توجد سياسة تلغي الإعدادات وأن الإضافة يمكنها تعيين إعدادات النوافذ العادية (R) وإعدادات نوافذ التصفح المتخفي (I).

  • إذا تم ضبط (R) فقط، تكون هذه الإعدادات سارية لكل من نوافذ التصفح العادية ونوافذ التصفح المتخفي.
  • إذا تم ضبط (I) فقط، تكون هذه الإعدادات فعالة في نوافذ التصفح المتخفي فقط. النوافذ العادية استخدم الإعدادات التي تحددها الطبقات السفلى (خيارات سطر الأوامر وإعدادات النظام).
  • إذا تم ضبط كل من (R) و(I)، سيتم استخدام الإعدادات ذات الصلة لـ "الوضع العادي" و"التصفّح المتخفي" .

إذا أرادت إضافتان أو أكثر ضبط الإعداد نفسه على قيم مختلفة، سيتم تثبيت الإضافة. مؤخرًا لها الأولوية على الإضافات الأخرى. إذا كانت الإضافة المُثبتة مؤخرًا فقط (I)، يمكن تحديد إعدادات النوافذ العادية من قبل الإضافات.

والقيمة الفعالة للإعداد هي القيمة التي تنتج عن مراعاة قواعد الأسبقية. أُنشأها جون هنتر، الذي كان متخصصًا يستخدمه Chrome.

الأنواع

ChromeSetting

واجهة تسمح بالوصول إلى أحد إعدادات متصفِّح Chrome. للاطّلاع على مثال، يُرجى الانتقال إلى accessibilityFeatures.

أماكن إقامة

  • onChange

    الحدث <functionuffful>

    يتم تنشيطها بعد تغيير الإعداد.

    تبدو دالة onChange.addListener كما يلي: 

    (callback: function) => {...}

    • رد الاتصال

      دالة

      تظهر المَعلمة callback على النحو التالي: 

      (details: object) => void

      • التفاصيل

        كائن

        • incognitoSpecific

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

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

        • levelOfControl

          LevelOfControl

          مستوى التحكّم في الإعداد.

        • القيمة

          T

          قيمة الإعداد بعد التغيير.

  • محو

    فراغ

    وعود

    يؤدي هذا الإجراء إلى محو الإعداد واستعادة أي قيمة تلقائية.

    تبدو دالة clear كما يلي: 

    (details: object, callback?: function) => {...}

    • التفاصيل

      كائن

      الإعداد الذي تريد محوه.

      • نطاق

        ChromeSettingScope اختياري

        مكان محو الإعداد (الإعداد التلقائي: عادي).

    • رد الاتصال

      الدالة اختيارية

      تظهر المَعلمة callback على النحو التالي: 

      () => void

    • returns

      وعود <باطلة>

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

      تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

  • الحصول على

    فراغ

    وعود

    للحصول على قيمة الإعداد.

    تبدو دالة get كما يلي: 

    (details: object, callback?: function) => {...}

    • التفاصيل

      كائن

      الإعداد الذي يجب مراعاته.

      • وضع التصفُّح المتخفي

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

        تحديد ما إذا كان سيتم عرض القيمة التي تنطبق على جلسة التصفُّح المتخفي (الإعداد التلقائي "خطأ")

    • رد الاتصال

      الدالة اختيارية

      تظهر المَعلمة callback على النحو التالي: 

      (details: object) => void

      • التفاصيل

        كائن

        تمثّل هذه السمة تفاصيل القيمة الفعّالة حاليًا.

        • incognitoSpecific

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

          ما إذا كانت القيمة الفعلية محددة لجلسة التصفح المتخفي. لن تتوفّر هذه السمة إلا إذا كانت السمة incognito في المعلَمة details الخاصة بـ get() صحيحة.

        • levelOfControl

          LevelOfControl

          مستوى التحكّم في الإعداد.

        • القيمة

          T

          قيمة الإعداد.

    • returns

      Promise&lt;object&gt;

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

      تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

  • محدّدة

    فراغ

    وعود

    تضبط قيمة أحد الإعدادات.

    تبدو دالة set كما يلي: 

    (details: object, callback?: function) => {...}

    • التفاصيل

      كائن

      الإعداد الذي تريد تغييره.

      • نطاق

        ChromeSettingScope اختياري

        مكان ضبط الإعداد (الإعداد التلقائي: عادي).

      • القيمة

        T

        قيمة الإعداد. تجدر الإشارة إلى أن كل إعداد له نوع قيمة معيّن، ويتم وصفه مع الإعداد. يجب ألا تضبط الإضافة قيمة من نوع مختلف.

    • رد الاتصال

      الدالة اختيارية

      تظهر المَعلمة callback على النحو التالي: 

      () => void

    • returns

      وعود <باطلة>

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

      تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

ChromeSettingScope

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

نطاق Chromesetting. أحد

  • regular: إعداد الملف الشخصي العادي (الذي يتم اكتسابه من خلال الملف الشخصي في وضع التصفُّح المتخفي إذا لم يتم إلغاؤه في مكان آخر)
  • regular\_only: إعداد للملف الشخصي العادي فقط (غير مُكتسَب من الملف الشخصي في وضع التصفُّح المتخفي)
  • incognito\_persistent: إعداد الملف الشخصي في وضع التصفّح المتخفي الذي يستمر في إعادة تشغيل المتصفّح (يلغي الإعدادات المفضّلة العادية)
  • incognito\_session\_only: إعداد للملف الشخصي في وضع التصفّح المتخفي، ولا يمكن ضبطه إلا أثناء جلسة التصفّح المتخفي، ويتم حذفه عند انتهاء جلسة التصفّح المتخفي (يلغي هذا الإعداد الإعدادات المفضّلة العادية ووضع التصفّح المتخفي الدائم).

Enum

"عادي"

"regular_only"

"التصفّح الآمن"

"التصفّح_الجلسة_فقط"

LevelOfControl

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

أحد

  • not\_controllable: لا يمكن التحكّم فيه من خلال أي إضافة
  • controlled\_by\_other\_extensions: تتحكّم فيها إضافات ذات أولوية أعلى
  • controllable\_by\_this\_extension: يمكن التحكّم فيها من خلال هذه الإضافة
  • controlled\_by\_this\_extension: تتحكّم فيها هذه الإضافة

Enum

"not_controllable"

&quot;controlled_by_other_extensions&quot;
.

&quot;controllable_by_this_extension&quot;

&quot;controlled_by_this_extension&quot;
.