Upload strategies

By default, all test replays are uploaded no matter the result. If you want to upload only the failed recordings, you can use the filter property in the plugin configuration:

• cypress
• playwright

export default defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      replayPlugin(on, config, {
        upload: true,
        apiKey: process.env.REPLAY_API_KEY,
        filter: function (recording) {
          // upload runtime crashes and any failed tests
          return (
            recording.status === "crashed" ||
            recording.metadata.test.result === "failed"
          );
        }
      })
      return config
    },
  },
})

By default, all test replays are uploaded no matter the result. If you want to upload failed and flaky tests, you can use the filter property in the plugin configuration:

export default defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      replayPlugin(on, config, {
        upload: true,
        apiKey: process.env.REPLAY_API_KEY,
        filter: function (recording) {
          // upload runtime crashes and recordings with any tests that failed
          return (
            recording.status === "crashed" ||
            recording.metadata.test.tests.some(test => test.result === "failed")
          );
        }
      })
      return config
    },
  },
})

The recording metadata includes some details about the source control including the repository and branch name which can also be used to filter your uploads. The example below uploads all recordings from the main branch:

• cypress
• playwright

export default defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      replayPlugin(on, config, {
        upload: true,
        apiKey: process.env.REPLAY_API_KEY,
        filter: function (recording) {
          return recording.metadata.source.branch === "main";
        }
      })
      return config
    },
  },
})

If you've adopted one the configurations above but would also like to periodically upload all replays for a test run, you can add a condition to the filter that returns true for a given test run id. This is only one possible implementation of this approach and you're welcome to adopt others such as using external environment variables.

• cypress
• playwright

const convertStringToInt = string =>
  string.split("").reduce((acc, char) => acc + char.charCodeAt(0), 0);

export default defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      replayPlugin(on, config, {
        upload: true,
        apiKey: process.env.REPLAY_API_KEY,
        filter: function (recording) {
          // randomly upload 10% of all test runs
          if (convertStringToInt(r.metadata.test.run.id) % 10 === 1) {
            return true;
          }

          // upload runtime crashes and any failed tests
          return (
            recording.status === "crashed" ||
            recording.metadata.test.result === "failed"
          );
        }
      })
      return config
    },
  },
})

.github/workflows/e2e.yml
 1name: Replay tests
 2on: [push, pull_request]
 3jobs:
 4  cypress-run:
 5    runs-on: ubuntu-22.04
 6    steps:
 7      - name: Checkout
 8        uses: actions/checkout@v4
 9      - name: Install dependencies
10        run: npm ci
11      - name: Run Playwright tests with Replay Browser
12        run: npx playwright test --project replay-chromium --reporter=@replayio/playwright/reporter,line
13      - name: Upload replays
14        if: ${{ always() }}
15        uses: replayio/action-upload@v0.5.1
16        with:
17          api-key: ${{ secrets.REPLAY_API_KEY }}
18          filter: ${{ 'function($v) { $v.metadata.test.result = "failed" }' }}