Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: v13 video and TR migration info #5383

Merged
merged 7 commits into from Jul 24, 2023
Merged
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
57 changes: 56 additions & 1 deletion docs/guides/references/migration-guide.mdx
Expand Up @@ -6,7 +6,62 @@ title: Migration Guide

This guide details the changes and how to change your code to migrate to Cypress
version 13.0.
[See the full changelog for version 13.0](/guides/references/changelog#13-0-0).
[See the full changelog for version 13.0](https://docs.cypress.io/guides/overview/why-cypress).

### Cypress Cloud Test Replay

[Test Replay](https://docs.cypress.io/guides/overview/why-cypress) is enabled by default in `v13.0` of the Cypress App.

You may need to allowlist `capture.cypress.io` if you work with a strict VPN. See our FAQ section about [VPN subdomain allowlisting](/faq/questions/cloud-faq#Im-working-with-a-restrictive-VPN-Which-subdomains-do-I-have-to-allow-on-my-VPN-for-Cypress-Cloud-to-work-properly).

You can [opt out](https://docs.cypress.io/guides/overview/why-cypress) of this feature in Cloud project-level settings.

<!---
todo: replace urls for merge to v13 branch:
jaffrepaul marked this conversation as resolved.
Show resolved Hide resolved

changelog- /guides/references/changelog#13-0-0
test replay- /guides/cloud/debugging/test-replay
opt out- /guides/cloud/debugging/test-replay#Opt-out-of-Test-Replay
--->

### Video updates

#### `video` is set to false by default
jaffrepaul marked this conversation as resolved.
Show resolved Hide resolved

You can continue recording video, by passing `video: true`, if you want video locally or you want video for some other reason, like in non-Chromium browsers where [Test Replay](https://docs.cypress.io/guides/overview/why-cypress) is not available.

:::cypress-config-example

```ts
{
video: true
}
```

:::

#### `videoUploadOnPasses` configuration option has been removed

Most users used `videoUploadOnPasses` as a way to skip the time to compress and upload videos to the Cloud. Since we're turning off `videoCompression` by default, this configuration option does not offer the time saving value that it once would.

If you want to prevent a passing test from uploading to the Cloud, we recommend deleting the video using our [guide with code examples to discard captured video of passing tests](/guides/guides/screenshots-and-videos#Control-which-videos-to-keep-and-upload-to-Cypress-Cloud).

#### `videoCompression` is set to false by default
jaffrepaul marked this conversation as resolved.
Show resolved Hide resolved

Cypress has the capability to compress recorded videos after a run to reduce the video file size. By default, compression is turned off, which results in a larger file size and better video quality.
jaffrepaul marked this conversation as resolved.
Show resolved Hide resolved

You can enable this with the `videoCompression` [configuration](/guides/references/configuration#Videos) option if you'd like to reduce the video file size for any reason. This will also reduce the video quality and take slightly longer to process and complete the run.

:::cypress-config-example

```ts
{
// value can be true/false -or- an integer between 0 and 51
videoCompression: true,
}
```

:::

### `cy.readFile()` is now a query command

Expand Down