test: restrict example/env to Cypress <15.10

[MikeMcC399]

PREREQUISITE FOR CYPRESS 16 UPGRADE

• relates to issue Cypress.env deprecation / cy.env addition #1620

Situation

• The example directory examples/env uses the Cypress.env() API call to get environment variables in tests. These are non-secret environment variables. The related workflow example-env.yml refers to this usage in comments.

• In cypress@15.10.0

  • Cypress.env() was deprecated
  • the configuration option allowCypressEnv was introduced for the remaining lifetime of Cypress 15.x to enable explicitly disallowing Cypress.env()
  • cy.env() was added for sensitive configuration information
  • Cypress Module API option env corresponding to the action parameter env is now specified for use with secret environment variables
  • Cypress.expose() was added for non-sensitive configuration information

• In cypress-io/github-action@7.3.0

  • The action expose parameter was added to be able to pass this to the Cypress Module API
  • examples/expose and .github/workflows/example-expose.yml were added to demonstrate the use of Cypress.expose()

• In cypress@16.0.0

  • Cypress.env() was removed
  • allowCypressEnv was removed

Assessment

The env examples are still relevant for action users that have not upgraded to minimum Cypress 15.10. They are however incompatible with Cypress 16 and block upgrading the repo.

env continues to be available for GitHub Actions workflows for both secret and non-secret variables. Preserving various examples using env is therefore helpful for understanding how to use variables.

Change

Skip the tests in examples/env for Cypress >=15.10.0

Update code inline comments and documentation accordingly.

Verification

cd examples/env
npm install cypress@15.9.0
export CYPRESS_environmentName=staging CYPRESS_apiPort=4222 CYPRESS_host=http://api.dev.local
npm test
npm install cypress@15.10.0
npm test
npm install cypress@15
npm test
npm install cypress@16
npm test

Confirm that each test is successful.

---

Note

Low Risk
Documentation and example-test gating only; no changes to the GitHub Action runtime behavior.

Overview
Prepares the repo for a Cypress 16 upgrade by keeping the legacy examples/env workflow and tests while avoiding failures where Cypress.env() is deprecated (15.10+) or removed (16+).

examples/env e2e specs now use semver to run the existing Cypress.env() assertions only on Cypress <15.10.0; on newer versions they register a no-op skip test instead. semver is added as a devDependency in that example package.

Docs and CI comments are updated to state that Cypress.env() is legacy, point readers to example-expose.yml for non-sensitive config on 15.10+, and clarify in README that the action env input is for older Cypress and for secrets on 15.10+, with expose for public values.

^{Reviewed by Cursor Bugbot for commit 3962636. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cypress-app-bot]

• Create a Draft Pull Request if your PR is not ready for review. Mark the PR as Ready for Review when you're ready for a Cypress team member to review the PR.