OLD | NEW |
1 # web-platform-tests | 1 # web-platform-tests |
2 | 2 |
3 Interoperability between browsers is | 3 Interoperability between browsers is |
4 [critical](https://www.chromium.org/blink/platform-predictability) to Chromium's | 4 [critical](https://www.chromium.org/blink/platform-predictability) to Chromium's |
5 mission of improving the web. We believe that leveraging and contributing to a | 5 mission of improving the web. We believe that leveraging and contributing to a |
6 shared test suite is one of the most important tools in achieving | 6 shared test suite is one of the most important tools in achieving |
7 interoperability between browsers. The [web-platform-tests | 7 interoperability between browsers. The [web-platform-tests |
8 repository](https://github.com/w3c/web-platform-tests) is the primary shared | 8 repository](https://github.com/w3c/web-platform-tests) is the primary shared |
9 test suite where all browser engines are collaborating. | 9 test suite where all browser engines are collaborating. |
10 | 10 |
11 Chromium has a 2-way import/export process with the upstream web-platform-tests | 11 Chromium has a 2-way import/export process with the upstream web-platform-tests |
12 repository, where tests are imported into | 12 repository, where tests are imported into |
13 [LayoutTests/external/wpt](../../third_party/WebKit/LayoutTests/external/wpt) | 13 [LayoutTests/external/wpt](../../third_party/WebKit/LayoutTests/external/wpt) |
14 and any changes to the imported tests are also exported to web-platform-tests. | 14 and any changes to the imported tests are also exported to web-platform-tests. |
15 | 15 |
16 See http://web-platform-tests.org/ for general documentation on | 16 See http://web-platform-tests.org/ for general documentation on |
17 web-platform-tests, including tips for writing and reviewing tests. | 17 web-platform-tests, including tips for writing and reviewing tests. |
18 | 18 |
19 [TOC] | 19 [TOC] |
20 | 20 |
21 ## Importing tests | 21 ## Importing tests |
22 | 22 |
23 Chromium has a mirror | 23 Chromium has a mirror |
24 ([web-platform-tests](https://chromium.googlesource.com/external/w3c/web-platfor
m-tests/) | 24 ([web-platform-tests](https://chromium.googlesource.com/external/w3c/web-platfor
m-tests/) |
25 of the | 25 of the |
26 GitHub repos, and periodically imports a subset of the tests so that they are | 26 GitHub repos, and periodically imports a subset of the tests so that they are |
27 run as part of the regular Blink layout test testing process. | 27 run as part of the regular Blink layout test testing process. |
28 | 28 |
29 The goal of this process are to be able to run web-platform-tests unmodified | 29 The goals of this process are to be able to run web-platform-tests unmodified |
30 locally just as easily as we can run the Blink tests, and ensure that we are | 30 locally just as easily as we can run the Blink tests, and ensure that we are |
31 tracking tip-of-tree in the web-platform-tests repository as closely as | 31 tracking tip-of-tree in the web-platform-tests repository as closely as |
32 possible, and running as many of the tests as possible. | 32 possible, and running as many of the tests as possible. |
33 | 33 |
34 ### Automatic import process | 34 ### Automatic import process |
35 | 35 |
36 There is an automatic process for updating the Chromium copy of | 36 There is an automatic process for updating the Chromium copy of |
37 web-platform-tests. The import is done by the builder [wpt-importer | 37 web-platform-tests. The import is done by the builder [wpt-importer |
38 builder](https://build.chromium.org/p/chromium.infra.cron/builders/wpt-importer)
. | 38 builder](https://build.chromium.org/p/chromium.infra.cron/builders/wpt-importer)
. |
39 | 39 |
(...skipping 136 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
176 that will be automatically upstreamed. There will be no additional review in | 176 that will be automatically upstreamed. There will be no additional review in |
177 web-platform-tests as part of the export process. | 177 web-platform-tests as part of the export process. |
178 | 178 |
179 If upstream reviewers have feedback on the changes, discuss on the pull request | 179 If upstream reviewers have feedback on the changes, discuss on the pull request |
180 created during export, and if necessary work on a new pull request to iterate | 180 created during export, and if necessary work on a new pull request to iterate |
181 until everyone is satisfied. | 181 until everyone is satisfied. |
182 | 182 |
183 When reviewing tests, check that they match the relevant specification, which | 183 When reviewing tests, check that they match the relevant specification, which |
184 may not fully match the implementation. See also | 184 may not fully match the implementation. See also |
185 [Write tests against specifications](#Write-tests-against-specifications). | 185 [Write tests against specifications](#Write-tests-against-specifications). |
OLD | NEW |