Strawman proposal for chrome.experimental.clear.*

chrome/common/extensions/api/extension_api.json

Index: chrome/common/extensions/api/extension_api.json
diff --git a/chrome/common/extensions/api/extension_api.json b/chrome/common/extensions/api/extension_api.json
index e8a40a1d49e595568703fbca6df16339417a45ff..eeb822b9024013578a8294cc47cfebc5f366dfbd 100644
--- a/chrome/common/extensions/api/extension_api.json
+++ b/chrome/common/extensions/api/extension_api.json
@@ -7521,5 +7521,228 @@
         ]
       }
     ]
+  },
+  {
+    "namespace": "experimental.clear",
+    "functions": [
+      {
+        "name": "browsingData",
+        "description": "Clears data generated by browsing within a particular timeframe.",
+        "type": "function",
+        "parameters": [
+          {
+            "name": "timePeriod",
+            "type": "string",
+            "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],

[Bernhard Bauer, 2011/08/16 09:49:36]

I think you could pull this into a type?

[Mike West, 2011/08/16 11:05:56]

Done.

+            "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."
+          },
+          {
+            "name": "dataToRemove",
+            "type": "object",
+            "properties": {
+              "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?"
+              },
+              "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?"
+              },
+              "passwords": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Should the stored passwords be cleared?"
+              }
+            }
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when deletion has completed.",
+            "optional": true,
+            "parameters": [
+                {
+                  "name": "result",
+                  "type": "boolean",
+                  "description": "Was the data deletion successful?"
+                }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "cache",
+        "description": "Clears the browser's cache.",
+        "type": "function",
+        "parameters": [
+          {
+            "name": "timePeriod",
+            "type": "string",
+            "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],
+            "description": "The timeframe inside of which to delete cached data. Passing 'last_day', for example, will delete all browsing data that was touched between 24 hours ago and right now, inclusive."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when the browser's cache has cleared.",
+            "optional": true,
+            "parameters": [
+                {
+                  "name": "result",
+                  "type": "boolean",
+                  "description": "Was the data deletion successful?"
+                }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "cookies",
+        "description": "Clears the browser's cookies and site data.",
+        "type": "function",
+        "parameters": [
+          {
+            "name": "timePeriod",
+            "type": "string",
+            "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],
+            "description": "The timeframe inside of which to delete cookies."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when the browser's cookies and site data have been cleared.",
+            "optional": true,
+            "parameters": [
+                {
+                  "name": "result",
+                  "type": "boolean",
+                  "description": "Was the data deletion successful?"
+                }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "downloads",
+        "description": "Clears the browser's list of downloaded files (<em>not</em> the downloaded files themselves).",
+        "type": "function",
+        "parameters": [
+          {
+            "name": "timePeriod",
+            "type": "string",
+            "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],
+            "description": "The timeframe inside of which to delete listed downloaded files."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when the browser's list of downloaded files has been cleared.",
+            "optional": true,
+            "parameters": [
+                {
+                  "name": "result",
+                  "type": "boolean",
+                  "description": "Was the data deletion successful?"
+                }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "formData",
+        "description": "Clears the browser's stored form data (autofill).",
+        "type": "function",
+        "parameters": [
+          {
+            "name": "timePeriod",
+            "type": "string",
+            "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],
+            "description": "The timeframe inside of which to delete form data."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when the browser's form data has been cleared.",
+            "optional": true,
+            "parameters": [
+                {
+                  "name": "result",
+                  "type": "boolean",
+                  "description": "Was the data deletion successful?"
+                }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "history",
+        "description": "Clears the browser's history.",
+        "type": "function",
+        "parameters": [
+          {
+            "name": "timePeriod",
+            "type": "string",
+            "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],
+            "description": "The timeframe inside of which to delete browsing history."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when the browser's history has cleared.",
+            "optional": true,
+            "parameters": [
+                {
+                  "name": "result",
+                  "type": "boolean",
+                  "description": "Was the data deletion successful?"
+                }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "passwords",
+        "description": "Clears the browser's stored passwords.",
+        "type": "function",
+        "parameters": [
+          {
+            "name": "timePeriod",
+            "type": "string",
+            "enum": ["last_hour", "last_day", "last_week", "last_month", "everything"],
+            "description": "The timeframe inside of which to delete stored passwords."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "description": "Called when the browser's passwords have been cleared.",
+            "optional": true,
+            "parameters": [
+                {
+                  "name": "result",
+                  "type": "boolean",
+                  "description": "Was the data deletion successful?"
+                }
+            ]
+          }
+        ]
+      }
+    ]
   }
 ]