Bug 1499936 [wpt PR 13586] - Add a `.optional.` file name flag for optional behavior, a=testonly
authorPhilip Jägenstedt <philip@foolip.org>
Thu, 01 Nov 2018 11:20:00 +0000
changeset 501400 6189a04483f16fc70a1975baba24c7df1efaa8bc
parent 501399 74ac4fe9e8cf9082e60a53ab1fcd3d5cceb552d9
child 501401 dde035ec02348a4721070c77b07e339b288b3636
push id10290
push userffxbld-merge
push dateMon, 03 Dec 2018 16:23:23 +0000
treeherdermozilla-beta@700bed2445e6 [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewerstestonly
bugs1499936, 13586
milestone65.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1499936 [wpt PR 13586] - Add a `.optional.` file name flag for optional behavior, a=testonly Automatic update from web-platform-testsAdd a `.optional.` file name flag for optional behavior (#13586) -- wpt-commits: 80dce24781817a9091b3ed5094dbd2b58386d152 wpt-pr: 13586
testing/web-platform/tests/docs/_writing-tests/file-names.md
--- a/testing/web-platform/tests/docs/_writing-tests/file-names.md
+++ b/testing/web-platform/tests/docs/_writing-tests/file-names.md
@@ -49,18 +49,25 @@ themselves precede any test type flag, b
 `.worker`
  : (js files only) Indicates that the file generates a test in which
     it is run in a dedicated worker environment.
 
 `.any`
  : (js files only) Indicates that the file generates tests in which it
     is [run in multiple scopes][multi-global-tests].
 
+`.optional`
+ : Indicates that a test makes assertions about optional behavior in a
+   specification, typically marked by the [RFC 2119] "MAY" or "OPTIONAL"
+   keywords. This flag should not be used for "SHOULD"; such requirements
+   can be tested with regular tests, like "MUST".
+
 `.tentative`
  : Indicates that a test makes assertions not yet required by any specification,
    or in contradiction to some specification. This is useful when implementation
    experience is needed to inform the specification. It should be apparent in
    context why the test is tentative and what needs to be resolved to make it
    non-tentative.
 
 
 [server-side substitution]: https://wptserve.readthedocs.io/en/latest/pipes.html#sub
 [multi-global-tests]: {{ site.baseurl }}{% link _writing-tests/testharness.md %}#multi-global-tests
+[RFC 2119]: https://tools.ietf.org/html/rfc2119