chrome.browsingData

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu API chrome.browsingData, aby usunąć dane przeglądania z profilu lokalnego użytkownika.

Uprawnienia

browsingData

Plik manifestu

Aby używać tego interfejsu API, musisz zadeklarować uprawnienie „browsingData” w pliku manifestu rozszerzenia.

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

Wykorzystanie

Najprostszym przypadkiem użycia tego interfejsu API jest mechanizm oparty na czasie, który służy do czyszczenia danych przeglądania użytkownika. Kod powinien zawierać sygnaturę czasową, która wskazuje datę historyczną, po której dane przeglądania użytkownika powinny zostać usunięte. Ta sygnatura czasowa jest sformatowana jako liczba milisekund od początku epoki uniksowej (którą można pobrać z obiektu Date w języku JavaScript za pomocą metody getTime).

Aby na przykład wyczyścić wszystkie dane przeglądania użytkownika z ostatniego tygodnia, możesz napisać taki kod:

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);

Metoda chrome.browsingData.remove umożliwia usunięcie różnych typów danych przeglądania za pomocą jednego wywołania i jest znacznie szybsza niż wywoływanie wielu bardziej szczegółowych metod. Jeśli jednak chcesz wyczyścić tylko jeden konkretny typ danych przeglądania (np. pliki cookie), bardziej szczegółowe metody stanowią czytelną alternatywę dla wywołania wypełnionego danymi 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);

Jeśli użytkownik synchronizuje swoje dane, chrome.browsingData.remove może automatycznie odtworzyć plik cookie konta synchronizacji po jego wyczyszczeniu. Dzięki temu synchronizacja będzie mogła nadal działać, a dane zostaną ostatecznie usunięte z serwera. Można jednak użyć bardziej szczegółowego chrome.browsingData.removeCookies, aby usunąć plik cookie konta synchronizacji. W takim przypadku synchronizacja zostanie wstrzymana.

Określone źródła

Aby usunąć dane dotyczące konkretnego źródła lub wykluczyć zestaw źródeł z usuwania, możesz użyć parametrów RemovalOptions.origins i RemovalOptions.excludeOrigins. Można je stosować tylko do plików cookie, pamięci podręcznej i pamięci masowej (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers i WebSQL).

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

Typy punktów początkowych

Dodanie właściwości originTypes do obiektu opcji interfejsu API pozwala określić, na które typy źródeł ma to wpływać. Obecnie źródła są podzielone na 3 kategorie:

  • unprotectedWeb obejmuje ogólny przypadek witryn, które użytkownicy odwiedzają bez podejmowania żadnych specjalnych działań. Jeśli nie określisz parametru originTypes, interfejs API domyślnie usunie dane z niechronionych originów stron.
  • protectedWeb obejmuje te originy stron, które zostały zainstalowane jako aplikacje hostowane. Na przykład zainstalowanie gry Angry Birds chroni źródło https://chrome.angrybirds.com i usuwa je z kategorii unprotectedWeb. Zachowaj ostrożność podczas usuwania danych z tych źródeł: upewnij się, że użytkownicy wiedzą, co się stanie, ponieważ spowoduje to nieodwracalne usunięcie ich danych gry. Nikt nie chce burzyć domków świnek częściej, niż jest to konieczne.
  • extension obejmuje źródła w schemacie chrome-extensions:. Usuwanie danych rozszerzenia to kolejna czynność, którą należy wykonywać z dużą ostrożnością.

Możemy dostosować poprzedni przykład, aby usunąć tylko dane z chronionych witryn:

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);

Przykłady

Aby wypróbować ten interfejs API, zainstaluj przykład interfejsu browsingData API z repozytorium chrome-extension-samples.

Typy

DataTypeSet

Zestaw typów danych. Brakujące typy danych są interpretowane jako false.

Właściwości

  • appcache

    boolean opcjonalne

    Wycofane od wersji Chrome 152

    Obsługa pamięci podręcznej aplikacji została usunięta. Ten typ danych zostanie zignorowany.

    Pamięci podręczne aplikacji witryn.

  • Pamięć podręczna

    boolean opcjonalne

    pamięć podręczna przeglądarki,

  • cacheStorage

    boolean opcjonalne

    Chrome 72 lub nowsza wersja

    Pamięć podręczna

  • ciasteczka

    boolean opcjonalne

    Pliki cookie przeglądarki.

  • pobrane

    boolean opcjonalne

    Lista pobranych plików w przeglądarce.

  • fileSystems

    boolean opcjonalne

    systemów plików witryn,

  • formData

    boolean opcjonalne

    Dane formularzy przechowywane przez przeglądarkę.

  • historia

    boolean opcjonalne

    historia przeglądarki,

  • indexedDB

    boolean opcjonalne

    Dane IndexedDB witryn.

  • localStorage

    boolean opcjonalne

    dane zapisane w pamięci lokalnej witryn;

  • hasła

    boolean opcjonalne

    Wycofane od Chrome 144

    Usunięto obsługę usuwania haseł za pomocą rozszerzeń. Ten typ danych zostanie zignorowany.

    Zapisane hasła.

  • pluginData

    boolean opcjonalne

    Wycofane od wersji Chrome 88

    Obsługa Flasha została usunięta. Ten typ danych zostanie zignorowany.

    Dane wtyczek.

  • serverBoundCertificates

    boolean opcjonalne

    Wycofane od wersji Chrome 76

    Usunęliśmy obsługę certyfikatów powiązanych z serwerem. Ten typ danych zostanie zignorowany.

    Certyfikaty powiązane z serwerem.

  • serviceWorkers

    boolean opcjonalne

    Skrypty service worker.

  • webSQL

    boolean opcjonalne

    Wycofane od wersji Chrome 152

    Obsługa WebSQL została usunięta. Ten typ danych zostanie zignorowany.

    dane WebSQL witryn;

RemovalOptions

Opcje, które określają, jakie dane zostaną usunięte.

Właściwości

  • excludeOrigins

    string[] opcjonalne

    Chrome 74 lub nowsza wersja

    Jeśli ta zasada jest skonfigurowana, dane dotyczące źródeł z tej listy nie są usuwane. Nie można używać razem z: origins. Obsługiwane tylko w przypadku plików cookie, pamięci i pamięci podręcznej. Pliki cookie są wykluczone dla całej domeny, którą można zarejestrować.

  • originTypes

    object opcjonalny

    Obiekt, którego właściwości określają, które typy źródeł powinny zostać wyczyszczone. Jeśli ten obiekt nie jest określony, domyślnie czyszczone są tylko „niechronione” źródła. Zanim dodasz „protectedWeb” lub „extensions”, upewnij się, że naprawdę chcesz usunąć dane aplikacji.

    • rozszerzenie

      boolean opcjonalne

      rozszerzenia i aplikacje spakowane zainstalowane przez użytkownika (zachowaj _szczególną_ ostrożność).

    • protectedWeb

      boolean opcjonalne

      witryny zainstalowane jako aplikacje hostowane (zachowaj ostrożność).

    • unprotectedWeb

      boolean opcjonalne

      Zwykłe witryny.

  • źródła

    [string, ...string[]] opcjonalny

    Chrome 74 lub nowsza wersja

    Jeśli jest obecna, usuwane są tylko dane dotyczące źródeł z tej listy. Obsługiwane tylko w przypadku plików cookie, pamięci i pamięci podręcznej. Pliki cookie są usuwane z całej domeny, którą można zarejestrować.

  • od

    number optional

    Usuń dane zgromadzone w tym dniu lub później, wyrażone w milisekundach od początku epoki (dostępne za pomocą metody getTime obiektu JavaScript Date). Jeśli nie zostanie podana, przyjmuje domyślnie wartość 0 (co spowoduje usunięcie wszystkich danych przeglądania).

Metody

remove()

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

Czyści różne typy danych przeglądania przechowywane w profilu użytkownika.

Parametry

  • dataToRemove

    DataTypeSet

    Zbiór typów danych do usunięcia.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Zostanie rozwiązany po zakończeniu usuwania.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeAppcache()

Promise Wycofane od wersji Chrome 152
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Obsługa pamięci podręcznej aplikacji została usunięta. Ta funkcja nie ma żadnego efektu.

Czyści dane pamięci podręcznej aplikacji witryn.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu danych pamięci podręcznej aplikacji witryn.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeCache()

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

Czyszczenie pamięci podręcznej przeglądarki.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu pamięci podręcznej przeglądarki.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeCacheStorage()

Promise Chrome 72 lub nowsza wersja 
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Czyści dane z pamięci podręcznej witryn.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu pamięci podręcznej witryn.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeCookies()

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

Usuwa pliki cookie przeglądarki i certyfikaty powiązane z serwerem zmodyfikowane w określonym przedziale czasu.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem, gdy pliki cookie przeglądarki i certyfikaty powiązane z serwerem zostaną wyczyszczone.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeDownloads()

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

Czyści listę pobranych plików w przeglądarce (nie same pobrane pliki).

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem, gdy lista pobranych plików w przeglądarce zostanie wyczyszczona.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeFileSystems()

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

Czyści dane systemu plików witryn.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu systemów plików witryn.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeFormData()

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

Usuwa dane formularzy zapisane w przeglądarce (autouzupełnianie).

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem, gdy dane formularza przeglądarki zostaną wyczyszczone.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeHistory()

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

Czyści historię przeglądarki.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu historii przeglądarki.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeIndexedDB()

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

Usuwa dane IndexedDB witryn.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem, gdy dane IndexedDB witryn zostały wyczyszczone.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeLocalStorage()

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

Usuwa dane z pamięci lokalnej witryn.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu pamięci lokalnej witryn.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removePasswords()

Promise Wycofane od Chrome 144
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usunięto obsługę usuwania haseł za pomocą rozszerzeń. Ta funkcja nie ma żadnego efektu.

Usuwa hasła zapisane w przeglądarce.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem, gdy hasła w przeglądarce zostały wyczyszczone.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removePluginData()

Promise Wycofane od Chrome 88
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Obsługa Flasha została usunięta. Ta funkcja nie ma żadnego efektu.

Usuwa dane wtyczek.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu danych wtyczek.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeServiceWorkers()

Promise Chrome 72 lub nowsza wersja 
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa skrypty service worker witryn.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu skryptów service worker witryn.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeWebSQL()

Promise Wycofane od wersji Chrome 152
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Obsługa WebSQL została usunięta. Ta funkcja nie ma żadnego efektu.

Usuwa dane WebSQL witryn.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Rozwiązuje problem po wyczyszczeniu baz danych WebSQL witryn.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

settings()

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

Raportuje, które typy danych są obecnie wybrane w interfejsie ustawień „Wyczyść dane przeglądania”. Uwaga: niektóre typy danych uwzględnione w tym interfejsie API są niedostępne w interfejsie ustawień, a niektóre ustawienia interfejsu sterują więcej niż 1 typem danych wymienionym tutaj.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: object) => void

    • wynik

      obiekt

      • dataRemovalPermitted

        DataTypeSet

        W wyniku pojawią się wszystkie typy z wartościami true, jeśli można je usunąć (np. zgodnie z zasadami firmy), lub false, jeśli nie można ich usunąć.

      • dataToRemove

        DataTypeSet

        Wszystkie typy będą obecne w wyniku z wartościami true, jeśli zostały wybrane do usunięcia i można je usunąć. W przeciwnym razie będą miały wartości false.

Zwroty

  • Promise<object>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.