chrome.browsingData

ब्यौरा

अनुमतियां

इस एपीआई का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "browsingData" अनुमति का एलान करना होगा.

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

कॉन्सेप्ट और इस्तेमाल करने का तरीका

इस एपीआई का सबसे आसान इस्तेमाल, उपयोगकर्ता के ब्राउज़िंग डेटा को मिटाने के लिए समय पर आधारित एक तरीका है. आपके कोड में एक टाइमस्टैंप होना चाहिए. इससे यह पता चलता है कि किस तारीख के बाद उपयोगकर्ता के ब्राउज़िंग डेटा को हटाया जाना चाहिए. इस टाइमस्टैंप को यूनिक्स epoch के बाद से मिलीसेकंड की संख्या के तौर पर फ़ॉर्मैट किया जाता है. इसे JavaScript Date ऑब्जेक्ट से 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 प्रॉपर्टी जोड़ने से, यह तय किया जा सकता है कि किस तरह के ऑरिजिन पर असर पड़ना चाहिए. ऑरिजिन को तीन कैटगरी में बांटा गया है:

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

उदाहरण

इस एपीआई को आज़माने के लिए, chrome-extension-samples रिपॉज़िटरी से browsingData API का उदाहरण इंस्टॉल करें.

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>