chrome.privacy

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

privacy

البيان

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

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

الاستخدام

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

chrome.privacy.services.autofillEnabled.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.autofillEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillEnabled.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.autofillEnabled.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 والإصدارات الأحدث

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

تعداد

"contact_info"

"payments"

"identity_docs"

"travel"

"all"

IPHandlingPolicy

Chrome 48+

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

تعداد

"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>

    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>

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

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

  • doNotTrackEnabled

    types.ChromeSetting<boolean>

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

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

  • fledgeEnabled

    types.ChromeSetting<boolean>

    الإصدار 111 من 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 والإصدارات الأحدث

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