Skip to content

Commit ebc9511

Browse files
authored
Merge branch 'main' into update/docker-example-versions
2 parents 59cd6bc + 29c46c7 commit ebc9511

File tree

2 files changed

+15
-5
lines changed

2 files changed

+15
-5
lines changed

docs/app/get-started/install-cypress.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ Cypress requires [Node.js](https://nodejs.org/) in order to install. We support
117117

118118
Cypress generally aligns with
119119
[Node's release schedule](https://github.com/nodejs/Release).
120+
Accordingly, use of Node.js 18 with Cypress is deprecated and support is planned for removal in a future release of Cypress.
120121

121122
#### Installing Node.js
122123

docs/app/references/error-messages.mdx

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -610,6 +610,9 @@ if you've exhausted all other possibilities.
610610

611611
## CLI Errors
612612

613+
Errors in this section may occur when using the [Cypress command line (CLI)](/app/references/command-line).
614+
They may also apply to running Cypress programmatically through the [Cypress Module API](/app/references/module-api).
615+
613616
### <Icon name="exclamation-triangle" color="red" /> You passed the `--record` flag but did not provide us your Record Key.
614617

615618
You may receive this error when trying to run Cypress tests in
@@ -659,12 +662,18 @@ We will automatically apply the record key environment variable.
659662

660663
### <Icon name="exclamation-triangle" color="red" /> A Cached Cypress Binary Could not be found
661664

662-
This error occurs in CI when using `cypress run` without a valid Cypress binary
663-
cache installed on the system (on linux that's `~/.cache/Cypress`).
665+
This error occurs in CI when attempting to use `cypress run` or `cypress verify` CLI commands
666+
without having a valid Cypress binary cache installed on the system.
667+
668+
The Cypress binary is downloaded and installed into a [global cache folder](/app/references/advanced-installation#Binary-cache)
669+
with a package manager install command (such as `npm ci`, `npm install`, `yarn install` or `pnpm install`).
670+
The Cypress cache can also be loaded from a CI cache that was saved from a previous CI run.
671+
672+
If you are using pnpm, ensure you are following the [pnpm configuration](/app/get-started/install-cypress#pnpm-Configuration)
673+
instructions, otherwise pnpm may skip the Cypress binary installation.
664674

665-
To fix this error, follow instructions on
666-
[caching the cypress binary in CI](/app/continuous-integration/overview#Caching),
667-
then bump the version of your CI cache to ensure a clean build.
675+
If you are using CI caches, then review also the recommendations for
676+
[caching the Cypress binary in CI](/app/continuous-integration/overview#Caching).
668677

669678
### <Icon name="exclamation-triangle" color="red" /> Incorrect usage of `--ci-build-id` flag
670679

0 commit comments

Comments
 (0)