1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
// 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>
#include "base/memory/ref_counted.h"
#include "base/memory/scoped_ptr.h"
#include "base/task.h"
#include "chrome/common/automation_constants.h"
#include "ui/base/keycodes/keyboard_codes.h"
class AutomationProxy;
class DictionaryValue;
class FilePath;
class GURL;
class ListValue;
class ProxyLauncher;
struct WebKeyEvent;
namespace gfx {
class Point;
}
namespace webdriver {
class FramePath;
// Creates and controls the Chrome instance.
// This class should be created and accessed on a single thread.
// Note: All member functions are void because they are invoked
// by posting a task from NewRunnableMethod.
class Automation {
public:
Automation();
virtual ~Automation();
// Creates a browser, using the exe found in |browser_dir|. If |browser_dir|
// is empty, it will search in all the default locations.
void Init(const FilePath& browser_dir, bool* success);
// Terminates this session and disconnects its automation proxy. After
// invoking this method, the Automation can safely be deleted.
void Terminate();
// Executes the given |script| in the specified frame of the current
// tab. |result| will be set to the JSON result. Returns true on success.
void ExecuteScript(int tab_id,
const FramePath& frame_path,
const std::string& script,
std::string* result,
bool* success);
// Sends a webkit 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);
// Sends an OS level key event to the current browser. Waits until the key
// has been processed by the browser.
void SendNativeKeyEvent(int tab_id,
ui::KeyboardCode key_code,
int modifiers,
bool* success);
// Captures a snapshot of the tab to the specified path. 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 GetCookies(const std::string& url, ListValue** cookies, bool* success);
void GetCookiesDeprecated(
int tab_id, const GURL& gurl, std::string* cookies, bool* success);
void DeleteCookie(const std::string& url,
const std::string& cookie_name,
bool* success);
void DeleteCookieDeprecated(int tab_id,
const GURL& gurl,
const std::string& cookie_name,
bool* success);
void SetCookie(
const std::string& url, DictionaryValue* cookie_dict, bool* success);
void SetCookieDeprecated(
int tab_id, const GURL& gurl, const std::string& cookie, bool* success);
void MouseMove(int tab_id, const gfx::Point& p, bool* success);
void MouseClick(int tab_id,
const gfx::Point& p,
automation::MouseButton button,
bool* success);
void MouseDrag(int tab_id,
const gfx::Point& start,
const gfx::Point& end,
bool* success);
// Get persistent IDs for all the tabs currently open. These IDs can be used
// to identify the tab as long as the tab exists.
void GetTabIds(std::vector<int>* tab_ids, bool* success);
// Check if the given tab exists currently.
void DoesTabExist(int tab_id, bool* does_exist, bool* success);
void CloseTab(int tab_id, bool* success);
// Gets the version of the runing browser.
void GetBrowserVersion(std::string* version);
// Waits for all tabs to stop loading.
void WaitForAllTabsToStopLoading(bool* success);
private:
AutomationProxy* automation() const;
bool GetIndicesForTab(int tab_id, int* browser_index, int* tab_index);
scoped_ptr<ProxyLauncher> launcher_;
DISALLOW_COPY_AND_ASSIGN(Automation);
};
} // namespace webdriver
DISABLE_RUNNABLE_METHOD_REFCOUNT(webdriver::Automation);
#endif // CHROME_TEST_WEBDRIVER_AUTOMATION_H_
|
