AX: AXIsolatedTree::updateChildren sometimes fails to update isolated subtrees when...
[WebKit-https.git] / WebDriverTests / README.md
1 # WebDriver tests
2
3 ## Importing tests
4
5 There is the `import-webdriver-tests` script to automate most of the process of
6 checking out the repository and copying the files.
7
8 It reads the `importer.json` of the selected suite (selenium or w3c), which
9 contains the desired commit alongside the list of paths to skip/import.
10
11 The cloned repository sits in `WebKitBuild/` for easier inspection. For example,
12 to manually check the new commit to be imported.
13
14 Once chosen the new commit, update `importer.json` with its hash and
15 eventual path changes (e.g., new folders to be copied or skipped) and run the
16 import script to update the desired suite:
17
18 ```
19 ./Tools/Scripts/import-webdriver-tests --selenium`
20 ./Tools/Scripts/import-webdriver-tests --w3c`
21 ```
22
23 After running the script, if you're using git, you can check which files
24 were added with `git status WebDriverTests/` to add them to the new commit.
25 One current limitation of the script is its inability to check for deleted
26 files from the source repository, so this step is still manual.
27
28 Beware that when importing Selenium tests, some manual intervention might be
29 needed to remove unsupported code related to Firefox, Chrome, etc. For example:
30
31 * Package imports in `WebDriverTests/imported/selenium/py/selenium/webdriver/__init__.py`.
32 * `RemoteConnection` objects in `WebDriverTests/imported/selenium/py/selenium/webdriver/remote/webdriver.py`.
33
34
35 To test the imported suite, run it:
36
37 ```
38 Tools/Scripts/run-webdriver-tests --verbose --wpe --release --display-server=xvfb
39 ```