@cypress/github-action 3.1.0 → 4.0.1

package/README.md

@@ -7,9 +7,9 @@
 - [Basic](#basic)
 - [Explicit version](#explicit-version)
 - Run tests in a given [browser](#browser)
-    * using [Firefox](#firefox)
-    * using [Edge](#edge)
-    * using [headless mode](#headless)
+  - using [Firefox](#firefox)
+  - using [Edge](#edge)
+  - using [headed mode](#headed)
 - Using [Docker image](#docker-image)
 - Specify [environment variables](#env)
 - Run only some [spec files](#specs)
@@ -56,7 +56,7 @@ jobs:
       # Install NPM dependencies, cache them correctly
       # and run all Cypress tests
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
 ```
 
 [![Basic example](https://github.com/cypress-io/github-action/workflows/example-basic/badge.svg?branch=master)](.github/workflows/example-basic.yml)
@@ -69,18 +69,18 @@ The workflow file [.github/workflows/example-basic.yml](.github/workflows/exampl
 
 **Best practice:**
 
-Our examples specify the tag of the action to use listing only the major version `@v2`
+Our examples specify the tag of the action to use listing only the major version `@v4`
 
 ```yml
 - name: Cypress run
-  uses: cypress-io/github-action@v2
+  uses: cypress-io/github-action@v4
 ```
 
-When using `cypress-io/github-action@v2` from your workflow file, you automatically will be using the latest [tagged version from this repository](https://github.com/cypress-io/github-action/tags). If you want to precisely control the version of this module, use the full tag version, for example:
+When using `cypress-io/github-action@v4` from your workflow file, you automatically will be using the latest [tagged version from this repository](https://github.com/cypress-io/github-action/tags). If you want to precisely control the version of this module, use the full tag version, for example:
 
 ```yml
 - name: Cypress run
-  uses: cypress-io/github-action@v2.2.7
+  uses: cypress-io/github-action@v4.x.x
 ```
 
 By using the full version tag, you will avoid accidentally using a newer version of the action.
@@ -99,7 +99,7 @@ jobs:
     name: E2E on Chrome
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           browser: chrome
 ```
@@ -121,7 +121,7 @@ jobs:
       options: --user 1001
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           browser: firefox
 ```
@@ -140,7 +140,7 @@ jobs:
     runs-on: windows-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           browser: edge
 ```
@@ -149,22 +149,22 @@ jobs:
 
 **Note:** Microsoft has not released Edge for Linux yet, thus you need to run these tests on Windows or Mac runners with Edge preinstalled. You can use [`cypress info`](https://on.cypress.io/command-line#cypress-info) command to see the browsers installed on the machine.
 
-### Headless
+### Headed
 
-Run the browser in headless mode
+Run the browser in headed mode - as of Cypress v8.0 the `cypress run` command executes tests in `headless` mode by default
 
 ```yml
-name: Chrome headless
+name: Chrome headed
 on: [push]
 jobs:
   cypress-run:
     runs-on: ubuntu-20.04
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           browser: chrome
-          headless: true
+          headed: true
 ```
 
 ### Docker image
@@ -182,7 +182,7 @@ jobs:
     container: cypress/browsers:node12.13.0-chrome78-ff70
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           browser: chrome
 ```
@@ -202,7 +202,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run with env
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           env: host=api.dev.local,port=4222
 ```
@@ -220,7 +220,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run with env
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         env:
           CYPRESS_host: api.dev.local
           CYPRESS_port: 4222
@@ -246,7 +246,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           spec: cypress/integration/spec1.js
 ```
@@ -276,7 +276,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           project: ./some/nested/folder
 ```
@@ -297,7 +297,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           record: true
         env:
@@ -329,7 +329,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           record: true
         env:
@@ -391,7 +391,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           record: true
           tag: node-${{ matrix.node }}
@@ -419,7 +419,7 @@ jobs:
     name: Artifacts
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
       # after the test run completes
       # store videos and any screenshots
       # NOTE: screenshots will be generated only if E2E test failed
@@ -455,7 +455,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           config: pageLoadTimeout=100000,baseUrl=http://localhost:3000
 ```
@@ -478,7 +478,7 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           config-file: tests/cypress-config.json
 ```
@@ -514,7 +514,7 @@ jobs:
       # because of "record" and "parallel" parameters
       # these containers will load balance all found tests among themselves
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           record: true
           parallel: true
@@ -535,22 +535,22 @@ The Cypress GH Action does not spawn or create any additional containers - it on
 
 ### Component tests
 
-You can run the [Cypress component tests](https://on.cypress.io/component-testing) after running E2E tests by calling the action again with a custom command:
+You can run [Cypress component tests](https://on.cypress.io/component-testing) in a job separate from E2E tests by adding `component: true`:
 
 ```yml
 - name: Run E2E tests 🧪
-  uses: cypress-io/github-action@v2
+  uses: cypress-io/github-action@v4
 
 - name: Run Component tests 🧪
-  uses: cypress-io/github-action@v2
+  uses: cypress-io/github-action@v4
   with:
     # we have already installed everything
     install: false
-    # to run component tests we need to use "cypress run-ct"
-    command: yarn cypress run-ct
+    # to run component tests we need to use "component: true"
+    component: true
 ```
 
-See the example project [cypress-react-component-example](https://github.com/bahmutov/cypress-react-component-example)
+See the example project [component-test](/examples/v10/component-tests/) and the [example-component-test-workflow](.github/workflows/example-component-test.yml) for more details.
 
 ### Build app
 
@@ -566,7 +566,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           build: npm run build
 ```
@@ -585,7 +585,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           start: npm start
 ```
@@ -602,7 +602,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           # Linux and MacOS
           start: npm start
@@ -628,7 +628,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           start: npm run api, npm run web
 ```
@@ -658,7 +658,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           start: npm start
           # quote the url to be safe against YML parsing surprises
@@ -670,7 +670,7 @@ jobs:
 By default, `wait-on` will retry for 60 seconds. You can pass a custom timeout in seconds using `wait-on-timeout`.
 
 ```yml
-- uses: cypress-io/github-action@v2
+- uses: cypress-io/github-action@v4
   with:
     start: npm start
     wait-on: 'http://localhost:8080/status'
@@ -683,7 +683,7 @@ See also [![Webpack Dev Server example](https://github.com/cypress-io/github-act
 You can wait for multiple URLs to respond by separating urls with a comma
 
 ```yml
-- uses: cypress-io/github-action@v2
+- uses: cypress-io/github-action@v4
   with:
     # API runs on port 3050
     # Web server runs on port 8080
@@ -697,7 +697,7 @@ The action will wait for the first url to respond, then will check the second ur
 You can even use your own command (usually by using `npm`, `yarn`, `npx`) to wait for the server to respond. For example, if you want to use [wait-on](https://github.com/jeffbski/wait-on) utility to ping the server and run the Cypress tests after the server responds:
 
 ```yml
-- uses: cypress-io/github-action@v2
+- uses: cypress-io/github-action@v4
   with:
     start: npm start
     wait-on: 'npx wait-on --timeout 5000 http://localhost:3000'
@@ -712,7 +712,7 @@ If this action times out waiting for the server to respond, please see [Debuggin
 If you want to overwrite the install command
 
 ```yml
-- uses: cypress-io/github-action@v2
+- uses: cypress-io/github-action@v4
   with:
     install-command: yarn --frozen-lockfile --silent
 ```
@@ -733,7 +733,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           start: npm start
           # quote the url to be safe against YML parsing surprises
@@ -755,7 +755,7 @@ steps:
     uses: actions/checkout@v2
 
   - name: Custom tests 🧪
-    uses: cypress-io/github-action@v2
+    uses: cypress-io/github-action@v4
     with:
       command: npm run e2e:ci
 ```
@@ -778,7 +778,7 @@ jobs:
         containers: [1, 2, 3]
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           record: true
           parallel: true
@@ -813,7 +813,7 @@ jobs:
     needs: ['prepare']
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           record: true
           parallel: true
@@ -847,7 +847,7 @@ jobs:
     runs-on: ubuntu-20.04
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           start: npm start
           working-directory: e2e
@@ -891,7 +891,7 @@ jobs:
 
       # Cypress has its own package.json in folder "e2e"
       - name: Install Cypress and run tests
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           working-directory: e2e
 ```
@@ -913,7 +913,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         with:
           working-directory: examples/start-and-yarn-workspaces/workspace-1
           build: yarn run build
@@ -948,7 +948,7 @@ jobs:
       # run Cypress tests and record them under the same run
       # associated with commit SHA and just give a different group name
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           record: true
           group: Tests on Node v${{ matrix.node }}
@@ -977,7 +977,7 @@ jobs:
         with:
           node-version: ${{ matrix.node }}
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
 ```
 
 [![Node versions example](https://github.com/cypress-io/github-action/workflows/example-node-versions/badge.svg?branch=master)](.github/workflows/example-node-versions.yml)
@@ -997,13 +997,13 @@ jobs:
     steps:
       - uses: actions/checkout@master
       - name: Install dependencies
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           # just perform install
           runTests: false
       - run: yarn lint
       - name: Run e2e tests
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           # we have already installed all dependencies above
           install: false
@@ -1030,7 +1030,7 @@ If the project has many dependencies, but you want to install just Cypress you c
       node_modules
     key: my-cache-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
 - run: npm i cypress
-- uses: cypress-io/github-action@v2
+- uses: cypress-io/github-action@v4
   with:
     install: false
 ```
@@ -1052,7 +1052,7 @@ jobs:
     timeout-minutes: 10
     steps:
       - uses: actions/checkout@v2
-      - uses: cypress-io/github-action@v2
+      - uses: cypress-io/github-action@v4
         # you can specify individual step timeout too
         timeout-minutes: 5
 ```
@@ -1099,7 +1099,7 @@ You can set the environment variable using GitHub UI interface, or in the workfl
 
 ```yml
 - name: Cypress tests with debug logs
-  uses: cypress-io/github-action@v2
+  uses: cypress-io/github-action@v4
   env:
     DEBUG: '@cypress/github-action'
 ```
@@ -1112,7 +1112,7 @@ The above `ACTIONS_STEP_DEBUG` setting enables the debug logs from the action it
 
 ```yml
 - name: Cypress tests with debug logs
-  uses: cypress-io/github-action@v2
+  uses: cypress-io/github-action@v4
   env:
     DEBUG: 'cypress:*'
 ```
@@ -1161,7 +1161,7 @@ This GH Action sets an output `dashboardUrl` if the run was recorded on [Cypress
 
 ```yml
 - name: Cypress tests
-  uses: cypress-io/github-action@v2
+  uses: cypress-io/github-action@v4
   # let's give this action an ID so we can refer
   # to its output values later
   id: cypress
@@ -1216,7 +1216,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           build: npx cypress info
 ```
@@ -1233,14 +1233,14 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress install
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           # just perform install
           runTests: false
       - name: Cypress info
         run: npx cypress info
       - name: Cypress run
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
         with:
           # we have already installed all dependencies above
           install: false
@@ -1264,7 +1264,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v2
       - name: Cypress nightly tests 🌃
-        uses: cypress-io/github-action@v2
+        uses: cypress-io/github-action@v4
 ```
 
 See the [example-cron.yml](./.github/workflows/example-cron.yml) workflow.

package/action.yml

@@ -11,9 +11,9 @@ inputs:
     description: 'Set configuration values. Separate multiple values with a comma. The values set here override any values set in your configuration file.'
     required: false
   config-file:
-    description: 'Path to a JSON file where configuration values are set.'
+    description: 'Path to the cypress config file where configuration values are set.'
     required: false
-    default: cypress.json
+    default: ''
   env:
     description: 'Sets Cypress environment variables'
     required: false
@@ -59,8 +59,8 @@ inputs:
   working-directory:
     description: 'Working directory containing Cypress folder'
     required: false
-  headless:
-    description: 'Whether or not to use headless mode'
+  headed:
+    description: 'Whether or not to use headed mode'
     required: false
   spec:
     description: 'Provide a specific specs to run'
@@ -80,6 +80,10 @@ inputs:
   quiet:
     description: 'Whether or not to silence any Cypress specific output from stdout'
     required: false
+  component:
+    description: "Lets the action know that Cypress is running component tests and not e2e tests"
+    required: false
+    default: false
 outputs:
   dashboardUrl:
     description: 'Cypress Dashboard URL if the run was recorded'