chrome.privacy

الوصف

يمكنك استخدام chrome.privacy API للتحكّم في استخدام الميزات التي يمكن أن تؤثر في خصوصية المستخدم في Chrome. تعتمد واجهة برمجة التطبيقات هذه على النموذج الأولي لإعداد Chromeإعداد لنوع واجهة برمجة التطبيقات للحصول على إعدادات Chrome وإعدادها.

الأذونات

privacy

يجب الإفصاح عن إذن "الخصوصية" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات. على سبيل المثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "privacy"
  ],
  ...
}

المفاهيم والاستخدام

قراءة القيمة الحالية لأحد إعدادات Chrome مباشرة ستحتاج أولاً إلى العثور على الموقع الذي يهمّك، ثم عليك استدعاء get() على ذلك الكائن لاسترداد قيمته الحالية ومستوى التحكّم في الإضافة. على سبيل المثال، لتحديد ما إذا كانت ميزة الملء التلقائي لبطاقة الائتمان في Chrome مُفعَّلة، يمكنك كتابة:

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.value) {
    console.log('Autofill is on!');
  } else {
    console.log('Autofill is off!');
  }
});

يُعتبر تغيير قيمة الإعداد أكثر تعقيدًا، لأنّه يجب أولاً التأكّد من أنّ الإضافة يمكنها التحكّم في الإعداد. لن يرى المستخدم أي تغيير في إعداداته إذا كانت الإضافة تبدِّل الإعداد الذي يكون مقتصرًا على قيمة محدّدة بموجب سياسات المؤسسة (سيتم ضبط levelOfControl على "not_controllable")، أو إذا كانت هناك إضافة أخرى تتحكّم في القيمة (سيتم ضبط levelOfControl على "controlled_by_other_extensions"). سينجح طلب البيانات set() ولكن سيتم إلغاء الإعداد على الفور. ولأن هذا قد يكون مربكًا، فمن المستحسن تحذير المستخدم عندما لا يتم تطبيق الإعدادات التي اختارها عمليًا.

يعني هذا أنّه يجب استخدام طريقة get() لتحديد مستوى الوصول، ثم الاتصال بـ set() فقط إذا كان بإمكان الإضافة التحكّم في الإعداد (في الواقع، إذا لم تتمكن الإضافة من التحكم في الإعداد، قد يكون من الأفضل إيقاف الميزة بصريًا لتقليل حيرة المستخدمين):

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
      if (chrome.runtime.lastError === undefined) {
        console.log("Hooray, it worked!");
      } else {
        console.log("Sadness!", chrome.runtime.lastError);
      }
    });
  }
});

إذا كنت مهتمًا بإجراء تغييرات على قيمة أحد الإعدادات، أضِف مستمعًا إلى حدث onChange المتعلّق به. ومن بين الاستخدامات الأخرى، سيتيح لك ذلك تحذير المستخدم في حال كانت إضافة مثبَّتة مؤخرًا تتحكم في أحد الإعدادات أو إذا ألغت سياسة المؤسسة عنصر التحكّم. للاستماع إلى التغييرات التي تطرأ على حالة الملء التلقائي لبطاقة الائتمان، على سبيل المثال، سيكفي الرمز التالي:

chrome.privacy.services.autofillCreditCardEnabled.onChange.addListener(
  function (details) {
    // The new value is stored in `details.value`, the new level of control
    // in `details.levelOfControl`, and `details.incognitoSpecific` will be
    // `true` if the value is specific to Incognito mode.
  }
);

أمثلة

لتجربة واجهة برمجة التطبيقات هذه، يُرجى تثبيت مثال على واجهة برمجة تطبيقات الخصوصية من مستودع chrome-extension-pattern.

الأنواع

IPHandlingPolicy

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

سياسة معالجة عنوان IP في WebRTC.

التعداد

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

أماكن إقامة

network

الإعدادات التي تؤثر في معالجة Chrome لاتصالات الشبكة بشكل عام.

النوع

كائن

أماكن إقامة

  • networkPredictionEnabled

    types.ChromeSetting<boolean>

    في حالة التفعيل، يحاول Chrome زيادة سرعة تجربة تصفُّح الويب عن طريق حل إدخالات نظام أسماء النطاقات مسبقًا وفتح اتصالات TCP وSSL بالخوادم بشكل استباقي. ولا يؤثر هذا التفضيل إلا في الإجراءات التي تتخذها خدمة التنبؤ الداخلي في Chrome. ولا يؤثر على المحافظ التي بدأت من خلال صفحة الويب أو عمليات الربط المسبقة. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • webRTCIPHandlingPolicy

    types.ChromeSetting<IPHandlingPolicy>

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

    السماح للمستخدمين بتحديد المفاضلات المتعلّقة بالخصوصية وأداء الوسائط التي تؤثر في كيفية توجيه زيارات WebRTC ومقدار معلومات العنوان المحلي التي يتم عرضها قيمة هذا الخيار المفضّل من النوع IPHandlingPolicy، ويتم ضبطه تلقائيًا على default.

services

الإعدادات التي تفعِّل أو توقف الميزات التي تتطلب خدمات شبكة تابعة لجهة خارجية توفّرها Google ومقدِّم خدمة البحث التلقائي.

النوع

كائن

أماكن إقامة

  • alternateErrorPagesEnabled

    types.ChromeSetting<boolean>

    عند تفعيل هذا الإعداد، يستخدم Chrome خدمة ويب للمساعدة في حل أخطاء التنقّل. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • autofillAddressEnabled

    types.ChromeSetting<boolean>

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

    في حال تفعيل هذا الإعداد، يعرض Chrome ملء العناوين وبيانات النموذج الأخرى تلقائيًا. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • autofillCreditCardEnabled

    types.ChromeSetting<boolean>

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

    إذا تم التفعيل، يعرض Chrome ملء نماذج بطاقات الائتمان تلقائيًا. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • autofillEnabled

    types.ChromeSetting<boolean>

    تم إيقافه منذ إصدار 70 Chrome

    يُرجى استخدام privacy.services.autofillAddressEnabled وprivacy.services.autofillcreditCardEnabled. يبقى هذا الهدف متوافقًا مع الأنظمة القديمة في هذا الإصدار، وستتم إزالته في المستقبل.

    إذا كان هذا الإعداد مفعَّلاً، يعرض Chrome ملء النماذج تلقائيًا. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • passwordSavingEnabled

    types.ChromeSetting<boolean>

    في حال تفعيل هذا الإعداد، سيسألك مدير كلمات المرور عن رغبتك في حفظ كلمات المرور. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • safeBrowsingEnabled

    types.ChromeSetting<boolean>

    إذا تم تفعيل هذا الإعداد، يبذل Chrome قصارى جهده لحمايتك من التصيّد الاحتيالي والبرامج الضارة. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • safeBrowsingExtendedReportingEnabled

    types.ChromeSetting<boolean>

    في حال تفعيل هذا الإعداد، سيرسل Chrome معلومات إضافية إلى Google عندما تحظر ميزة "التصفّح الآمن" إحدى الصفحات، مثل محتوى الصفحة المحظورة. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على false.

  • searchSuggestEnabled

    types.ChromeSetting<boolean>

    إذا تم تفعيل هذا الخيار، يرسل Chrome النص الذي تكتبه في المربّع المتعدد الاستخدامات إلى محرك البحث التلقائي، والذي يقدِّم توقعات لمواقع إلكترونية وعمليات بحث كاستكمالات على الأرجح لما كتبته حتى الآن. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

  • spellingServiceEnabled

    types.ChromeSetting<boolean>

    عند تفعيل هذا الإعداد، يستخدم Chrome خدمة ويب للمساعدة في تصحيح الأخطاء الإملائية. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على false.

  • translationServiceEnabled

    types.ChromeSetting<boolean>

    إذا كان هذا الإعداد مفعَّلاً، يعرض Chrome ترجمة الصفحات المكتوبة بلغة غير اللغة التي تقرأها. قيمة هذا الخيار المفضّل منطقية، ويتم ضبطها تلقائيًا على true.

websites

الإعدادات التي تحدِّد المعلومات التي يوفّرها Chrome للمواقع الإلكترونية

النوع

كائن

أماكن إقامة

  • adMeasurementEnabled

    types.ChromeSetting<boolean>

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

    في حال إيقافهما، يتم إيقاف Attribution Reporting API وPrivate Aggregation API. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true. ولا يمكن للإضافات إيقاف واجهات برمجة التطبيقات هذه إلا من خلال ضبط القيمة على false. وإذا حاولت ضبط واجهات برمجة التطبيقات هذه على true، سيظهر خطأ.

  • doNotTrackEnabled

    types.ChromeSetting<boolean>

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

    في حال تفعيل هذا الإعداد، يرسل Chrome العنوان "عدم التعقب" (DNT: 1) مع طلباتك. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي false.

  • fledgeEnabled

    types.ChromeSetting<boolean>

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

    وفي حال إيقافها، يتم إيقاف Fledge API. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true. لا يمكن للإضافات إيقاف واجهة برمجة التطبيقات هذه إلا من خلال ضبط القيمة على false. وإذا حاولت ضبط واجهة برمجة التطبيقات هذه على true، سيظهر خطأ.

  • hyperlinkAuditingEnabled

    types.ChromeSetting<boolean>

    في حال تفعيل هذا الإعداد، يرسل Chrome إشعارات للتدقيق عندما يطلبه الموقع الإلكتروني (<a ping>). وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true.

  • protectedContentEnabled

    types.ChromeSetting<boolean>

    متوفّر على نظامَي التشغيل Windows وChromeOS فقط: إذا تم تفعيل Chrome، يوفّر Chrome مُعرّفًا فريدًا للمكوّنات الإضافية من أجل تشغيل المحتوى المحمي. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true.

  • referrersEnabled

    types.ChromeSetting<boolean>

    في حال تفعيل هذا الإعداد، يرسل Chrome عناوين referer مع طلباتك. نعم، لا يتطابق اسم هذا الخيار المفضّل مع العنوان الذي يتضمّن خطأ إملائيًا. لا، لن نغيرها. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true.

  • relatedWebsiteSetsEnabled

    types.ChromeSetting<boolean>

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

    وفي حال إيقافه، يتم إيقاف مجموعات المواقع الإلكترونية ذات الصلة. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true. لا يمكن للإضافات إيقاف واجهة برمجة التطبيقات هذه إلا من خلال ضبط القيمة على false. وإذا حاولت ضبط واجهة برمجة التطبيقات هذه على true، سيظهر خطأ.

  • thirdPartyCookiesAllowed

    types.ChromeSetting<boolean>

    وفي حال إيقاف هذا الإعداد، يحظر Chrome المواقع الإلكترونية التابعة لجهات خارجية من ضبط ملفات تعريف الارتباط. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true.

  • topicsEnabled

    types.ChromeSetting<boolean>

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

    وفي حال إيقافها، يتم إيقاف Topics API. وتكون قيمة هذا الخيار المفضّل من النوع المنطقي، والقيمة التلقائية هي true. لا يمكن للإضافات إيقاف واجهة برمجة التطبيقات هذه إلا من خلال ضبط القيمة على false. وإذا حاولت ضبط واجهة برمجة التطبيقات هذه على true، سيظهر خطأ.