Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(264)

Side by Side Diff: docs/testing/writing_layout_tests.md

Issue 2695963002: Update web-platform-tests docs (Closed)
Patch Set: Created 3 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « docs/testing/web_platform_tests.md ('k') | docs/using_a_linux_chroot.md » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 # Writing Layout Tests 1 # Writing Layout Tests
2 2
3 _Layout tests_ is a bit of a misnomer. This term is 3 _Layout tests_ is a bit of a misnomer. This term is
4 [a part of our WebKit heritage](https://webkit.org/blog/1452/layout-tests-theory /), 4 [a part of our WebKit heritage](https://webkit.org/blog/1452/layout-tests-theory /),
5 and we use it to refer to every test that is written as a Web page (HTML, SVG, 5 and we use it to refer to every test that is written as a Web page (HTML, SVG,
6 or XHTML) and lives in 6 or XHTML) and lives in
7 [third_party/WebKit/LayoutTests/](../../third_party/WebKit/LayoutTests). 7 [third_party/WebKit/LayoutTests/](../../third_party/WebKit/LayoutTests).
8 8
9 [TOC] 9 [TOC]
10 10
(...skipping 194 matching lines...) Expand 10 before | Expand all | Expand 10 after
205 cost and benefits of having the tests 205 cost and benefits of having the tests
206 [gracefully degrade to manual tests](./layout_tests_with_manual_fallback.md) in 206 [gracefully degrade to manual tests](./layout_tests_with_manual_fallback.md) in
207 the absence of the testing APIs. 207 the absence of the testing APIs.
208 208
209 *** promo 209 *** promo
210 In many cases, the user gesture is not actually necessary. For example, many 210 In many cases, the user gesture is not actually necessary. For example, many
211 event handling tests can use 211 event handling tests can use
212 [synthetic events](https://developer.mozilla.org/docs/Web/Guide/Events/Creating_ and_triggering_events). 212 [synthetic events](https://developer.mozilla.org/docs/Web/Guide/Events/Creating_ and_triggering_events).
213 *** 213 ***
214 214
215 *** note
216 TODO: document wpt_automation. Manual tests might end up moving here.
217 ***
218
219 ### Relying on Blink-Specific Testing APIs 215 ### Relying on Blink-Specific Testing APIs
220 216
221 Tests that cannot be expressed using the Web Platform APIs or WPT's testing APIs 217 Tests that cannot be expressed using the Web Platform APIs or WPT's testing APIs
222 use Blink-specific testing APIs. These APIs are only available in 218 use Blink-specific testing APIs. These APIs are only available in
223 [content_shell](./layout_tests_in_content_shell.md), and should only be used as 219 [content_shell](./layout_tests_in_content_shell.md), and should only be used as
224 a last resort. 220 a last resort.
225 221
226 A downside of Blink-specific APIs is that they are not as well documented as the 222 A downside of Blink-specific APIs is that they are not as well documented as the
227 Web Platform features. Learning to use a Blink-specific feature requires finding 223 Web Platform features. Learning to use a Blink-specific feature requires finding
228 other tests that use it, or reading its source code. 224 other tests that use it, or reading its source code.
(...skipping 350 matching lines...) Expand 10 before | Expand all | Expand 10 after
579 * The `http/` directory hosts tests that require an HTTP server (see above). 575 * The `http/` directory hosts tests that require an HTTP server (see above).
580 * The `resources/` subdirectory in every directory contains binary files, such 576 * The `resources/` subdirectory in every directory contains binary files, such
581 as media files, and code that is shared by multiple test files. 577 as media files, and code that is shared by multiple test files.
582 578
583 *** note 579 *** note
584 Some layout tests consist of a minimal HTML page that references a JavaScript 580 Some layout tests consist of a minimal HTML page that references a JavaScript
585 file in `resources/`. Please do not use this pattern for new tests, as it goes 581 file in `resources/`. Please do not use this pattern for new tests, as it goes
586 against the minimality principle. JavaScript and CSS files should only live in 582 against the minimality principle. JavaScript and CSS files should only live in
587 `resources/` if they are shared by at least two test files. 583 `resources/` if they are shared by at least two test files.
588 *** 584 ***
OLDNEW
« no previous file with comments | « docs/testing/web_platform_tests.md ('k') | docs/using_a_linux_chroot.md » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698