Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 Fetch API LayoutTests README | 1 Fetch API LayoutTests README |
| 2 | 2 |
| 3 This directory contains Fetch API layout tests. | 3 This directory contains Fetch API layout tests. |
| 4 Tests should conform to Service Worker Testing style[1]. | 4 Tests should conform to Service Worker Testing style[1]. |
| 5 | 5 |
| 6 1: http://www.chromium.org/blink/serviceworker/testing | 6 1: http://www.chromium.org/blink/serviceworker/testing |
| 7 | 7 |
| 8 # generator.py | 8 # generator.py |
| 9 | 9 |
| 10 The files under | 10 The files under |
| 11 - /fetch/window/ | 11 - /fetch/window/ |
| 12 - /fetch/workers/ | 12 - /fetch/workers/ |
| 13 - /fetch/serviceworker/ | 13 - /fetch/serviceworker/ |
| 14 - /fetch/serviceworker-proxied/ | 14 - /fetch/serviceworker-proxied/ |
| 15 are generated by the generator. | 15 are generated by the generator. |
| 16 Run | 16 Run |
| 17 $ python generate.py | 17 $ python generate.py |
| 18 at this (/LayoutTests/http/tests/fetch/) directory to generate these files | 18 at this (/LayoutTests/http/tests/fetch/) directory to generate these files |
| 19 from templates script-tests/TEMPLATE*.html. | 19 from templates script-tests/TEMPLATE*.html. |
| 20 | 20 |
| 21 There are two kinds of tests. One is regular tests placed on script_tests | |
|
hiroshige
2015/08/05 04:55:52
nit: s/script_tests/script-tests/
yhirano
2015/08/07 02:32:03
Done.
| |
| 22 directory and another is "thorough" tests placed on script_tests/thorough | |
|
hiroshige
2015/08/05 04:55:52
ditto.
yhirano
2015/08/07 02:32:03
Done.
| |
| 23 directory. Each has its own template files and default option settings. | |
|
hiroshige
2015/08/05 04:55:52
Mentioning that the old name of thorough tests was
yhirano
2015/08/07 02:32:03
Done.
| |
| 24 | |
| 21 # Running on window, workers, serviceworker, serviceworker-proxied | 25 # Running on window, workers, serviceworker, serviceworker-proxied |
| 22 | 26 |
| 23 As it is exposed to Window and Worker, most (if not all) of tests are expected | 27 As it is exposed to Window and Worker, most (if not all) of tests are expected |
| 24 to run on Window, DedicatedWorker and ServiceWorker. | 28 to run on Window, DedicatedWorker and ServiceWorker. |
| 25 For each test (say X), we have | 29 For each test (say X), we have |
| 26 - a script X.js in /fetch/script-tests, | 30 - a script X.js in /fetch/script-tests, |
| 27 - /fetch/window/X.html Window test file, | 31 - /fetch/window/X.html Window test file, |
| 28 - /fetch/workers/X.html Worker test file, and | 32 - /fetch/workers/X.html Worker test file, and |
| 29 - /fetch/serviceworker/X.html ServiceWorker test file. | 33 - /fetch/serviceworker/X.html ServiceWorker test file. |
| 30 | 34 |
| (...skipping 17 matching lines...) Expand all Loading... | |
| 48 ----------------------------- ----------------------- ----------- ------------ | 52 ----------------------------- ----------------------- ----------- ------------ |
| 49 | 53 |
| 50 X.js is common to all options. | 54 X.js is common to all options. |
| 51 The test switches by location.href at runtime. | 55 The test switches by location.href at runtime. |
| 52 | 56 |
| 53 The options to be generated is listed in a line in X.js like: | 57 The options to be generated is listed in a line in X.js like: |
| 54 // OPTIONS: ,-other-https,-base-https-other-https | 58 // OPTIONS: ,-other-https,-base-https-other-https |
| 55 (Three files for OPTIONS = (empty), -other-https, -base-https-other-https are | 59 (Three files for OPTIONS = (empty), -other-https, -base-https-other-https are |
| 56 generated) | 60 generated) |
| 57 Default: | 61 Default: |
| 58 For fetch-access-control*: ,-other-https,-base-https-other-https | 62 For thorough tests: ,-other-https,-base-https-other-https |
| 59 For others: ,-base-https-other-https | 63 For others: ,-base-https-other-https |
| 60 | 64 |
| 61 # File structure | 65 # File structure |
| 62 | 66 |
| 63 Helper JS files and server side scripts are located on | 67 Helper JS files and server side scripts are located on |
| 64 /fetch/resources and /serviceworker/resources: | 68 /fetch/resources and /serviceworker/resources: |
| 65 - /serviceworker/resources/test-helpers.js | 69 - /serviceworker/resources/test-helpers.js |
| 66 Utility functions for all tests. | 70 Utility functions for all tests. |
| 67 Include this before X.js and from HTML files. | 71 Include this before X.js and from HTML files. |
| 68 - /fetch/resources/fetch-test-options.js | 72 - /fetch/resources/fetch-test-options.js |
| 69 Process test options for X.js. BASE_ORIGIN/OTHER_ORIGIN are defined here. | 73 Process test options for X.js. BASE_ORIGIN/OTHER_ORIGIN are defined here. |
| 70 Include this before X.js and fetch-access-control-util.js. | 74 Include this before X.js and thorough-util.js. |
| 71 - /fetch/resources/fetch-test-helpers.js | 75 - /fetch/resources/fetch-test-helpers.js |
| 72 Variables/functions commonly used from X.js. | 76 Variables/functions commonly used from X.js. |
| 73 Include this before X.js. | 77 Include this before X.js. |
| 74 - /fetch/resources/fetch-access-control-util.js | 78 - /fetch/resources/thorough-util.js |
| 75 Utility functions for fetch-access-control* tests. | 79 Utility functions for thorough tests. |
| 76 Include this before X.js in fetch-access-control* tests. | 80 Include this before X.js in thorough tests. |
| 77 - /fetch/resources/init.js | 81 - /fetch/resources/init.js |
| 78 Initialization script executed on window. | 82 Initialization script executed on window. |
| 79 Include this from HTML files. | 83 Include this from HTML files. |
| 80 | 84 |
| 81 Files needed from HTML/X.js files for each tests: | 85 Files needed from HTML/X.js files for each tests: |
| 82 ----------------------------------------------------- ------------ ------------ | 86 ----------------------------------------------------- ------------ ------------ |
| 83 HTML X.js | 87 HTML X.js |
| 84 Files wi wo sw swp wi wo sw swp | 88 Files wi wo sw swp wi wo sw swp |
| 85 ----------------------------------------------------- -- -- -- --- -- -- -- --- | 89 ----------------------------------------------------- -- -- -- --- -- -- -- --- |
| 86 /serviceworker/resources/test-helpers.js Y Y Y Y . . . . | 90 /serviceworker/resources/test-helpers.js Y Y Y Y . . . . |
| 87 /fetch/resources/fetch-test-options.js Y - - Y . . . . | 91 /fetch/resources/fetch-test-options.js Y - - Y . . . . |
| 88 /fetch/resources/fetch-test-helpers.js Y - - Y . Y Y . | 92 /fetch/resources/fetch-test-helpers.js Y - - Y . Y Y . |
| 89 /fetch/resources/fetch-access-control-util.js Y* - - Y* . Y* Y* . | 93 /fetch/resources/thorough-util.js Y* - - Y* . Y* Y* . |
| 90 /fetch/script-tests/X.js Y - - Y | 94 /fetch/script-tests/X.js Y - - Y |
| 91 /fetch/resources/init.js Y Y Y Y - - - - | 95 /fetch/resources/init.js Y Y Y Y - - - - |
| 92 ----------------------------------------------------- ------------ ------------ | 96 ----------------------------------------------------- ------------ ------------ |
| 93 wi/wo/sw/swp: window/workers/serviceworker/serviceworker-proxied. | 97 wi/wo/sw/swp: window/workers/serviceworker/serviceworker-proxied. |
| 94 Y: to be included. | 98 Y: to be included. |
| 95 -: not to be included. | 99 -: not to be included. |
| 96 .: included indirectly via HTML or fetch-test-helpers.js. | 100 .: included indirectly via HTML or fetch-test-helpers.js. |
| 97 Y*: fetch-access-control* tests only. | 101 Y*: thorough tests only. |
| 98 | 102 |
| 99 # PRESUBMIT.py | 103 # PRESUBMIT.py |
| 100 | 104 |
| 101 FIXME: currently PRESUBMIT.py is somehow outdated and thus disabled. | 105 FIXME: currently PRESUBMIT.py is somehow outdated and thus disabled. |
| 102 | 106 |
| 103 PRESUBMIT.py checks the existence of the files. | 107 PRESUBMIT.py checks the existence of the files. |
| 104 For each file in /fetch/script-tests, the | 108 For each file in /fetch/script-tests, the |
| 105 corresponding html files must exist at the paths listed above. | 109 corresponding html files must exist at the paths listed above. |
| OLD | NEW |