@cypress/github-action 7.2.0 → 7.3.0

package/README.md

@@ -37,6 +37,7 @@ The following examples demonstrate the actions' functions.
   - using [headed mode](#headed)
 - Using [Docker image](#docker-image)
 - Specify [environment variables](#env)
+- Specify [expose variables](#expose)
 - Run only some [spec files](#specs)
 - Test [project in subfolder](#project)
 - [Record results](#record-test-results-on-cypress-cloud) on Cypress Cloud
@@ -358,6 +359,30 @@ For more examples, see the workflows below, using environment variables for [rec
 
 [![Env example](https://github.com/cypress-io/github-action/actions/workflows/example-env.yml/badge.svg)](.github/workflows/example-env.yml)
 
+### Expose
+
+Specify the expose argument with `expose` parameter. Expose variables are for non-sensitive, public config values that are synchronous and exposed to the browser (requires Cypress 15.10.0 or later).
+
+```yml
+name: Cypress tests
+on: push
+jobs:
+  cypress-run:
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Cypress run with expose
+        uses: cypress-io/github-action@v7
+        with:
+          expose: host=api.dev.local,port=4222
+```
+
+For more information, see [Cypress.expose()](https://docs.cypress.io/api/cypress-api/expose) in the Cypress documentation.
+
+[![Expose example](https://github.com/cypress-io/github-action/actions/workflows/example-expose.yml/badge.svg)](.github/workflows/example-expose.yml)
+
 ### Specs
 
 Specify the [spec files to run](https://docs.cypress.io/guides/guides/command-line.html#cypress-run-spec-lt-spec-gt) with `spec` parameter
@@ -1619,6 +1644,7 @@ jobs:
 | `--config-file`, `-C`          | [`config-file`](#config-file)                               | Specify configuration file                                                                           |
 | `--e2e`                        | [`component: false`](#component-testing) (default)          | Run end to end tests                                                                                 |
 | `--env`, `-e`                  | [`env`](#env)                                               | Specify environment variables                                                                        |
+| `--expose`, `-x`               | [`expose`](#expose)                                         | Specify expose variables for non-sensitive, public config values                                     |
 | `--group`                      | [`group`](#parallel)                                        | Group recorded tests together under a single run for Cloud recording                                 |
 | `--headed`                     | [`headed`](#headed)                                         | Display the browser instead of running headlessly                                                    |
 | `--headless`                   | [`headed: false`](#headed) (default)                        | Hide the browser instead of running headed                                                           |

package/action.yml

@@ -29,6 +29,9 @@ inputs:
   env:
     description: 'Sets Cypress environment variables'
     required: false
+  expose:
+    description: 'Sets Cypress expose variables for non-sensitive, public config values (requires Cypress 15.10.0 or later)'
+    required: false
   group:
     description: 'Group setting for recording tests'
     required: false

package/dist/index.js

@@ -102320,6 +102320,12 @@ const runTestsUsingCommandLine = async () => {
     cmd.push(envInput)
   }
 
+  const exposeInput = core.getInput('expose')
+  if (exposeInput) {
+    cmd.push('--expose')
+    cmd.push(exposeInput)
+  }
+
   const quiet = getInputBool('quiet')
   if (quiet) {
     cmd.push('--quiet')
@@ -102360,6 +102366,7 @@ const commandIgnoredStringInputs = [
   'config',
   'config-file',
   'env',
+  'expose',
   'group',
   'project',
   'spec',
@@ -102383,7 +102390,9 @@ const validateCustomCommand = () => {
   })
   if (ignoredInputParameters.length > 0) {
     core.warning(
-      `command parameter is used and the following other parameters are ignored: ${ignoredInputParameters.sort().join(', ')}.`
+      `command parameter is used and the following other parameters are ignored: ${ignoredInputParameters
+        .sort()
+        .join(', ')}.`
     )
   }
 }
@@ -102479,6 +102488,10 @@ const runTests = async () => {
     cypressOptions.env = core.getInput('env')
   }
 
+  if (core.getInput('expose')) {
+    cypressOptions.expose = core.getInput('expose')
+  }
+
   if (cypressOptions.parallel || cypressOptions.group) {
     const { branch, buildId } = await getCiBuildId()
     if (branch) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cypress/github-action",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "description": "GitHub Action for running Cypress end-to-end and component tests",
   "private": false,
   "main": "dist/index.js",