Enable incognito_session_only preferences

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "unprivileged": true,
     "types": [
       {
         "id": "MessageSender",
         "type": "object",
         "description": "An object containing information about the script context that sent a message or request.",
         "properties": {
@@ skipping 5337 matching lines @@
                     "type": "object",
                     "description": "Details of the currently effective preference value.",
                     "properties": {
                       "value": {
                         "description": "The value of the preference.",
                         "type": "any"
                       },
                       "levelOfControl": {
                         "description": "One of<br><var>NotControllable</var>: cannot be controlled by any extension<br><var>ControlledByOtherExtensions</var>: controlled by extensions with higher precedence<br><var>ControllableByThisExtension</var>: can be controlled by this extension<br><var>ControlledByThisExtension</var>: controlled by this extension",
                         "type": "string",
                         "enum": ["NotControllable", "ControlledByOtherExtensions", "ControllableByThisExtension", "ControlledByThisExtension"]

[Matt Perry, 2011/05/24 22:07:17]

Sorry for not noticing this sooner, but we should have some consistency with our
enum values. Most released APIs use names like not_controllable, so we should go
with that naming here.

[battre, 2011/05/25 11:51:30]

Will do in a separate CL as it is currently not sure whether we want to go
camelCase or hacker_style.

                       },
                       "incognitoSpecific": {
                         "description": "Whether the effective value is specific to the incognito session.<br>This property will <em>only</em> be present if the <var>incognito</var> property in the <var>details</var> parameter of <code>get()</code> was true.",
                         "type": "boolean",
                         "optional": true
                       }
                     }
                   }
                 ]
               }
             ]
           },
           {
             "name": "set",
             "type": "function",
             "description": "Set the setting in the user preferences",
             "parameters": [
               {
                 "name": "details",
                 "type": "object",
                 "description": "What setting to change.",
                 "properties": {
                   "value": {
                     "description": "The value of the preference. <br>Note that every preference has a specific value type, which is described together with the preference. An extension should <em>not</em> set a preference value of a different type.",
                     "type": "any"
                   },
                   "scope": {
                     "type": "string",
-                    "enum": ["regular", "incognito_persistent"],
+                    "enum": ["regular", "incognito_persistent", "incognito_session_only"],
                     "optional": true,
-                    "description": "Where to set the preference (default: regular). 'regular' = preference for regular profile (which is inherited by the incognito profile if not overridden elsewhere), 'incognito_persistent' = preference for incognito profile that sustains browser restarts (overrides regular preferences)."
+                    "description": "Where to set the preference (default: regular). One of <br><var>regular</var>: preference for regular profile (which is inherited by the incognito profile if not overridden elsewhere), 'incognito_persistent' = preference for incognito profile that sustains browser restarts (overrides regular preferences)."

[Matt Perry, 2011/05/24 22:07:17]

doesn't explain incognito_session_only

[battre, 2011/05/25 11:51:30]

Done.

                   }
                 }
               },
               {
                 "name": "callback",
                 "type": "function",
                 "description": "Called after the preference has been set.",
                 "optional": true,
                 "parameters": []
               }
             ]
           },
           {
             "name": "clear",
             "type": "function",
             "description": "Clears the setting in the user preferences. This way default settings can become effective again.",
             "parameters": [
               {
                 "name": "details",
                 "type": "object",
                 "description": "What preference to clear.",
                 "properties": {
                   "scope": {
                     "type": "string",
-                    "enum": ["regular", "incognito_persistent"],
+                    "enum": ["regular", "incognito_persistent", "incognito_session_only"],
                     "optional": true,
-                    "description": "Where to set the preference (default: regular). 'regular' = preference for regular profile (which is inherited by the incognito profile if not overridden elsewhere), 'incognito_persistent' = preference for incognito profile that sustains browser restarts (overrides regular preferences)."
+                    "description": "Where to set the preference (default: regular). One of<br><var>'regular'</var>: preference for regular profile (which is inherited by the incognito profile if not overridden elsewhere),<br><var>incognito_persistent</var>: preference for incognito profile that sustains browser restarts (overrides regular preferences),<br><var>incognito_session_only</var>: preference for incognito profile that can only be set during an incognito session and is deleted when the incognito session ends (overrides regular and incognito_persistent' preferences)."

[Bernhard Bauer, 2011/05/24 21:43:57]

Nit: s/sustains/survives/?

[Matt Perry, 2011/05/24 22:07:17]

last apostrophe unnecessary.

Copy this description to the set() method.

[battre, 2011/05/25 11:51:30]

Done.

[battre, 2011/05/25 11:51:30]

Done.

                   }
                 }
               },
               {
                 "name": "callback",
                 "type": "function",
                 "description": "Called after the preference has been cleared.",
                 "optional": true,
                 "parameters": []
               }
@@ skipping 168 matching lines @@
           {
             "type": "integer",
             "name": "tabId",
             "description": "The id of the tab that was detached."
           }
         ]
       }
     ]
   }
 ]