Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Commit b5b84c9

Browse files
MoLowaduh95
authored andcommitted
doc: add scope overview tables for TestsStream events
Summarize all TestsStream events in three tables by scope (test, file, and global), pairing declaration ordered (buffered) test scoped events with their execution ordered (immediate) equivalents. Signed-off-by: Moshe Atlow <moshe@atlow.co.il> PR-URL: #64386 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Ulises GascΓ³n <ulisesgascongonzalez@gmail.com>
1 parent d4dfb66 commit b5b84c9

1 file changed

Lines changed: 54 additions & 0 deletions

File tree

β€Ždoc/api/test.mdβ€Ž

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3454,6 +3454,45 @@ object, streaming a series of events representing the execution of the tests.
34543454
Some of the events are guaranteed to be emitted in the same order as the tests
34553455
are defined, while others are emitted in the order that the tests execute.
34563456

3457+
The following tables summarize all events by scope.
3458+
3459+
Test scoped events are emitted once per test or suite. Most of them come in
3460+
pairs: a declaration ordered event, buffered so that events are emitted in the
3461+
same order as the tests are defined, and one or more corresponding execution
3462+
ordered events, emitted immediately as the tests execute.
3463+
3464+
| Declaration ordered (buffered) | Execution ordered (immediate) |
3465+
| ------------------------------ | ----------------------------------------------------- |
3466+
|[`'test:start'`][]|[`'test:enqueue'`][] followed by [`'test:dequeue'`][]|
3467+
|[`'test:pass'`][]|[`'test:complete'`][] (`details.passed` is `true`) |
3468+
|[`'test:fail'`][]|[`'test:complete'`][] (`details.passed` is `false`) |
3469+
|[`'test:plan'`][]||
3470+
|[`'test:diagnostic'`][]||
3471+
3472+
File scoped and global events are always emitted immediately, in execution
3473+
order.
3474+
3475+
File scoped events are emitted once per test file:
3476+
3477+
| Event | Notes |
3478+
| -------------------- | ---------------------------------------------- |
3479+
|[`'test:stderr'`][]| Only emitted if the `--test` flag is passed. |
3480+
|[`'test:stdout'`][]| Only emitted if the `--test` flag is passed. |
3481+
|[`'test:summary'`][]| Per file, only when process isolation is used. |
3482+
3483+
Global events are emitted once per test run:
3484+
3485+
| Event | Notes |
3486+
| ---------------------------- | ------------------------------------ |
3487+
|[`'test:summary'`][]| The final cumulative summary. |
3488+
|[`'test:coverage'`][]| Only when code coverage is enabled. |
3489+
|[`'test:interrupted'`][]| Only when the run receives `SIGINT`. |
3490+
|[`'test:watch:drained'`][]| Watch mode only. |
3491+
|[`'test:watch:restarted'`][]| Watch mode only. |
3492+
3493+
The root test also emits [`'test:plan'`][] and [`'test:diagnostic'`][] events
3494+
at the end of the run to report run level totals.
3495+
34573496
### Event: `'test:coverage'`
34583497

34593498
*`data` {Object}
@@ -4702,6 +4741,21 @@ test.describe('my suite', (suite) => {
47024741

47034742
[TAP]: https://testanything.org/
47044743
[Test tags]: #test-tags
4744+
[`'test:complete'`]: #event-testcomplete
4745+
[`'test:coverage'`]: #event-testcoverage
4746+
[`'test:dequeue'`]: #event-testdequeue
4747+
[`'test:diagnostic'`]: #event-testdiagnostic
4748+
[`'test:enqueue'`]: #event-testenqueue
4749+
[`'test:fail'`]: #event-testfail
4750+
[`'test:interrupted'`]: #event-testinterrupted
4751+
[`'test:pass'`]: #event-testpass
4752+
[`'test:plan'`]: #event-testplan
4753+
[`'test:start'`]: #event-teststart
4754+
[`'test:stderr'`]: #event-teststderr
4755+
[`'test:stdout'`]: #event-teststdout
4756+
[`'test:summary'`]: #event-testsummary
4757+
[`'test:watch:drained'`]: #event-testwatchdrained
4758+
[`'test:watch:restarted'`]: #event-testwatchrestarted
47054759
[`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
47064760
[`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
47074761
[`--experimental-test-tag-filter`]: cli.md#--experimental-test-tag-filtertag

0 commit comments

Comments
Β (0)