chrome.clear: Increasing granularity of public API

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "experimental.accessibility",
     "nodoc": true,
     "types": [
       {
         "id": "AccessibilityObject",
         "type": "object",
         "description": "Parent class for accessibility information about an object.",
         "properties": {
@@ skipping 8656 matching lines @@
         ]
       }
     ]
   },
   {
     "namespace": "experimental.clear",
     "types": [
       {
         "id": "TimePeriod",
         "type": "string",
         "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],

[jochen (gone - plz use gerrit), 2011/12/13 13:26:18]

why restrict this to the fixed periods instead of letting the extension specify
time points (start/end), or at least a timespan, so (now - timespan, now] is
deleted?

[Mike West, 2011/12/13 15:28:47]

No good reason. I think it's worthwhile to expand this to arbitrary timelines

However, we probably can't offer start/end timeframes since some of the removal
mechanisms don't support arbitrary ending points.

         "description": "The timeframe inside of which to delete browsing data. Passing 'last_day', for example, will delete all browsing data that was touched between 24 hours ago and right now, inclusive."
       }
     ],
     "functions": [
       {
         "name": "browsingData",
         "description": "Clears data generated by browsing within a particular timeframe.",
         "type": "function",
         "parameters": [
           {
             "$ref": "TimePeriod",
             "name": "period"
           },
           {
             "name": "dataToRemove",
             "type": "object",
             "description": "An object whose properties specify which browsing data types ought to be cleared. You may set as many or as few as you like in a single call, each is optional (defaulting to <code>false</code>).",
             "properties": {
+              "appcache": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Should websites' appcaches be cleared?"
+              },
               "cache": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Should the browser cache be cleared?"
               },
               "cookies": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Should the browser's cookies be cleared?"
               },
               "downloads": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Should the browser's download list be cleared?"
               },
+              "fileSystems": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Should websites' file systems be cleared?"
+              },
               "formData": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Should stored form data be cleared?"
               },
               "history": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Should the browser's history be cleared?"
               },
+              "indexedDB": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Should websites' IndexedDB data be cleared?"
+              },
+              "localStorage": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Should websites' local storage data be cleared?"
+              },
+              "lsoData": {

[jochen (gone - plz use gerrit), 2011/12/13 13:26:18]

lsoData sounds strange, what about localSharedObjects or pluginData. Flash for
example also kills history and cache, not only lsos

[Mike West, 2011/12/13 15:28:47]

pluginData makes sense, and better matches what we're actually doing. We should
change BDR's external interface to use this term to match
content::PluginDataRemover. Pulling part of this out into
http://crbug.com/107355, for which a CL is in-flight; the rest is in the newly
uploaded patch.

+                "type": "boolean",
+                "optional": true,
+                "description": "Should plugins' Local Shared Object data be cleared?"
+              },
               "passwords": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Should the stored passwords be cleared?"
+              },
+              "webSQL": {

[jochen (gone - plz use gerrit), 2011/12/13 13:26:18]

I think the official name is web databases?

[Mike West, 2011/12/13 15:28:47]

The official name, unfortunately, seems to be "Web SQL Databases".
http://www.w3.org/TR/webdatabase/  I've been calling it WebSQL forever, but
that's no promise that it's actually common usage. CCing Kathy/Meggin for input
on this.

[jochen (gone - plz use gerrit), 2011/12/14 19:30:58]

In Chrome, we call it Web Databases (e.g.
http://codesearch.google.com/codesearch#OAMlx_jo-ck/src/chrome/app/generated_...)

+                "type": "boolean",
+                "optional": true,
+                "description": "Should websites' WebSQL data be cleared?"
               }
             }
           },
           {
             "name": "callback",
             "type": "function",
             "description": "Called when deletion has completed.",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
+        "name": "appcache",
+        "description": "Clears websites' appcache data.",
+        "type": "function",
+        "parameters": [
+          {
+            "$ref": "TimePeriod",
+            "name": "period"
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when websites' appcache data has been cleared.",
+            "optional": true,
+            "parameters": []
+          }
+        ]
+      },
+      {
         "name": "cache",
         "description": "Clears the browser's cache.",
         "type": "function",
         "parameters": [
           {
             "$ref": "TimePeriod",
             "name": "period"
           },
           {
             "name": "callback",
             "type": "function",
-            "description": "Called when the browser's cache has cleared.",
+            "description": "Called when the browser's cache has been cleared.",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
         "name": "cookies",
-        "description": "Clears the browser's cookies and site data.",
+        "description": "Clears the browser's cookies.",
         "type": "function",
         "parameters": [
           {
             "$ref": "TimePeriod",
             "name": "period"
           },
           {
             "name": "callback",
             "type": "function",
-            "description": "Called when the browser's cookies and site data have been cleared.",
+            "description": "Called when the browser's cookies have been cleared.",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
         "name": "downloads",
         "description": "Clears the browser's list of downloaded files (<em>not</em> the downloaded files themselves).",
         "type": "function",
         "parameters": [
           {
             "$ref": "TimePeriod",
             "name": "period"
           },
           {
             "name": "callback",
             "type": "function",
             "description": "Called when the browser's list of downloaded files has been cleared.",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
+        "name": "fileSystems",
+        "description": "Clears websites' file system data.",
+        "type": "function",
+        "parameters": [
+          {
+            "$ref": "TimePeriod",
+            "name": "period"
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when websites' file systems have been cleared.",
+            "optional": true,
+            "parameters": []
+          }
+        ]
+      },
+      {
         "name": "formData",
         "description": "Clears the browser's stored form data (autofill).",
         "type": "function",
         "parameters": [
           {
             "$ref": "TimePeriod",
             "name": "period"
           },
           {
             "name": "callback",
@@ skipping 16 matching lines @@
           {
             "name": "callback",
             "type": "function",
             "description": "Called when the browser's history has cleared.",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
+        "name": "indexedDB",
+        "description": "Clears websites' IndexedDB data.",
+        "type": "function",
+        "parameters": [
+          {
+            "$ref": "TimePeriod",
+            "name": "period"
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when websites' IndexedDB data has been cleared.",
+            "optional": true,
+            "parameters": []
+          }
+        ]
+      },
+      {
+        "name": "localStorage",
+        "description": "Clears websites' local storage data.",
+        "type": "function",
+        "parameters": [
+          {
+            "$ref": "TimePeriod",
+            "name": "period"
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when websites' local storage has been cleared.",
+            "optional": true,
+            "parameters": []
+          }
+        ]
+      },
+      {
+        "name": "lsoData",
+        "description": "Clears plugins' Local Storage Object data.",
+        "type": "function",
+        "parameters": [
+          {
+            "$ref": "TimePeriod",
+            "name": "period"
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when plugins' Local Storage Data has been cleared.",
+            "optional": true,
+            "parameters": []
+          }
+        ]
+      },
+      {
         "name": "passwords",
         "description": "Clears the browser's stored passwords.",
         "type": "function",
         "parameters": [
           {
             "$ref": "TimePeriod",
             "name": "period"
           },
           {
             "name": "callback",
             "type": "function",
             "description": "Called when the browser's passwords have been cleared.",
             "optional": true,
             "parameters": []
           }
         ]
+      },
+      {
+        "name": "webSQL",
+        "description": "Clears websites' WebSQL data.",
+        "type": "function",
+        "parameters": [
+          {
+            "$ref": "TimePeriod",
+            "name": "period"
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when websites' WebSQL databases have been cleared.",
+            "optional": true,
+            "parameters": []
+          }
+        ]
       }
     ]
   },
   {
     "namespace": "pageCapture",
     "functions": [
       {
         "name": "saveAsMHTML",
         "type": "function",
         "description": "Saves the content of the tab with given id as MHTML.",
@@ skipping 274 matching lines @@
                 "enum": ["enabled", "disabled", "forced"],
                 "description": "Exposes whether the incognito mode is available to windows. One of 'enabled', 'disabled' (user cannot browse pages in Incognito mode), 'forced' (all pages/sessions are forced into Incognito mode)."
               }
             ]
           }
         ]
       }
     ]
   }
 ]