Send screenshots back to the client for debugging

chrome/test/webdriver/session.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_SESSION_H_
 #define CHROME_TEST_WEBDRIVER_SESSION_H_
 
 #include <map>
 #include <string>
 #include <vector>
@@ skipping 80 matching lines @@
   bool MouseMove(const gfx::Point& location);
   bool MouseDrag(const gfx::Point& start, const gfx::Point& end);
 
   bool NavigateToURL(const std::string& url);
   bool GoForward();
   bool GoBack();
   bool Reload();
   bool GetURL(GURL* url);
   bool GetURL(std::string* url);
   bool GetTabTitle(std::string* tab_title);
+  bool GetScreenShot(std::string* png);
 
   bool GetCookies(const std::string& url, ListValue** cookies);
   bool GetCookiesDeprecated(const GURL& url, std::string* cookies);
   bool GetCookieByNameDeprecated(const GURL& url,
                                  const std::string& cookie_name,
                                  std::string* cookie);
   bool DeleteCookie(const std::string& url, const std::string& cookie_name);
   bool DeleteCookieDeprecated(const GURL& url, const std::string& cookie_name);
   bool SetCookie(const std::string& url, DictionaryValue* cookie_dict);
   bool SetCookieDeprecated(const GURL& url, const std::string& cookie);
@@ skipping 76 matching lines @@
                              int* border_top);
 
   // Gets whether the element is currently displayed.
   ErrorCode IsElementDisplayed(const FrameId& frame_id,
                                const WebElementId& element,
                                bool* is_visible);
 
   // Waits for all tabs to stop loading. Returns true on success.
   bool WaitForAllTabsToStopLoading();
 
-  inline const std::string& id() const { return id_; }
+  const std::string& id() const;
 
-  inline int implicit_wait() const { return implicit_wait_; }
-  inline void set_implicit_wait(const int& timeout) {
-    implicit_wait_ = timeout > 0 ? timeout : 0;
-  }
+  int implicit_wait() const;
+  void set_implicit_wait(const int& timeout);
 
   enum Speed { kSlow, kMedium, kFast, kUnknown };
-  inline Speed speed() { return speed_; }
-  inline void set_speed(Speed speed) {
-    speed_ = speed;
-  }
+  Speed speed() const;
+  void set_speed(Speed speed);
+
+  // Since screenshots can be very large when in base64 PNG format; the
+  // client is allowed to dyamically enable/disable screenshots on error
+  // during the lifetime of the session.
+  bool screenshot_on_error() const;
+  void set_screenshot_on_error(bool error);
 
   const FrameId& current_target() const;
 
  private:
   void RunSessionTask(Task* task);
   void RunSessionTaskOnSessionThread(
       Task* task,
       base::WaitableEvent* done_event);
   void InitOnSessionThread(const FilePath& browser_dir, bool* success);
   void TerminateOnSessionThread();
@@ skipping 11 matching lines @@
                                     const WebElementId& element,
                                     const gfx::Rect& region,
                                     gfx::Point* location);
 
   const std::string id_;
 
   scoped_ptr<Automation> automation_;
   base::Thread thread_;
 
   int implicit_wait_;
+  bool screenshot_on_error_;
   Speed speed_;
 
   FrameId current_target_;
 
   DISALLOW_COPY_AND_ASSIGN(Session);
 };
 
 }  // namespace webdriver
 
 DISABLE_RUNNABLE_METHOD_REFCOUNT(webdriver::Session);
 
 #endif  // CHROME_TEST_WEBDRIVER_SESSION_H_