Send screenshots back to the client for debugging

chrome/test/webdriver/automation.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_TEST_WEBDRIVER_AUTOMATION_H_
 #define CHROME_TEST_WEBDRIVER_AUTOMATION_H_
 
 #include <map>
 #include <string>
 #include <vector>
@@ skipping 41 matching lines @@
   void ExecuteScript(int tab_id,
                      const FramePath& frame_path,
                      const std::string& script,
                      std::string* result,
                      bool* success);
 
   // Sends a key event to the current browser. Waits until the key has
   // been processed by the web page.
   void SendWebKeyEvent(int tab_id, const WebKeyEvent& key_event, bool* success);
 
+  // Returns a string containing the raw binary data of a PNG image of the

[kkania, 2011/03/22 21:08:56]

this comment is not accurate, like the other one. It does not return a string.
It just saves the snapshot to disk.  Please fix.

[Joe, 2011/03/22 22:08:19]

Done.

+  // tab requested.  The PNG will contain the entire page, including what
+  // is not in the current view on the screen.
+  void CaptureEntirePageAsPNG(int tab_id, const FilePath& path, bool* success);
+
   void NavigateToURL(int tab_id, const std::string& url, bool* success);
   void GoForward(int tab_id, bool* success);
   void GoBack(int tab_id, bool* success);
   void Reload(int tab_id, bool* success);
   void GetURL(int tab_id, std::string* url, bool* success);
   void GetGURL(int tab_id, GURL* gurl, bool* success);
   void GetTabTitle(int tab_id, std::string* tab_title, bool* success);
   void GetCookies(
       int tab_id, const GURL& gurl, std::string* cookies, bool* success);
   void DeleteCookie(int tab_id,
@@ skipping 34 matching lines @@
   scoped_ptr<ProxyLauncher> launcher_;
 
   DISALLOW_COPY_AND_ASSIGN(Automation);
 };
 
 }  // namespace webdriver
 
 DISABLE_RUNNABLE_METHOD_REFCOUNT(webdriver::Automation);
 
 #endif  // CHROME_TEST_WEBDRIVER_AUTOMATION_H_