chrome.browsingData

คำอธิบาย

สิทธิ์

คุณต้องประกาศสิทธิ์ "browsingData" ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ API นี้

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

แนวคิดและการใช้งาน

กรณีการใช้งานที่ง่ายที่สุดสำหรับ API นี้คือกลไกตามเวลาสำหรับการล้างข้อมูลการท่องเว็บของผู้ใช้ โค้ดควรระบุการประทับเวลาที่บ่งบอกวันที่ในอดีตหลังจากที่ควรนำข้อมูลการท่องเว็บของผู้ใช้ออก การประทับเวลานี้จัดรูปแบบเป็นจำนวนมิลลิวินาทีตั้งแต่ ยุค 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 ลงในออบเจ็กต์ตัวเลือก API จะช่วยให้คุณระบุประเภทต้นทางที่ควรได้รับผลกระทบได้ ต้นทางแบ่งออกเป็น 3 หมวดหมู่ ดังนี้

• 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

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>