कंपनी का ब्यौरा
किसी उपयोगकर्ता की लोकल प्रोफ़ाइल से ब्राउज़िंग डेटा हटाने के लिए, chrome.browsingData
एपीआई का इस्तेमाल करें.
अनुमतियां
browsingData
मेनिफ़ेस्ट
इस एपीआई का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "ब्राउज़िंग डेटा" अनुमति का एलान करना होगा.
{
"name": "My extension",
...
"permissions": [
"browsingData",
],
...
}
इस्तेमाल का तरीका
इस एपीआई का इस्तेमाल आसानी से किया जा सकता है. यह, उपयोगकर्ता के ब्राउज़िंग डेटा को मिटाने के लिए, समय के हिसाब से काम करने वाली तकनीक है.
आपके कोड को एक ऐसा टाइमस्टैंप देना चाहिए जिससे यह पता चलता हो कि किस तारीख के बाद उपयोगकर्ता का ब्राउज़िंग डेटा हटाया जाना चाहिए. इस टाइमस्टैंप को Unix epoch के बाद से मिलीसेकंड की संख्या के तौर पर फ़ॉर्मैट किया जाता है (जिसे getTime
तरीके से, JavaScript Date
ऑब्जेक्ट से वापस लाया जा सकता है).
उदाहरण के लिए, किसी उपयोगकर्ता का पिछले हफ़्ते का सारा ब्राउज़िंग डेटा मिटाने के लिए, आप इस तरह कोड लिख सकते हैं:
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
पैरामीटर का इस्तेमाल किया जा सकता है. इन्हें सिर्फ़ कुकी, कैश मेमोरी, और स्टोरेज (कैश मेमोरी, 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-सैंपल डेटा स्टोर करने की जगह से, browsingData API का उदाहरण इंस्टॉल करें.
टाइप
DataTypeSet
डेटा टाइप का सेट. छूटे हुए डेटा टाइप को false
समझा जाता है.
प्रॉपर्टी
-
ऐप्लिकेशन कैश
बूलियन ज़रूरी नहीं
वेबसाइटों पर मौजूद ऐप्लिकेशन की कैश मेमोरी.
-
कैश मेमोरी
बूलियन ज़रूरी नहीं
ब्राउज़र की कैश मेमोरी.
-
cacheStorage
बूलियन ज़रूरी नहीं
Chrome 72 और उसके बाद के वर्शनकैश मेमोरी
-
कुकी
बूलियन ज़रूरी नहीं
ब्राउज़र की कुकी.
-
डाउनलोड किए गए वीडियो
बूलियन ज़रूरी नहीं
ब्राउज़र की डाउनलोड सूची.
-
fileSystems
बूलियन ज़रूरी नहीं
वेबसाइट के फ़ाइल सिस्टम.
-
formData
बूलियन ज़रूरी नहीं
ब्राउज़र का सेव किया गया फ़ॉर्म डेटा.
-
इतिहास
बूलियन ज़रूरी नहीं
ब्राउज़र का इतिहास.
-
indexedDB
बूलियन ज़रूरी नहीं
वेबसाइट का IndexedDB डेटा.
-
localStorage
बूलियन ज़रूरी नहीं
वेबसाइट का लोकल स्टोरेज डेटा.
-
पासवर्ड
बूलियन ज़रूरी नहीं
सेव किए गए पासवर्ड.
-
pluginData
बूलियन ज़रूरी नहीं
Chrome 88 के बाद से काम नहीं कर रहा हैFlash की सुविधा हटा दी गई है. इस डेटा टाइप को अनदेखा कर दिया जाएगा.
प्लगिन का डेटा.
-
serverBoundCertificates
बूलियन ज़रूरी नहीं
Chrome 76 के बाद से अब काम नहीं करतासर्वर-बाउंड सर्टिफ़िकेट के लिए सहायता हटा दी गई है. इस डेटा टाइप को अनदेखा कर दिया जाएगा.
सर्वर-बाउंड सर्टिफ़िकेट.
-
serviceWorkers
बूलियन ज़रूरी नहीं
सर्विस वर्कर.
-
webSQL
बूलियन ज़रूरी नहीं
वेबसाइटों का WebSQL डेटा.
RemovalOptions
ऐसे विकल्प जो तय करते हैं कि कौनसा डेटा हटाया जाएगा.
प्रॉपर्टी
-
excludeOrigins
स्ट्रिंग[] ज़रूरी नहीं
Chrome 74 और उसके बाद के वर्शन परइस सूची में ऑरिजिन का डेटा मौजूद होने पर, उसे मिटाया नहीं जाता.
origins
के साथ इस्तेमाल नहीं किया जा सकता. यह सुविधा सिर्फ़ कुकी, स्टोरेज, और कैश मेमोरी के लिए काम करती है. कुकी, रजिस्टर किए जा सकने वाले पूरे डोमेन के लिए बाहर रखी जाती हैं. -
originTypes
ऑब्जेक्ट ज़रूरी नहीं
एक ऐसा ऑब्जेक्ट जिसकी प्रॉपर्टी से यह तय होता है कि किस ऑरिजिन टाइप को हटाना है. अगर यह ऑब्जेक्ट तय नहीं किया गया है, तो डिफ़ॉल्ट रूप से यह सिर्फ़ "असुरक्षित" ऑरिजिन को मिटाता है. कृपया पक्का करें कि आप 'सुरक्षित वेब' या 'एक्सटेंशन' जोड़ने से पहले सच में ऐप्लिकेशन डेटा हटाना चाहते हैं.
-
एक्सटेंशन
बूलियन ज़रूरी नहीं
ऐसे एक्सटेंशन और पैकेज किए गए ऐप्लिकेशन जिन्हें किसी उपयोगकर्ता ने इंस्टॉल किया है (_really_ सावधान रहें!).
-
protectedWeb
बूलियन ज़रूरी नहीं
वे वेबसाइटें, जिन्हें होस्ट किए गए ऐप्लिकेशन के रूप में इंस्टॉल किया गया है (सावधान रहें!).
-
unprotectedWeb
बूलियन ज़रूरी नहीं
सामान्य वेबसाइटें.
-
-
ऑरिजिन
[string, ...string[]] optional
Chrome 74 और उसके बाद के वर्शन परयह जानकारी मौजूद होने पर, सिर्फ़ इस सूची में शामिल ऑरिजिन का डेटा मिटाया जाता है. यह सुविधा सिर्फ़ कुकी, स्टोरेज, और कैश मेमोरी के लिए काम करती है. कुकी सभी पंजीकृत डोमेन के लिए साफ़ कर दी जाती हैं.
-
प्रारंभ
नंबर वैकल्पिक
इस तारीख को या इसके बाद इकट्ठा हुए डेटा को हटाएं. यह epoch के बाद, मिलीसेकंड में दिखाया जाता है. इसे JavaScript
Date
ऑब्जेक्ट केgetTime
तरीके से ऐक्सेस किया जा सकता है. यह विकल्प मौजूद न होने पर, इसकी डिफ़ॉल्ट वैल्यू 0 हो जाती है. इससे सारा ब्राउज़िंग डेटा हट जाएगा.
तरीके
remove()
chrome.browsingData.remove(
options: RemovalOptions,
dataToRemove: DataTypeSet,
callback?: function,
)
उपयोगकर्ता की प्रोफ़ाइल में स्टोर किए गए कई तरह के ब्राउज़िंग डेटा को मिटाता है.
पैरामीटर
-
विकल्प
-
dataToRemove
हटाए जाने वाले डेटा टाइप का सेट.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeAppcache()
chrome.browsingData.removeAppcache(
options: RemovalOptions,
callback?: function,
)
वेबसाइटों का ऐप्लिकेशन कैश डेटा मिटाता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeCache()
chrome.browsingData.removeCache(
options: RemovalOptions,
callback?: function,
)
ब्राउज़र की कैश मेमोरी मिटाता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeCacheStorage()
chrome.browsingData.removeCacheStorage(
options: RemovalOptions,
callback?: function,
)
वेबसाइटों का कैश मेमोरी डेटा मिटाएं.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeCookies()
chrome.browsingData.removeCookies(
options: RemovalOptions,
callback?: function,
)
किसी खास समय-सीमा में बदलाव किए गए ब्राउज़र की कुकी और सर्वर-बाउंड सर्टिफ़िकेट साफ़ करता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeDownloads()
chrome.browsingData.removeDownloads(
options: RemovalOptions,
callback?: function,
)
ब्राउज़र की डाउनलोड की गई फ़ाइलों की सूची हटाता है (डाउनलोड की गई फ़ाइलें नहीं).
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeFileSystems()
chrome.browsingData.removeFileSystems(
options: RemovalOptions,
callback?: function,
)
वेबसाइटों का फ़ाइल सिस्टम डेटा मिटाता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeFormData()
chrome.browsingData.removeFormData(
options: RemovalOptions,
callback?: function,
)
ब्राउज़र का संग्रहित फ़ॉर्म डेटा (ऑटोफ़िल) साफ़ करता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeHistory()
chrome.browsingData.removeHistory(
options: RemovalOptions,
callback?: function,
)
ब्राउज़र के इतिहास को मिटाता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeIndexedDB()
chrome.browsingData.removeIndexedDB(
options: RemovalOptions,
callback?: function,
)
वेबसाइटों का IndexedDB डेटा साफ़ करता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeLocalStorage()
chrome.browsingData.removeLocalStorage(
options: RemovalOptions,
callback?: function,
)
वेबसाइटों का लोकल स्टोरेज डेटा मिटाता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removePasswords()
chrome.browsingData.removePasswords(
options: RemovalOptions,
callback?: function,
)
ब्राउज़र के सेव किए गए पासवर्ड मिटाता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removePluginData()
chrome.browsingData.removePluginData(
options: RemovalOptions,
callback?: function,
)
Flash की सुविधा हटा दी गई है. इस फ़ंक्शन का कोई असर नहीं होता.
प्लगिन का डेटा साफ़ करता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeServiceWorkers()
chrome.browsingData.removeServiceWorkers(
options: RemovalOptions,
callback?: function,
)
वेबसाइट सेवा कर्मियों को साफ़ करता है.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
removeWebSQL()
chrome.browsingData.removeWebSQL(
options: RemovalOptions,
callback?: function,
)
वेबसाइटों का WebSQL डेटा मिटाएं.
पैरामीटर
-
विकल्प
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
सामान लौटाना
-
Promise<void>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
settings()
chrome.browsingData.settings(
callback?: function,
)
यह रिपोर्ट करता है कि 'ब्राउज़िंग डेटा मिटाएं' सेटिंग यूज़र इंटरफ़ेस (यूआई) में फ़िलहाल किस तरह का डेटा चुना गया है. ध्यान दें: इस एपीआई में शामिल कुछ डेटा टाइप, सेटिंग यूज़र इंटरफ़ेस (यूआई) में उपलब्ध नहीं हैं. साथ ही, कुछ यूज़र इंटरफ़ेस (यूआई) सेटिंग यहां दिए गए एक से ज़्यादा डेटा टाइप को कंट्रोल करती हैं.
पैरामीटर
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(result: object) => void
-
नतीजा
ऑब्जेक्ट
-
dataRemovalPermitted
सभी टाइप, नतीजे में मौजूद होंगे. अगर उन्हें हटाने की अनुमति है, तो उनकी वैल्यू
true
के साथ होगी (उदाहरण के लिए, एंटरप्राइज़ नीति के हिसाब से) और अगर नहीं है, तोfalse
की वैल्यू दिखाई जाएगी. -
dataToRemove
सभी टाइप, नतीजे में
true
की वैल्यू के साथ मौजूद होंगे. ऐसा तब होगा, जब उन दोनों टाइप को हटाने के लिए चुना गया हो या फिरfalse
. -
विकल्प
-
-
सामान लौटाना
-
Promise<object>
Chrome 96 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.