chrome.browsingData

الوصف

استخدِم واجهة برمجة التطبيقات chrome.browsingData لإزالة بيانات التصفّح من الملف الشخصي المحلي للمستخدم.

الأذونات

browsingData

البيان

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

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

الاستخدام

إنّ أبسط حالات استخدام لواجهة برمجة التطبيقات هذه هي آلية مستندة إلى الوقت لمحو بيانات التصفّح الخاصة بالمستخدم. يجب أن يوفر الرمز طابعًا زمنيًا يشير إلى التاريخ التاريخي الذي تم بعده إزالة بيانات التصفح. ويتم تنسيق هذا الطابع الزمني كعدد بالمللي ثانية منذ حقبة Unix (التي يمكن استردادها من كائن Date في JavaScript باستخدام الطريقة getTime)

على سبيل المثال، لمحو جميع بيانات تصفح المستخدم من الأسبوع الماضي، يمكنك كتابة رمز كـ التالي:

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

تسمح لك الطريقة chrome.browsingData.remove بإزالة أنواع مختلفة من بيانات التصفّح باستخدام اتصال واحد، وسيكون أسرع بكثير من استدعاء عدة طرق أكثر تحديدًا. ومع ذلك، إذا يريد فقط محو نوع واحد محدد من بيانات التصفح (ملفات تعريف الارتباط، على سبيل المثال)، كلما كان ذلك أكثر دقة بديلاً قابلاً للقراءة لاستدعاء مملوء بـ JSON.

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.removeCookies({
  "since": oneWeekAgo
}, callback);

في حال مزامنة المستخدم لبياناته، قد يُعيد chrome.browsingData.remove إنشاء ملف تعريف الارتباط تلقائيًا. لحساب المزامنة بعد محوه. يضمن هذا الإجراء استمرار عمل المزامنة، يمكن حذف البيانات على الخادم في النهاية. ومع ذلك، كلما كانت أكثر تحديدًا يمكن استخدام chrome.browsingData.removeCookies لمحو ملف تعريف الارتباط لحساب المزامنة والمزامنة. سيتم إيقافهما مؤقتًا في هذه الحالة.

مصادر محدّدة

لإزالة بيانات مصدر معيّن أو لاستبعاد مجموعة من المصادر من الحذف، يمكنك استخدام السمة المَعلمتَان RemovalOptions.origins وRemovalOptions.excludeOrigins لا يمكن تطبيقها إلا على ملفات تعريف الارتباط وذاكرة التخزين المؤقت والتخزين (cacheStorage وFileSystems وIndexedDB وLocalStorage وServiceWorkers و WebSQL).

chrome.browsingData.remove({
  "origins": ["https://www.example.com"]
}, {
  "cacheStorage": true,
  "cookies": true,
  "fileSystems": true,
  "indexedDB": true,
  "localStorage": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

أنواع المصادر

من خلال إضافة سمة originTypes إلى عنصر الخيارات في واجهة برمجة التطبيقات، يمكنك تحديد أنواع ينبغي التأثير في أصوله. في الوقت الحالي، تنقسم المصادر إلى ثلاث فئات:

  • تغطي unprotectedWeb الحالة العامة للمواقع الإلكترونية التي يزورها المستخدمون بدون اتخاذ أي إجراءات اتخاذ القرار. إذا لم تحدّد originTypes، سيتم ضبط واجهة برمجة التطبيقات تلقائيًا على إزالة البيانات من المواقع الإلكترونية غير المحمية وأصول الويب.
  • يشمل protectedWeb مصادر الويب هذه التي تم تثبيتها كتطبيقات مستضافة. تثبيت Angry Birds، على سبيل المثال، يحمي المصدر https://chrome.angrybirds.com يزيله من الفئة unprotectedWeb. يُرجى توخي الحذر عند بدء حذف البيانات لهذه المصادر: احرص على أن يكون المستخدمون على علم بما سيحصلون عليه، حيث إن ذلك سيؤثر بلا رجعة إزالة بيانات ألعابهم. لا أحد يريد ضرب بيوت الخنازير الصغيرة أكثر من اللازم.
  • يغطي extension المصادر ضمن مخطط chrome-extensions:. يُرجى العِلم أنّ إزالة بيانات الإضافات ومرة أخرى، شيء يجب أن تكون حذرًا بشأنه.

يمكننا تعديل المثال السابق لإزالة البيانات من المواقع الإلكترونية المحمية فقط على النحو التالي:

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo,
  "originTypes": {
    "protectedWeb": true
  }
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

أمثلة

لتجربة واجهة برمجة التطبيقات هذه، يمكنك تثبيت مثال على واجهة برمجة تطبيقات browsingData من chrome-extension-samples المستودع.

الأنواع

DataTypeSet

مجموعة من أنواع البيانات. يتم تفسير أنواع البيانات الناقصة على أنّها false.

أماكن إقامة

  • ذاكرة التخزين المؤقت للتطبيقات

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

    المواقع الإلكترونية appcaches.

  • ذاكرة التخزين المؤقت

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

    ذاكرة التخزين المؤقت في المتصفح

  • cacheStorage

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

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

    مساحة ذاكرة التخزين المؤقت

  • ملفات تعريف الارتباط

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

    ملفات تعريف الارتباط في المتصفح.

  • التنزيلات

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

    قائمة تنزيل المتصفّح.

  • fileSystems

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

    المواقع الإلكترونية وأنظمة الملفات.

  • formData

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

    بيانات النموذج المخزنة في المتصفح.

  • السجلّ

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

    سجلّ المتصفّح.

  • indexedDB

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

    المواقع الإلكترونية البيانات المفهرَسة لقاعدة البيانات

  • localStorage

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

    المواقع الإلكترونية بيانات التخزين المحلية.

  • كلمات المرور

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

    كلمات المرور المخزَّنة

  • pluginData

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

    متوقّف منذ إصدار Chrome 88

    تم إلغاء دعم Flash. وسيتم تجاهل نوع البيانات هذا.

    المكوّنات الإضافية البيانات.

  • serverBoundCertificates

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

    متوقّفة منذ إصدار Chrome 76

    تمت إزالة اعتماد الشهادات المرتبطة بالخادم. وسيتم تجاهل نوع البيانات هذا.

    الشهادات المرتبطة بالخادم.

  • serviceWorkers

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

    مشغِّلو الخدمات:

  • webSQL

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

    المواقع الإلكترونية بيانات WebSQL.

RemovalOptions

الخيارات التي تحدد بالضبط البيانات التي ستتم إزالتها.

أماكن إقامة

  • excludeOrigins

    string[] اختيارية

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

    عند توفّر هذه البيانات، يتم استبعاد بيانات المصادر في هذه القائمة من الحذف. لا يمكن استخدامهما مع origins. لا يتم دعمها إلا لملفات تعريف الارتباط وسعة التخزين وذاكرة التخزين المؤقت. يتم استبعاد ملفات تعريف الارتباط للنطاق القابل للتسجيل بالكامل.

  • originTypes

    الكائن اختياري

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

    • إضافة

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

      الإضافات والتطبيقات المجمّعة التي ثبّتها المستخدم (كن _حقًا_ !).

    • protectedWeb

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

      مواقع الويب التي تم تثبيتها كتطبيقات مستضافة (كن حذرًا!).

    • unprotectedWeb

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

      المواقع الإلكترونية العادية:

  • الأصول

    [string, ...string[]] اختيارية

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

    عند استخدام هذه الميزة، يتم فقط حذف بيانات المصادر في هذه القائمة. لا يتم دعمها إلا لملفات تعريف الارتباط وسعة التخزين وذاكرة التخزين المؤقت. يتم محو ملفات تعريف الارتباط للنطاق القابل للتسجيل بالكامل.

  • منذ

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

    أزِل البيانات المتراكمة في هذا التاريخ أو بعده، والتي يتم تمثيلها بالمللي ثانية منذ تلك الفترة (يمكن الوصول إليها من خلال طريقة getTime في كائن JavaScript Date). في حال عدم توفّر هذه المعلومات، يتم ضبط القيمة التلقائية على 0 (ما سيؤدي إلى إزالة جميع بيانات التصفّح).

الطُرق

remove()

وعود
chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
)

يؤدي هذا الإجراء إلى محو أنواع مختلفة من بيانات التصفّح المخزّنة في الملف الشخصي للمستخدم.

المعلمات

  • الخيارات
  • dataToRemove

    مجموعة أنواع البيانات المطلوب إزالتها.

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeAppcache()

وعود
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
)

محو المواقع الإلكترونية appcache.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeCache()

وعود
chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
)

يمحو ذاكرة التخزين المؤقت في المتصفح.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeCacheStorage()

وعود الإصدار 72 من Chrome أو الإصدارات الأحدث
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
)

محو المواقع الإلكترونية بيانات تخزين ذاكرة التخزين المؤقت.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeCookies()

وعود
chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
)

يؤدي ذلك إلى محو ملفات تعريف الارتباط والشهادات المرتبطة بالخادم والتي تم تعديلها خلال إطار زمني محدد.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeDownloads()

وعود
chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
)

يؤدي هذا الإجراء إلى محو قائمة الملفات التي تم تنزيلها في المتصفّح (وليس الملفات التي تم تنزيلها نفسها).

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeFileSystems()

وعود
chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
)

محو المواقع الإلكترونية لبيانات نظام الملفات.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeFormData()

وعود
chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
)

محو بيانات النموذج المخزنة في المتصفح (الملء التلقائي).

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeHistory()

وعود
chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
)

يمحو سجلّ المتصفح.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeIndexedDB()

وعود
chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
)

محو المواقع الإلكترونية البيانات المفهرَسة لقاعدة البيانات

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeLocalStorage()

وعود
chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
)

محو المواقع الإلكترونية بيانات التخزين المحلية.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removePasswords()

وعود
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
)

محو كلمات المرور المخزنة في المتصفح.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removePluginData()

وعود متوقّف منذ إصدار Chrome 88
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
)

تم إلغاء دعم Flash. ليس لهذه الدالة أي تأثير.

محو المكوّنات الإضافية البيانات.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeServiceWorkers()

وعود الإصدار 72 من Chrome أو الإصدارات الأحدث
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
)

محو المواقع الإلكترونية عاملي الخدمة.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

removeWebSQL()

وعود
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
)

محو المواقع الإلكترونية بيانات WebSQL.

المعلمات

  • الخيارات
  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

settings()

وعود
chrome.browsingData.settings(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

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

    (result: object) => void

    • نتيجة

      كائن

      • dataRemovalPermitted

        ستكون جميع الأنواع متوفرة في النتيجة، مع قيم true إذا كان مسموحًا بإزالتها (مثلاً، بموجب سياسة المؤسسة) وfalse إذا لم يكن مسموحًا بها.

      • dataToRemove

        ستكون جميع الأنواع موجودة في النتيجة، مع قيم true إذا تم اختيار كليهما لإزالتها والسماح بإزالتها، وبخلاف ذلك، false.

      • الخيارات

المرتجعات

  • Promise&lt;object&gt;

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

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.