Return the full cookie details in TestingAutomationProvider and pass around

chrome/browser/automation/testing_automation_provider.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_AUTOMATION_TESTING_AUTOMATION_PROVIDER_H_
 #define CHROME_BROWSER_AUTOMATION_TESTING_AUTOMATION_PROVIDER_H_
 #pragma once
 
 #include "base/basictypes.h"
 #include "base/scoped_ptr.h"
@@ skipping 845 matching lines @@
   //   output: { "url": "http://www.google.com" }
   void GetTabURLJSON(DictionaryValue* args, IPC::Message* reply_message);
 
   // Get the current url of the specified tab. Uses the JSON interface.
   // Example:
   //   input: { "windex": 1, "tab_index": 1 }
   //   output: { "title": "Google" }
   void GetTabTitleJSON(DictionaryValue* args, IPC::Message* reply_message);
 
   // Gets the cookies for the given URL. Uses the JSON interface.
+  // "expiry" refers to the amount of seconds since the Unix epoch. If omitted,
+  // the cookie is valid for the duration of the browser session.
   // Example:
-  //   input: { "windex": 1, "tab_index": 1, "url": "http://www.google.com" }
-  //   output: { "cookies": "PREF=12012" }
+  //   input: { "url": "http://www.google.com" }
+  //   output: { "cookies": [
+  //               {
+  //                 "name": "PREF",
+  //                 "value": "123101",
+  //                 "path": "/",
+  //                 "domain": "www.google.com",
+  //                 "secure": false,
+  //                 "expiry": 1401982012
+  //               }
+  //             ]
+  //           }
   void GetCookiesJSON(DictionaryValue* args, IPC::Message* reply_message);
 
   // Deletes the cookie with the given name for the URL. Uses the JSON
   // interface.
   // Example:
-  //   input: { "windex": 1,
-  //            "tab_index": 1,
+  //   input: {
   //            "url": "http://www.google.com",
   //            "name": "my_cookie"
   //          }
   //   output: none
   void DeleteCookieJSON(DictionaryValue* args, IPC::Message* reply_message);
 
   // Sets a cookie for the given URL. Uses the JSON interface.
+  // "expiry" refers to the amount of seconds since the Unix epoch. If omitted,
+  // the cookie will be valid for the duration of the browser session.
+  // "domain" refers to the applicable domain for the cookie. Valid domain
+  // choices for the site "http://www.google.com" and resulting cookie
+  // applicability:
+  //   [.]www.google.com - applicable on www.google.com and its subdomains
+  //   [.]google.com - applicable on google.com and its subdomains
+  //   <none> - applicable only on www.google.com
+  //
   // Example:
-  //   input: { "windex": 1,
-  //            "tab_index": 1,
-  //            "url": "http://www.google.com",
-  //            "cookie": "PREF=21321"
+  //   input: { "url": "http://www.google.com",
+  //            "cookie": {
+  //              "name": "PREF",
+  //              "value": "123101",
+  //              "path": "/",                  // optional
+  //              "domain": ".www.google.com",  // optional
+  //              "secure": false,              // optional
+  //              "expiry": 1401982012          // optional
+  //            }
   //          }
   //   output: none
   void SetCookieJSON(DictionaryValue* args, IPC::Message* reply_message);
 
   // Gets the ID for every open tab. This ID is unique per session.
   // Example:
   //   input: none
   //   output: { "ids": [4124, 213, 1] }
   void GetTabIds(DictionaryValue* args, IPC::Message* reply_message);
 
@@ skipping 151 matching lines @@
   // Used to enumerate browser profiles.
   scoped_refptr<ImporterList> importer_list_;
 
   // The stored data for the ImportSettings operation.
   ImportSettingsData import_settings_data_;
 
   DISALLOW_COPY_AND_ASSIGN(TestingAutomationProvider);
 };
 
 #endif  // CHROME_BROWSER_AUTOMATION_TESTING_AUTOMATION_PROVIDER_H_