mirror of
https://github.com/mozilla/gecko-dev.git
synced 2025-11-08 20:28:42 +02:00
1ddbbd48c5
--HG-- rename : testing/web-platform/tests/content-security-policy/blink-contrib/combine-multiple-policies.sub.html.sub.headers => testing/web-platform/tests/content-security-policy/blink-contrib/combine-header-and-meta-policies.sub.html.sub.headers rename : testing/web-platform/tests/content-security-policy/blink-contrib/resources/shared-worker-make-xhr-blocked.js.sub.headers => testing/web-platform/tests/content-security-policy/blink-contrib/resources/shared-worker-make-xhr-blocked.sub.js.sub.headers rename : testing/web-platform/tests/content-security-policy/blink-contrib/resources/worker-make-xhr-blocked.js.sub.headers => testing/web-platform/tests/content-security-policy/blink-contrib/resources/worker-make-xhr-blocked.sub.js.sub.headers rename : testing/web-platform/tests/quirks-mode/font-element-text-decoration-color/001-a.html => testing/web-platform/tests/html/rendering/non-replaced-elements/phrasing-content-0/font-element-text-decoration-color/001-a.html rename : testing/web-platform/tests/quirks-mode/font-element-text-decoration-color/001-q.html => testing/web-platform/tests/html/rendering/non-replaced-elements/phrasing-content-0/font-element-text-decoration-color/001-q.html rename : testing/web-platform/tests/quirks-mode/font-element-text-decoration-color/001-ref.html => testing/web-platform/tests/html/rendering/non-replaced-elements/phrasing-content-0/font-element-text-decoration-color/001-ref.html rename : testing/web-platform/tests/quirks-mode/font-element-text-decoration-color/001-s.html => testing/web-platform/tests/html/rendering/non-replaced-elements/phrasing-content-0/font-element-text-decoration-color/001-s.html rename : testing/web-platform/tests/quirks-mode/font-element-text-decoration-color/001-x.xhtml => testing/web-platform/tests/html/rendering/non-replaced-elements/phrasing-content-0/font-element-text-decoration-color/001-x.xhtml
77 lines
2.6 KiB
Markdown
77 lines
2.6 KiB
Markdown
CSS tests require a specific naming convention. This is also a good,
|
|
but not mandatory, style to use for other tests.
|
|
|
|
## File Name
|
|
|
|
The file name format is ```test-topic-###.ext``` where `test-topic`
|
|
somewhat describes the test, `###` is a zero-filled number used to
|
|
keep the file names unique, and `ext` is typically either
|
|
`html` or `xht`.
|
|
|
|
Test filenames must also be globally unique. There cannot be multiple
|
|
tests with the same filename, even if they are in different parent
|
|
directories. For example, having both
|
|
`/css-values-3/foo-001.html` and `/css-variables-1/foo-001.html`
|
|
would not be allowed. This restriction is in place because some tools
|
|
that use the CSS tests dump all of the test files into a single
|
|
directory, which would cause all but one of the tests with the same
|
|
filename to be clobbered and accidentally skipped.
|
|
|
|
### test-topic
|
|
|
|
`test-topic` is a short identifier that describes the test. The
|
|
`test-topic` should avoid conjunctions, articles, and prepositions.
|
|
It is a file name, not an English phrase: it should be as concise
|
|
as possible.
|
|
|
|
Examples:
|
|
```
|
|
margin-collapsing-###.ext
|
|
border-solid-###.ext
|
|
float-clear-###.ext
|
|
```
|
|
|
|
### `###`
|
|
|
|
`###` is a zero-filled number used to keep the file names unique when
|
|
files have the same test-topic name.
|
|
|
|
Note: The number format is limited to 999 cases. If you go over this
|
|
number it is recommended that you reevaluate your test-topic name.
|
|
|
|
For example, in the case of margin-collapsing there are multiple
|
|
cases so each case could have the same test-topic but different
|
|
numbers:
|
|
|
|
```
|
|
margin-collapsing-001.xht
|
|
margin-collapsing-002.xht
|
|
margin-collapsing-003.xht
|
|
```
|
|
|
|
There may also be a letter affixed after the number, which can be
|
|
used to indicate variants of a test.
|
|
|
|
For example, ```float-wrap-001l.xht``` and ```float-wrap-001r.xht```
|
|
might be left and right variants of a float test.
|
|
|
|
If tests using both the unsuffixed number and the suffixed number
|
|
exist, the suffixed tests must be subsets of the unsuffixed test.
|
|
|
|
For example, if ```bidi-004``` and ```bidi-004a``` both exist,
|
|
```bidi-004a``` must be a subset of ```bidi-004```.
|
|
|
|
If the unsuffixed test is strictly the union of the suffixed tests,
|
|
i.e. covers all aspects of the suffixed tests (such that a user agent
|
|
passing the unsuffixed test will, by design, pass all the suffixed
|
|
tests), then the unsuffixed test should be marked with the combo flag.
|
|
|
|
If ```bidi-004a``` and ```bidi-004b``` cover all aspects of ```bidi-
|
|
004``` (except their interaction), then bidi-004 should be given the
|
|
combo flag.
|
|
|
|
### ext
|
|
|
|
`ext` is the file extension or format of the file.
|
|
For XHTML test files, it should be `xht`.
|
|
For HTML (non-XML) test files, it should be `html`.
|