tyler.durden/test262
1
0
Fork 0
mirror of https://github.com/tc39/test262.git synced 2025-06-20 14:00:29 +02:00
Code Issues Packages Projects Releases Wiki Activity

fixup! Document rationale for some maintenance practices

Browse Source
This commit is contained in:
Mike Pennisi 2022-04-01 17:37:27 -04:00 committed by Philip Chimento
parent f59823860e
commit 97477ad1f6
1 changed files with 10 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/rationale.md
View File

@ -95,7 +95,9 @@ for the "harness" files which Test262 maintains to assist in test writing.
Directories are not generally applied beyond these limits; further Directories are not generally applied beyond these limits; further
differentiation is instead achieved through structured file names which follow differentiation is instead achieved through structured file names which follow
ad-hoc conventions. This organization balances the need to group tests ad-hoc conventions. This organization balances the need to group tests
logically with the need to discover tests. logically with the need to discover tests. See, for example, [the tests for
template
literals](https://github.com/tc39/test262/tree/main/test/language/expressions/template-literal).
Many consumers use file names as a way to compare test results across revisions Many consumers use file names as a way to compare test results across revisions
and between implementations. For this reason, tests files are rarely and between implementations. For this reason, tests files are rarely
@ -112,6 +114,13 @@ qualities. Because Test262 is not maintained as a repository of regression
tests, contributions which include these kinds of tests will be weighed against tests, contributions which include these kinds of tests will be weighed against
their likelihood of identifying error in a plurality of implementations. their likelihood of identifying error in a plurality of implementations.
For example, assume that some runtime spuriously accesses the `toJSON` property
of the value passed to
[`String.prototype.repeat`](https://tc39.es/ecma262/#sec-string.prototype.repeat).
While the maintainers of the engine may decide to include a regression test
which disallows that behavior in their project, the maintainers of Test262
would not necessarily accept such a test.
## Large tests ## Large tests
Test262 tests are typically very focused. The vast majority exercise just one Test262 tests are typically very focused. The vast majority exercise just one