OLD | NEW |
---|---|
1 This file contains high-level info about how ChromeDriver works and how to | 1 This file contains high-level info about how ChromeDriver works and how to |
2 contribute. | 2 contribute. |
3 | 3 |
4 ChromeDriver is an implementation of the WebDriver standard, | 4 ChromeDriver is an implementation of the WebDriver standard, |
5 which allows users to automate testing of their website across browsers. | 5 which allows users to automate testing of their website across browsers. |
6 | 6 |
7 =====Getting started===== | 7 =====Getting started===== |
8 Build ChromeDriver by building the 'chromedriver2' target. This will create | 8 Build ChromeDriver by building the 'chromedriver2' target. This will create |
9 a shared library in the build folder named 'chromedriver2.dll' (win), | 9 a shared library in the build folder named 'chromedriver2.dll' (win), |
10 'chromedriver2.so' (mac), or 'libchromedriver2.so' (linux). | 10 'chromedriver2.so' (mac), or 'libchromedriver2.so' (linux). |
11 | 11 |
12 Once built, ChromeDriver can be used interactively with python. | 12 Once built, ChromeDriver can be used interactively with python. |
13 This can be easily done by running python in this directory (or including | 13 This can be easily done by running python in this directory (or including |
14 this directory in your PYTHONPATH). | 14 this directory in your PYTHONPATH). |
15 | 15 |
16 $ python | 16 $ python |
17 >>> import chromedriver | 17 >>> import chromedriver |
18 >>> driver = chromedriver.ChromeDriver('/path/to/chromedriver2/library') | 18 >>> driver = chromedriver.ChromeDriver('/path/to/chromedriver2/library') |
19 >>> driver.Load('http://www.google.com') | 19 >>> driver.Load('http://www.google.com') |
20 | 20 |
21 ChromeDriver will use the system installed Chrome by default. | 21 ChromeDriver will use the system installed Chrome by default. |
22 | 22 |
23 To use ChromeDriver2 with Chrome on Android pass the Android package name in the | |
24 chromeOptions.androidPackage capability when creating the driver. The path to | |
25 adb_commands.py must be set in PATH. For more detail instructions see the wiki: | |
frankf
2013/04/19 19:07:52
Also 'adb' needs to be in PATH.
| |
26 https://code.google.com/p/chromedriver/wiki/ChromeDriver2forAndroid | |
27 | |
23 =====Architecture===== | 28 =====Architecture===== |
24 ChromeDriver is shipped separately from Chrome. It controls Chrome out of | 29 ChromeDriver is shipped separately from Chrome. It controls Chrome out of |
25 process through DevTools (WebKit Inspector). ChromeDriver is a shared library | 30 process through DevTools (WebKit Inspector). ChromeDriver is a shared library |
26 which exports a few functions for executing WebDriver-standard commands, which | 31 which exports a few functions for executing WebDriver-standard commands, which |
27 are packaged in JSON. For internal use, a custom python client for ChromeDriver | 32 are packaged in JSON. For internal use, a custom python client for ChromeDriver |
28 is available in chromedriver.py, which works on desktop (win/mac/linux) with | 33 is available in chromedriver.py, which works on desktop (win/mac/linux) with |
29 the shared library ChromeDriver. | 34 the shared library ChromeDriver. |
30 | 35 |
31 The ChromeDriver shared library runs commands on the same thread that calls | 36 The ChromeDriver shared library runs commands on the same thread that calls |
32 ExecuteCommand. It doesn't create any additional threads except for the IO | 37 ExecuteCommand. It doesn't create any additional threads except for the IO |
(...skipping 48 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
81 4) WebDriver Java acceptance tests | 86 4) WebDriver Java acceptance tests |
82 These are integration tests from the WebDriver open source project which can | 87 These are integration tests from the WebDriver open source project which can |
83 be run via run_java_tests.py. They are also run on the chromium QA bots. | 88 be run via run_java_tests.py. They are also run on the chromium QA bots. |
84 See http://src.chromium.org/viewvc/chrome/trunk/deps/third_party/webdriver | 89 See http://src.chromium.org/viewvc/chrome/trunk/deps/third_party/webdriver |
85 | 90 |
86 =====Contributing===== | 91 =====Contributing===== |
87 Find an open issue and submit a patch for review by an individual listed in | 92 Find an open issue and submit a patch for review by an individual listed in |
88 the OWNERS file in this directory. Issues are tracked in chromedriver's issue | 93 the OWNERS file in this directory. Issues are tracked in chromedriver's issue |
89 tracker: | 94 tracker: |
90 https://code.google.com/p/chromedriver/issues/list | 95 https://code.google.com/p/chromedriver/issues/list |
OLD | NEW |