chrome.browsingData

Mô tả

Quyền

Bạn phải khai báo quyền "browsingData" trong tệp kê khai tiện ích để sử dụng API này.

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

Khái niệm và cách sử dụng

Trường hợp sử dụng đơn giản nhất cho API này là cơ chế dựa trên thời gian để xoá dữ liệu duyệt web của người dùng. Mã của bạn phải cung cấp một dấu thời gian cho biết ngày trong quá khứ mà sau đó dữ liệu duyệt web của người dùng sẽ bị xoá. Dấu thời gian này được định dạng dưới dạng số mili giây kể từ thời gian bắt đầu của hệ thống Unix (có thể truy xuất từ đối tượng Date JavaScript bằng phương thức getTime()).

Ví dụ: để xoá tất cả dữ liệu duyệt web của người dùng trong tuần qua, bạn có thể viết mã như sau:

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

Phương thức chrome.browsingData.remove() cho phép bạn xoá nhiều loại dữ liệu duyệt web chỉ bằng một lệnh gọi và sẽ nhanh hơn nhiều so với việc gọi nhiều phương thức cụ thể hơn. Tuy nhiên, nếu bạn chỉ muốn xoá một loại dữ liệu duyệt web cụ thể (ví dụ: cookie), thì các phương thức chi tiết hơn sẽ cung cấp một lựa chọn thay thế dễ đọc cho lệnh gọi chứa đầy 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); 

Nếu người dùng đang đồng bộ hoá dữ liệu, thì chrome.browsingData.remove() có thể tự động tạo lại cookie cho tài khoản Đồng bộ hoá sau khi xoá cookie đó. Việc này nhằm đảm bảo tính năng Đồng bộ hoá có thể tiếp tục hoạt động để dữ liệu cuối cùng có thể bị xoá trên máy chủ. Tuy nhiên, bạn có thể dùng chrome.browsingData.removeCookies() cụ thể hơn để xoá cookie cho tài khoản Đồng bộ hoá và Đồng bộ hoá sẽ tạm dừng trong trường hợp này.

Nguồn gốc cụ thể

Để xoá dữ liệu cho một nguồn cụ thể hoặc loại trừ một nhóm nguồn khỏi việc xoá, bạn có thể sử dụng các tham số RemovalOptions.origins và RemovalOptions.excludeOrigins. Chúng chỉ có thể được áp dụng cho cookie, bộ nhớ đệm và bộ nhớ (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers và WebSQL).

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

Loại nguồn gốc

Việc thêm thuộc tính originTypes vào đối tượng lựa chọn API cho phép bạn chỉ định những loại nguồn gốc cần được áp dụng. Nguồn gốc được chia thành 3 danh mục:

• unprotectedWeb bao gồm trường hợp chung của những trang web mà người dùng truy cập mà không thực hiện bất kỳ hành động đặc biệt nào. Nếu bạn không chỉ định originTypes, API sẽ mặc định xoá dữ liệu khỏi các nguồn gốc web không được bảo vệ.
• protectedWeb bao gồm những nguồn gốc web đã được cài đặt dưới dạng các ứng dụng được lưu trữ. Ví dụ: việc cài đặt Angry Birds sẽ bảo vệ nguồn https://chrome.angrybirds.com và xoá nguồn này khỏi danh mục unprotectedWeb. Hãy cẩn thận khi kích hoạt việc xoá dữ liệu cho những nguồn này: đảm bảo người dùng biết họ sẽ nhận được gì, vì việc này sẽ xoá dữ liệu trò chơi của họ mà không thể khôi phục. Không ai muốn phá đổ những ngôi nhà nhỏ của chú heo thường xuyên hơn mức cần thiết.
• extension bao gồm các nguồn gốc theo lược đồ chrome-extensions:. Việc xoá dữ liệu tiện ích là một việc mà bạn cần hết sức thận trọng.

Chúng ta có thể điều chỉnh ví dụ trước để chỉ xoá dữ liệu khỏi các trang web được bảo vệ như sau:

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

Ví dụ

Để dùng thử API này, hãy cài đặt ví dụ về browsingData API từ kho lưu trữ chrome-extension-samples.

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

chrome.browsingData.removeAppcache(
  options: RemovalOptions,
): Promise<void>

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

chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
): Promise<void>

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

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

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

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

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

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

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

chrome.browsingData.removePasswords(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removePluginData(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.settings(): Promise<object>