Skip to content

Commit a6f7a4b

Browse files
committed
Add information on Importing Web Platform Tests
This patch adds information on how to handle the most common scenarios when importing Web Platform Tests.
1 parent b968840 commit a6f7a4b

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

docs/Infrastructure/ImportWPTTests.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Import Web Platform Tests
2+
3+
WebKit maintains a separate fork of the Web Platform Tests living in `‌LayoutTests/imported/w3c/web-platform-tests`. When changes are made upstream we need to import them to stay up to date.
4+
5+
## Importing Tests from WPT
6+
7+
```
8+
Tools/Scripts/import-w3c-tests -t web-platform-tests/folder_to_import_here
9+
```
10+
11+
When running the script above the latest WPT will be downloaded into WebKitBuild directory. The requested files will be copied over into the WebKit WPT directory.
12+
13+
After importing the tests ensure to run `run-webkit-tests` to generate new expectations. You may need to update the `LayoutTests/TestExpectations` which need to be marked `SKIP` based on `import-w3c-tests` output.
14+
15+
## Import WPT Tests from a local checkout of WPT
16+
17+
If you have the upstream WPT repository locally you can skip redownloading it by running the following below.
18+
19+
```
20+
Tools/Scripts/import-w3c-tests web-platorm-tests/folder_to_import_here -l -s path_to_web_platform_tests
21+
```

0 commit comments

Comments
 (0)