browser.privacy

الوصف

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

الأذونات

privacy

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

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

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

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

browser.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() بنجاح، ولكن سيتم إلغاء الإعداد على الفور. بما أنّ ذلك قد يكون مربكًا، ننصحك بتحذير المستخدم عندما لا يتم تطبيق الإعدادات التي اختارها.

ملاحظة: يمكن العثور على التفاصيل الكاملة حول قدرة الإضافات على التحكّم في ChromeSetting ضمن browser.types.ChromeSetting.

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

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

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

browser.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-samples.

الأنواع

AutofillBlockedType

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

فئات بيانات "الملء التلقائي"

Enum

"contact_info"

"payments"

"identity_docs"

"travel"

"all"

IPHandlingPolicy

الإصدار 48 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

سياسة معالجة عنوان IP في بروتوكول WebRTC

Enum

"default"

‫"default_public_and_private_interfaces"

‫"default_public_interface_only"

"disable_non_proxied_udp"

الخصائص

network

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

النوع

عنصر

الخصائص

• networkPredictionEnabled

  types.ChromeSetting<boolean>

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

• webRTCIPHandlingPolicy

  types.ChromeSetting<IPHandlingPolicy>

  الإصدار 48 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

services

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

النوع

عنصر

الخصائص

• alternateErrorPagesEnabled

  types.ChromeSetting<boolean>

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

• autofillAddressEnabled

  types.ChromeSetting<boolean>

  الإصدار 70 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

• autofillCreditCardEnabled

  types.ChromeSetting<boolean>

  الإصدار 70 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من 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>

  الإصدار 111 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

• doNotTrackEnabled

  types.ChromeSetting<boolean>

  الإصدار 65 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

• fledgeEnabled

  types.ChromeSetting<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

• hyperlinkAuditingEnabled

  types.ChromeSetting<boolean>

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

• protectedContentEnabled

  types.ChromeSetting<boolean>

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

• referrersEnabled

  types.ChromeSetting<boolean>

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

• thirdPartyCookiesAllowed

  types.ChromeSetting<boolean>

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

  ملاحظة: قد يظل بإمكان المواقع الإلكترونية الفردية الوصول إلى ملفات تعريف الارتباط الخارجية عندما تعرض واجهة برمجة التطبيقات هذه القيمة false، إذا كان لديها إعفاء صالح أو إذا كانت تستخدم واجهة Storage Access API بدلاً من ذلك.

• topicsEnabled

  types.ChromeSetting<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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