الوصف
استخدِم chrome.browsingData
API لإزالة بيانات التصفُّح من الملف الشخصي المحلي للمستخدم.
الأذونات
browsingData
يجب أن تذكر إذن "browsingData"
في بيان الإضافة لاستخدام واجهة برمجة التطبيقات هذه.
{
"name": "My extension",
...
"permissions": [
"browsingData",
],
...
}
المفاهيم والاستخدام
إنّ أبسط حالة استخدام لواجهة برمجة التطبيقات هذه هي آلية تستند إلى الوقت لمحو بيانات تصفُّح المستخدم.
يجب أن يوفِّر الرمز طابعًا زمنيًا يشير إلى التاريخ السابق الذي يجب بعده إزالة بيانات تصفّح المستخدم. يتم تنسيق هذا الطابع الزمني على أنّه عدد المللي ثانية التي مرّت منذ
حقبة يونكس (والتي يمكن استردادها من كائن 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
. ولا يمكن تطبيقها إلا على ملفات تعريف الارتباط وذاكرة التخزين المؤقت والتخزين (ذاكرة التخزين المؤقت و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);
أمثلة
لتجربة واجهة برمجة التطبيقات هذه، يمكنك تثبيت مثال واجهة برمجة تطبيقات browseData من مستودع chrome-extension-pattern.
الأنواع
DataTypeSet
مجموعة من أنواع البيانات. ويتم تفسير أنواع البيانات الناقصة على أنّها false
.
أماكن إقامة
-
ذاكرة التخزين المؤقت للتطبيق
منطقية اختيارية
تطبيقات المواقع الإلكترونية.
-
ذاكرة التخزين المؤقت
منطقية اختيارية
ذاكرة التخزين المؤقت في المتصفّح.
-
cacheStorage
منطقية اختيارية
الإصدار 72 من Chrome والإصدارات الأحدثمساحة ذاكرة التخزين المؤقت
-
ملفات تعريف الارتباط
منطقية اختيارية
ملفات تعريف الارتباط في المتصفح.
-
عمليات التنزيل
منطقية اختيارية
قائمة التنزيل في المتصفّح.
-
fileSystems
منطقية اختيارية
أنظمة ملفات مواقع الويب.
-
formData
منطقية اختيارية
بيانات النموذج المخزّنة في المتصفّح.
-
السجلّ
منطقية اختيارية
سجلّ المتصفح
-
indexedDB
منطقية اختيارية
بيانات IndexedDB لمواقع الويب
-
localStorage
منطقية اختيارية
بيانات التخزين المحلية للمواقع الإلكترونية
-
كلمات المرور
منطقية اختيارية
كلمات المرور المخزَّنة
-
pluginData
منطقية اختيارية
تم إيقافه منذ إصدار Chrome 88تم إيقاف Flash. وسيتم تجاهل نوع البيانات هذا.
بيانات المكوّنات الإضافية.
-
serverBoundCertificates
منطقية اختيارية
تم إيقافه منذ إصدار 76 من Chromeتم إلغاء إمكانية استخدام الشهادات المرتبطة بالخادم. وسيتم تجاهل نوع البيانات هذا.
الشهادات المرتبطة بالخادم.
-
serviceWorkers
منطقية اختيارية
مشغِّلو الخدمات.
-
webSQL
منطقية اختيارية
بيانات WebSQL للمواقع الإلكترونية
RemovalOptions
خيارات تحدد البيانات التي ستتم إزالتها بالضبط.
أماكن إقامة
-
excludeOrigins
سلسلة[] اختيارية
الإصدار 74 من Chrome والإصدارات الأحدثعند توفّر بيانات المصادر في هذه القائمة، يتم استبعادها من الحذف. لا يمكن استخدام هذا الحقل مع
origins
. لا يتوفّر هذا الخيار إلا لملفات تعريف الارتباط وسعة التخزين وذاكرة التخزين المؤقت. يتم استبعاد ملفات تعريف الارتباط للنطاق الذي يمكن تسجيله بالكامل. -
originTypes
الكائن اختياري
يشير ذلك المصطلح إلى عنصر تحدِّد خصائصه أنواع المصادر التي يجب محوها. وإذا لم يتم تحديد هذا العنصر، سيتم ضبط الإعدادات التلقائية على محو الأصول "غير المحمية" فقط. يُرجى التأكّد من أنّك تريد حقًّا إزالة بيانات التطبيق قبل إضافة "الويب المحمي" أو "الإضافات".
-
إضافة
منطقية اختيارية
الإضافات والتطبيقات المجمّعة التي ثبَّتها مستخدم (كن _really_ حذرًا).
-
protectedWeb
منطقية اختيارية
مواقع الويب التي تم تثبيتها كتطبيقات مستضافة (انتبه!).
-
unprotectedWeb
منطقية اختيارية
المواقع الإلكترونية العادية
-
-
الأصول
سلسلة[] اختيارية
الإصدار 74 من Chrome والإصدارات الأحدثعند توفّر هذه البيانات، يتم فقط حذف بيانات المصادر في هذه القائمة. لا يتوفّر هذا الخيار إلا لملفات تعريف الارتباط وسعة التخزين وذاكرة التخزين المؤقت. يتم محو ملفات تعريف الارتباط للنطاق الذي يمكن تسجيله بالكامل.
-
منذ
الرقم اختياري
يمكنك إزالة البيانات المتراكمة في هذا التاريخ أو بعده، والممثّلة بالمللي ثانية منذ تاريخ بدء حساب الفترة (يمكن الوصول إليها من خلال طريقة
getTime
في عنصرDate
في JavaScript). في حال عدم توفّر هذه المعلومات، يتم ضبطها تلقائيًا على 0 (ما سيؤدي إلى إزالة جميع بيانات التصفّح).
الطُرق
remove()
chrome.browsingData.remove(
options: RemovalOptions,
dataToRemove: DataTypeSet,
callback?: function,
)
يؤدي إلى محو أنواع مختلفة من بيانات التصفح المخزّنة في الملف الشخصي للمستخدم.
المَعلمات
-
الخيارات
-
dataToRemove
مجموعة أنواع البيانات المطلوب إزالتها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeAppcache()
chrome.browsingData.removeAppcache(
options: RemovalOptions,
callback?: function,
)
يمحو بيانات appcache لمواقع الويب.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeCache()
chrome.browsingData.removeCache(
options: RemovalOptions,
callback?: function,
)
يمحو ذاكرة التخزين المؤقت في المتصفّح.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeCacheStorage()
chrome.browsingData.removeCacheStorage(
options: RemovalOptions,
callback?: function,
)
يمحو بيانات التخزين من ذاكرة التخزين المؤقت للمواقع الإلكترونية.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeCookies()
chrome.browsingData.removeCookies(
options: RemovalOptions,
callback?: function,
)
يؤدي هذا الإجراء إلى محو ملفات تعريف الارتباط والشهادات المرتبطة بالخادم التي تم تعديلها خلال إطار زمني محدّد.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeDownloads()
chrome.browsingData.removeDownloads(
options: RemovalOptions,
callback?: function,
)
يمحو قائمة الملفات التي تم تنزيلها في المتصفح (وليس الملفات التي تم تنزيلها نفسها).
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeFileSystems()
chrome.browsingData.removeFileSystems(
options: RemovalOptions,
callback?: function,
)
يمحو بيانات نظام الملفات للمواقع الإلكترونية.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeFormData()
chrome.browsingData.removeFormData(
options: RemovalOptions,
callback?: function,
)
محو بيانات النموذج المخزّنة في المتصفّح (الملء التلقائي).
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeHistory()
chrome.browsingData.removeHistory(
options: RemovalOptions,
callback?: function,
)
يؤدي هذا الإجراء إلى محو سجلّ المتصفِّح.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeIndexedDB()
chrome.browsingData.removeIndexedDB(
options: RemovalOptions,
callback?: function,
)
محو بيانات IndexedDB للمواقع الإلكترونية.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeLocalStorage()
chrome.browsingData.removeLocalStorage(
options: RemovalOptions,
callback?: function,
)
يمحو بيانات التخزين المحلية للمواقع الإلكترونية.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removePasswords()
chrome.browsingData.removePasswords(
options: RemovalOptions,
callback?: function,
)
محو كلمات المرور المخزَّنة في المتصفِّح.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removePluginData()
chrome.browsingData.removePluginData(
options: RemovalOptions,
callback?: function,
)
تم إيقاف Flash. هذه الدالة ليس لها أي تأثير.
لمحو بيانات المكوّنات الإضافية.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeServiceWorkers()
chrome.browsingData.removeServiceWorkers(
options: RemovalOptions,
callback?: function,
)
يمحو مشغّلي خدمات المواقع الإلكترونية.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
removeWebSQL()
chrome.browsingData.removeWebSQL(
options: RemovalOptions,
callback?: function,
)
يمحو بيانات WebSQL للمواقع الإلكترونية.
المَعلمات
-
الخيارات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:()=>void
المرتجعات
-
Promise<void>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
settings()
chrome.browsingData.settings(
callback?: function,
)
تعمل هذه السياسة على إعداد تقارير عن أنواع البيانات المحدَّدة حاليًا في واجهة مستخدم إعدادات "محو بيانات التصفُّح". ملاحظة: لا تتوفّر بعض أنواع البيانات المضمّنة في واجهة برمجة التطبيقات هذه في واجهة مستخدم الإعدادات، وهناك بعض إعدادات واجهة المستخدم تتحكّم في أكثر من نوع بيانات واحد مدرَج هنا.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: object)=>void
-
نتيجة
كائن
-
dataRemovalPermitted
ستكون جميع الأنواع موجودة في النتيجة، مع قيم
true
إذا كان مسموحًا بإزالتها (على سبيل المثال، بموجب سياسة المؤسسة) وfalse
إذا لم يكن الأمر كذلك. -
dataToRemove
ستكون جميع الأنواع موجودة في النتيجة، بقيم
true
إذا تم اختيار كليهما للإزالة والسماح بإزالتهما، وإلاfalse
. -
الخيارات
-
-
المرتجعات
-
Promise<object>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.