chrome.browsingData

refresh date: 2026-09-25 robots: noindex

תיאור

אפשר להשתמש ב-API של chrome.browsingData כדי להסיר נתוני גלישה מהפרופיל המקומי של המשתמש.

הרשאות

browsingData

מניפסט

כדי להשתמש ב-API הזה, צריך להצהיר על ההרשאה "browsingData" בקובץ המניפסט של התוסף.

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

שימוש

תרחיש השימוש הפשוט ביותר ב-API הזה הוא מנגנון מבוסס-זמן למחיקת נתוני הגלישה של המשתמש. הקוד צריך לספק חותמת זמן שמציינת את התאריך ההיסטורי שאחריו צריך להסיר את נתוני הגלישה של המשתמש. חותמת הזמן הזו מוגדרת כמספר אלפיות השנייה מאז ראשית זמן יוניקס (Unix epoch) (שאפשר לאחזר מאובייקט 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 מאפשרת להסיר סוגים שונים של נתוני גלישה בקריאה אחת, והיא תהיה מהירה בהרבה מקריאה לכמה שיטות ספציפיות יותר. אבל אם רוצים למחוק רק סוג אחד ספציפי של נתוני גלישה (למשל קובצי Cookie), השיטות המפורטות יותר מציעות חלופה קריאה לקריאה מלאה ב-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 יבנה מחדש באופן אוטומטי את קובץ ה-Cookie של חשבון הסנכרון אחרי שהוא יימחק. כך אפשר להבטיח שהסנכרון ימשיך לפעול, כדי שבסופו של דבר הנתונים יימחקו בשרת. עם זאת, אפשר להשתמש ב-chrome.browsingData.removeCookies הספציפי יותר כדי למחוק את קובץ ה-Cookie של חשבון הסנכרון, ובמקרה כזה הסנכרון יושהה.

מקורות ספציפיים

כדי להסיר נתונים של מקור ספציפי או להחריג קבוצה של מקורות מהמחיקה, אתם יכולים להשתמש בפרמטרים RemovalOptions.origins ו-RemovalOptions.excludeOrigins. אפשר להחיל אותם רק על קובצי Cookie, מטמון ואחסון (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 לאובייקט האפשרויות של ה-API מאפשרת לציין אילו סוגי מקורות יושפעו. נכון לעכשיו, המקורות מחולקים לשלוש קטגוריות:

  • ‫unprotectedWeb מתייחס למקרה הכללי של אתרים שמשתמשים מבקרים בהם בלי לבצע פעולה מיוחדת. אם לא תציינו originTypes, ה-API יסיר כברירת מחדל נתונים ממקורות לא מוגנים באינטרנט.
  • המדיניות 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);

דוגמאות

כדי לנסות את ה-API הזה, מתקינים את הדוגמה של browsingData API ממאגר chrome-extension-samples.

סוגים

DataTypeSet

קבוצה של סוגי נתונים. סוגי נתונים חסרים מפורשים כ-false.

מאפיינים

  • appcache

    בוליאני אופציונלי

    הוצא משימוש ב-Chrome 152

    התמיכה ב-appcache הוסרה. המערכת תתעלם מסוג הנתונים הזה.

    מטמוני אפליקציות של אתרים.

  • קובץ שמור

    בוליאני אופציונלי

    המטמון של הדפדפן.

  • cacheStorage

    בוליאני אופציונלי

    Chrome 72 ואילך

    אחסון המטמון

  • קובצי cookie

    בוליאני אופציונלי

    קובצי ה-Cookie של הדפדפן.

  • הורדות

    בוליאני אופציונלי

    רשימת ההורדות של הדפדפן.

  • fileSystems

    בוליאני אופציונלי

    מערכות הקבצים של האתרים.

  • formData

    בוליאני אופציונלי

    נתוני הטפסים ששמורים בדפדפן.

  • היסטוריה

    בוליאני אופציונלי

    ההיסטוריה של הדפדפן.

  • indexedDB

    בוליאני אופציונלי

    נתוני IndexedDB של אתרים.

  • localStorage

    בוליאני אופציונלי

    נתונים באחסון המקומי של אתרים.

  • סיסמאות

    בוליאני אופציונלי

    הוצאה משימוש בגרסה Chrome 144

    הוסרה התמיכה במחיקת סיסמאות באמצעות תוספים. המערכת תתעלם מסוג הנתונים הזה.

    סיסמאות שמורות.

  • pluginData

    בוליאני אופציונלי

    הוצא משימוש בגרסה Chrome 88

    התמיכה ב-Flash הוסרה. המערכת תתעלם מסוג הנתונים הזה.

    נתונים של פלאגינים.

  • serverBoundCertificates

    בוליאני אופציונלי

    הוצא משימוש בגרסה Chrome 76

    הוסרה התמיכה באישורים שקשורים לשרת. המערכת תתעלם מסוג הנתונים הזה.

    אישורים שקשורים לשרת.

  • serviceWorkers

    בוליאני אופציונלי

    קובצי שירות (service worker).

  • webSQL

    בוליאני אופציונלי

    הוצא משימוש ב-Chrome 152

    התמיכה ב-WebSQL הוסרה. המערכת תתעלם מסוג הנתונים הזה.

    נתוני WebSQL של אתרים.

RemovalOptions

אפשרויות שקובעות בדיוק אילו נתונים יוסרו.

מאפיינים

  • excludeOrigins

    string[] אופציונלי

    ‫Chrome מגרסה 74 ואילך

    אם המדיניות הזו מוגדרת, הנתונים של המקורות שברשימה הזו לא נמחקים. אי אפשר להשתמש בו יחד עם origins. הפעולה הזו נתמכת רק בקובצי Cookie, באחסון ובמטמון. קובצי ה-Cookie מוחרגים לכל הדומיין שניתן לרשום.

  • originTypes

    object optional

    אובייקט שהמאפיינים שלו מציינים אילו סוגי מקורות צריך לנקות. אם האובייקט הזה לא צוין, ברירת המחדל היא ניקוי של מקורות "לא מוגנים" בלבד. לפני שמוסיפים את protectedWeb או extensions, חשוב לוודא שבאמת רוצים להסיר את נתוני האפליקציה.

    • תוסף

      בוליאני אופציונלי

      תוספים ואפליקציות ארוזות שהמשתמש התקין (צריך להיזהר _מאוד_!).

    • protectedWeb

      בוליאני אופציונלי

      אתרים שהותקנו כאפליקציות מתארחות (חשוב להיזהר!).

    • unprotectedWeb

      בוליאני אופציונלי

      אתרים רגילים.

  • מקורות

    [string, ...string[]] אופציונלי

    ‫Chrome מגרסה 74 ואילך

    אם הרשימה הזו קיימת, רק הנתונים של המקורות שברשימה נמחקים. הפעולה הזו נתמכת רק בקובצי Cookie, באחסון ובמטמון. קובצי ה-Cookie נמחקים בכל הדומיין שניתן לרישום.

  • מאז

    מספר אופציונלי

    הסרת נתונים שנצברו בתאריך הזה או אחריו, מיוצגים באלפיות השנייה מאז תחילת התקופה (נגיש באמצעות השיטה getTime של האובייקט Date ב-JavaScript). אם לא מגדירים ערך, ברירת המחדל היא 0 (כל נתוני הגלישה יוסרו).

Methods

remove()

Promise 
chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
): Promise<void>

מחיקה של סוגים שונים של נתוני גלישה שמאוחסנים בפרופיל של המשתמש.

פרמטרים

  • אפשרויות

    RemovalOptions

  • dataToRemove

    DataTypeSet

    קבוצת סוגי הנתונים שרוצים להסיר.

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשהמחיקה מסתיימת.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeAppcache()

Promise הוצא משימוש בגרסה Chrome 152
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

התמיכה ב-appcache הוסרה. לפונקציה הזו אין השפעה.

מחיקת נתוני מטמון האפליקציה של אתרים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשנתוני ה-appcache של האתרים נמחקים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeCache()

Promise 
chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מנקה את המטמון של הדפדפן.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשהמטמון של הדפדפן נמחק.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeCacheStorage()

Promise Chrome 72 ואילך 
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מחיקת נתוני האחסון במטמון של אתרים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הבעיה נפתרת אחרי שמנקים את המטמון של האתרים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeCookies()

Promise 
chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מנקה את קובצי ה-Cookie של הדפדפן ואת האישורים שקשורים לשרת ששונו בפרק זמן מסוים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתממשת כשקובצי ה-Cookie והאישורים שקשורים לשרת של הדפדפן נמחקים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeDownloads()

Promise 
chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מנקה את רשימת הקבצים שהורדו בדפדפן (לא את הקבצים שהורדו עצמם).

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הבעיה נפתרת כשמנקים את רשימת הקבצים שהורדו בדפדפן.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeFileSystems()

Promise 
chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מחיקת נתונים של מערכת הקבצים של אתרים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשמערכות הקבצים של האתרים נמחקות.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeFormData()

Promise 
chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מחיקת נתוני הטפסים ששמורים בדפדפן (מילוי אוטומטי).

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הפעולה מסתיימת כשנתוני הטפסים בדפדפן נמחקים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeHistory()

Promise 
chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מנקה את ההיסטוריה של הדפדפן.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשהיסטוריית הדפדפן נמחקת.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeIndexedDB()

Promise 
chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מחיקת נתוני IndexedDB של אתרים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הבעיה נפתרת כשנתוני IndexedDB של האתרים נמחקים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeLocalStorage()

Promise 
chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מחיקת נתונים מהאחסון המקומי של אתרים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הפעולה מסתיימת כשהאחסון המקומי של האתרים נמחק.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removePasswords()

Promise הוצא משימוש בגרסה Chrome 144
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

הוסרה התמיכה במחיקת סיסמאות באמצעות תוספים. לפונקציה הזו אין השפעה.

מחיקת הסיסמאות ששמורות בדפדפן.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הפעולה מסתיימת כשהסיסמאות בדפדפן נמחקות.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removePluginData()

Promise הוצא משימוש בגרסה Chrome 88
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

התמיכה ב-Flash הוסרה. לפונקציה הזו אין השפעה.

מחיקת נתונים של פלאגינים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשנתוני הפלאגינים נמחקים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeServiceWorkers()

Promise Chrome 72 ואילך 
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

מנקה את קובצי השירות (Service Workers) של האתרים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הפעולה מסתיימת כשמנקים את ה-service workers של האתרים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

removeWebSQL()

Promise הוצא משימוש בגרסה Chrome 152
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

התמיכה ב-WebSQL הוסרה. לפונקציה הזו אין השפעה.

מחיקת נתוני WebSQL של אתרים.

פרמטרים

  • אפשרויות

    RemovalOptions

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשמסדי הנתונים של WebSQL באתרים נמחקים.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

settings()

Promise 
chrome.browsingData.settings(
  callback?: function,
): Promise<object>

דיווח על סוגי הנתונים שנבחרו כרגע בממשק המשתמש של ההגדרות של "ניקוי נתוני הגלישה". הערה: חלק מסוגי הנתונים שכלולים ב-API הזה לא זמינים בממשק המשתמש של ההגדרות, וחלק מההגדרות בממשק המשתמש שולטות ביותר מסוג נתונים אחד שמופיע כאן.

פרמטרים

  • callback

    function optional

    הפרמטר callback נראה כך: 

    (result: object) => void

    • תוצאה

      אובייקט

      • dataRemovalPermitted

        DataTypeSet

        כל הסוגים יופיעו בתוצאה, עם הערכים true אם מותר להסיר אותם (למשל, לפי מדיניות הארגון) ו-false אם לא.

      • dataToRemove

        DataTypeSet

        כל הסוגים יופיעו בתוצאה, עם הערכים true אם הם נבחרו להסרה וגם מותר להסיר אותם, אחרת false.

      • אפשרויות

        RemovalOptions

החזרות

  • Promise<object>

    ‫Chrome מגרסה 96 ואילך

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).