You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/app/references/changelog.mdx
+23Lines changed: 23 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,29 @@ sidebar_label: Changelog
8
8
9
9
# Changelog
10
10
11
+
## 15.5.0
12
+
13
+
_Released 10/17/2025_
14
+
15
+
**Features:**
16
+
17
+
- When `cypress run` is used with both `--record` and `--posix-exit-codes` enabled, Cypress will now exit with code `112` when it cannot determine which spec to run next due to network conditions. Addresses [#32485](https://github.com/cypress-io/cypress/issues/32485). Addressed in [#32635](https://github.com/cypress-io/cypress/pull/32635).
18
+
19
+
**Bugfixes:**
20
+
21
+
- An error is no longer thrown during command execution when the application under test overwrites the `window.$` property with a non-function. Fixes [#1502](https://github.com/cypress-io/cypress/issues/1502). Fixed in [#32682](https://github.com/cypress-io/cypress/pull/32682).
22
+
- When running `cypress` in Cypress development environments, or when `ELECTRON_ENABLE_LOGGING` is otherwise set to 1, certain messages written to `stderr` will no longer be bracketed with verbose tags. Addresses [#32569](https://github.com/cypress-io/cypress/issues/32569). Addressed in [#32674](https://github.com/cypress-io/cypress/pull/32674).
23
+
- Improve performance of time between specs by not resetting the `file_systems` `StorageType` state when executing the CDP command `Storage.clearDataForOrigin`. Fixed in [#32703](https://github.com/cypress-io/cypress/pull/32703).
24
+
25
+
**Misc:**
26
+
27
+
- Browser detection in Cypress now always prefers 64-bit browser installs to 32-bit browser installs. Addressed in [#32656](https://github.com/cypress-io/cypress/pull/32656).
28
+
- Update code button styles and rename Get Code for Code on cy.prompt. Addressed in [#32745](https://github.com/cypress-io/cypress/pull/32745).
29
+
30
+
**Dependency Updates:**
31
+
32
+
- Upgraded `tsx` from `4.20.5` to `4.20.6`. Addressed in [#32730](https://github.com/cypress-io/cypress/pull/32730).
Copy file name to clipboardExpand all lines: docs/app/references/command-line.mdx
+20-70Lines changed: 20 additions & 70 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -442,14 +442,12 @@ cypress run --port 8080
442
442
443
443
#### `cypress run --posix-exit-codes` {#cypress-run-posix-exit-codes}
444
444
445
-
This changes the default behavior of Cypress regarding exit codes. This flag causes Cypress to exit with POSIX exit code of 1 when there are test failures or if Cypress could not run, rather than the number of tests that failed.
445
+
This changes the default behavior of Cypress regarding exit codes. This flag causes Cypress to exit with POSIX exit code of 1 when there are test failures or if Cypress could not run, rather than the number of tests that failed. It can return additional POSIX-compliant exit codes for other scenarios as well. See the [Exit Code section](/app/references/command-line#Exit-code) for a comprehensive reference of Cypress exit codes.
446
446
447
447
```shell
448
448
cypress run --posix-exit-codes
449
449
```
450
450
451
-
For more about Cypress'exit code behavior, see the [Exit Code section](/app/references/command-line#Exit-code).
452
-
453
451
#### `cypress run --project <project-path>` {#cypress-run-project-lt-project-path-gt}
454
452
455
453
To see this in action we've set up an
@@ -598,69 +596,20 @@ Cypress Cloud will display any tags sent with the appropriate run.
598
596
599
597
#### Exit code
600
598
601
-
When Cypress finishes running tests, it exits. If there are no failed tests, the
602
-
exit code will be 0.
603
-
604
-
```text
605
-
## All tests pass
606
-
$ cypress run
607
-
...
608
-
Tests Passing Failing
609
-
✔ All specs passed! 00:16 17 17 0
610
-
611
-
## print exit code on Mac or Linux
612
-
$ echo $?
613
-
0
614
-
```
615
-
616
-
By default, if there are any test failures, then the exit code will match the number of
617
-
tests that failed.
618
-
619
-
```text
620
-
## Spec with two failing tests
621
-
$ cypress run
622
-
...
623
-
Tests Passing Failing
624
-
✖ 1 of 1 failed (100%) 00:22 17 14 2
625
-
626
-
## print exit code on Mac or Linux
627
-
$ echo$?
628
-
2
629
-
```
599
+
Cypress supports two different exit code behaviors. The default behavior is similar to that of Mocha, but is not POSIX compliant: reserved exit codes can be returned for certain conditions. As well, the default behavior
600
+
can return a false negative when there are a number of tests that fail in multiples of 256: most terminals will apply modulo 256 to any exit code larger than 255.
630
601
631
-
You can change this behavior by passing the `--posix-exit-codes` flag. When this flag is passed,
632
-
the exit code will be 0 if all tests pass. If there are any test failures or if Cypress could not run,
633
-
the exit code will be 1.
602
+
POSIX compliant exit codes are available via the `--posix-exit-codes` flag. When this flag is passed, additional conditions can be returned that are not possible with the default behavior, including when Cypress fails due to
603
+
network errors when connections to Cypress Cloud are required, such as in `--record` or `--parallel` runs.
634
604
635
-
```text
636
-
## Spec with two failing tests
637
-
$ cypress run
638
-
...
639
-
Tests Passing Failing
640
-
✖ 1 of 1 failed (100%) 00:22 17 14 2
605
+
When using POSIX compliant exit codes, the number of failed tests can be determined from the [Module API](/app/references/module-api) or [structured reporter data](/app/tooling/reporters).
641
606
642
-
## print exit code on Mac or Linux
643
-
$ echo$?
644
-
1
645
-
```
646
-
647
-
If Cypress could not run for some reason (for example if no spec files were
648
-
found) then the exit code will be 1.
649
-
650
-
```text
651
-
## No spec files found
652
-
$ cypress run --spec not-found.js
653
-
...
654
-
Can't run because no spec files were found.
655
-
656
-
We searched for any files matching this glob pattern:
0 commit comments