chrome.browsingData

বিবরণ

অনুমতিসমূহ

এই API ব্যবহার করার জন্য আপনাকে এক্সটেনশন ম্যানিফেস্টে "browsingData" অনুমতি ঘোষণা করতে হবে।

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

ধারণা এবং ব্যবহার

এই API-এর সবচেয়ে সহজ ব্যবহার হল ব্যবহারকারীর ব্রাউজিং ডেটা মুছে ফেলার জন্য একটি সময়-ভিত্তিক প্রক্রিয়া। আপনার কোডে একটি টাইমস্ট্যাম্প থাকা উচিত যা ব্যবহারকারীর ব্রাউজিং ডেটা মুছে ফেলার ঐতিহাসিক তারিখ নির্দেশ করে। এই টাইমস্ট্যাম্পটি ইউনিক্স যুগের পর থেকে মিলিসেকেন্ডের সংখ্যা হিসাবে ফর্ম্যাট করা হয় (যা getTime() পদ্ধতি ব্যবহার করে একটি জাভাস্ক্রিপ্ট 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 প্যারামিটার ব্যবহার করতে পারেন। এগুলি কেবল কুকিজ, ক্যাশে এবং স্টোরেজে (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);

উৎপত্তির ধরণ

APIs options অবজেক্টে একটি originTypes প্রপার্টি যোগ করলে আপনি কোন ধরণের origin কার্যকর করা উচিত তা নির্দিষ্ট করতে পারবেন। Origins কে তিনটি বিভাগে ভাগ করা হয়েছে:

• 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 ব্যবহার করে দেখতে, 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>