diff --git a/docs/api/cypress-api/browser.mdx b/docs/api/cypress-api/browser.mdx index 66ed3e3636..f264c0753b 100644 --- a/docs/api/cypress-api/browser.mdx +++ b/docs/api/cypress-api/browser.mdx @@ -19,18 +19,18 @@ Cypress.browser // returns browser object The object has the following properties: -| Property | Type | Description | -| -------------- | --------- | --------------------------------------------------------------------- | -| `channel` | `string` | Release channel of the browser, such as `stable`, `dev`, or `canary`. | -| `displayName` | `string` | Human-readable display name for the browser. | -| `family` | `string` | Rendering engine being used. `chromium` or `firefox`. | -| `isChosen` | `boolean` | Whether the browser is selected in the browser selector of Cypress. | -| `majorVersion` | `number` | The major version number of the browser. | -| `name` | `string` | Machine-friendly name, like `chrome`, `electron`, or `firefox`. | -| `path` | `string` | Path to the browser on disk. Blank for Electron. | -| `version` | `string` | Full version. | -| `isHeadless` | `boolean` | Whether the browser is running headlessly. | -| `isHeaded` | `boolean` | Whether the browser displays headed. | +| Property | Type | Description | +| -------------- | -------------------- | --------------------------------------------------------------------- | +| `channel` | `string` | Release channel of the browser, such as `stable`, `dev`, or `canary`. | +| `displayName` | `string` | Human-readable display name for the browser. | +| `family` | `string` | Rendering engine being used. `chromium` or `firefox`. | +| `isChosen` | `boolean` | Whether the browser is selected in the browser selector of Cypress. | +| `majorVersion` | `number` \| `string` | The major version number of the browser. | +| `name` | `string` | Machine-friendly name, like `chrome`, `electron`, or `firefox`. | +| `path` | `string` | Path to the browser on disk. Blank for Electron. | +| `version` | `string` | Full version. | +| `isHeadless` | `boolean` | Whether the browser is running headlessly. | +| `isHeaded` | `boolean` | Whether the browser displays headed. | ## Examples diff --git a/docs/api/cypress-api/isbrowser.mdx b/docs/api/cypress-api/isbrowser.mdx index 54a81664b1..b55393c061 100644 --- a/docs/api/cypress-api/isbrowser.mdx +++ b/docs/api/cypress-api/isbrowser.mdx @@ -38,17 +38,17 @@ Filter one or multiple browsers by the browser properties. You can inspect the current browser's properties by using the [Cypress.browser](/api/cypress-api/browser). Supported properties are: -| Property | Type | Description | -| -------------- | --------- | --------------------------------------------------------------------- | -| `name` | `string` | Machine-friendly name, like `chrome`, `electron`, or `firefox`. | -| `family` | `string` | Rendering engine being used. `chromium` or `firefox`. | -| `channel` | `string` | Release channel of the browser, such as `stable`, `dev`, or `canary`. | -| `displayName` | `string` | Human-readable display name for the browser. | -| `version` | `string` | Full version. | -| `path` | `string` | Path to the browser on disk. Blank for Electron. | -| `majorVersion` | `number` | The major version number of the browser. | -| `isHeadless` | `boolean` | Whether the browser is running headlessly. | -| `isHeaded` | `boolean` | Whether the browser displays headed. | +| Property | Type | Description | +| -------------- | -------------------- | --------------------------------------------------------------------- | +| `name` | `string` | Machine-friendly name, like `chrome`, `electron`, or `firefox`. | +| `family` | `string` | Rendering engine being used. `chromium` or `firefox`. | +| `channel` | `string` | Release channel of the browser, such as `stable`, `dev`, or `canary`. | +| `displayName` | `string` | Human-readable display name for the browser. | +| `version` | `string` | Full version. | +| `path` | `string` | Path to the browser on disk. Blank for Electron. | +| `majorVersion` | `number` \| `string` | The major version number of the browser. | +| `isHeadless` | `boolean` | Whether the browser is running headlessly. | +| `isHeaded` | `boolean` | Whether the browser displays headed. | ## Examples diff --git a/docs/app/references/changelog.mdx b/docs/app/references/changelog.mdx index 75a146920a..8f9982f377 100644 --- a/docs/app/references/changelog.mdx +++ b/docs/app/references/changelog.mdx @@ -8,6 +8,30 @@ sidebar_label: Changelog # Changelog +## 14.1.0 + +_Released 2/25/2025_ + +**Features:** + +- Firefox versions 135 and above are now automated with [WebDriver BiDi](https://www.w3.org/TR/webdriver-bidi/) instead of [Chrome Devtools Protocol](https://chromedevtools.github.io/devtools-protocol/). Addresses [#30220](https://github.com/cypress-io/cypress/issues/30220). + +**Bugfixes:** + +- Fixed the calculation of upload throughput units when displaying the 'stream stalled' error message during Test Replay archive uploads. Fixes [#31075](https://github.com/cypress-io/cypress/issues/31075). Addressed in [#31160](https://github.com/cypress-io/cypress/pull/31160). + +**Misc:** + +- Viewport width, height, and scale now display in a badge above the application under test. The dropdown describing how to set viewport height and width has been removed from the UI. Additionally, component tests now show a notice about URL navigation being disabled in component tests. Addresses [#30999](https://github.com/cypress-io/cypress/issues/30999). Addressed in [#31119](https://github.com/cypress-io/cypress/pull/31119). +- Updated types around `.readFile()` and `.scrollTo()` arguments and `Cypress.dom` methods. Addressed in [#31055](https://github.com/cypress-io/cypress/pull/31055). +- Updated types around `.shadow()` and `.root()` options. Addressed in [#31154](https://github.com/cypress-io/cypress/pull/31154). + +**Dependency Updates:** + +- Upgraded `chrome-remote-interface` from `0.33.2` to `0.33.3`. Addressed in [#31128](https://github.com/cypress-io/cypress/pull/31128). +- Upgraded `ci-info` from `4.0.0` to `4.1.0`. Addressed in [#31132](https://github.com/cypress-io/cypress/pull/31132). +- Upgraded `compression` from `1.7.5` to `1.8.0`. Addressed in [#31151](https://github.com/cypress-io/cypress/pull/31151). + ## 14.0.3 _Released 2/11/2025_ diff --git a/docs/app/references/launching-browsers.mdx b/docs/app/references/launching-browsers.mdx index 97d4aab9d2..f1a34a72f7 100644 --- a/docs/app/references/launching-browsers.mdx +++ b/docs/app/references/launching-browsers.mdx @@ -190,6 +190,22 @@ of our [docker images](/app/continuous-integration/overview#Cypress-Docker-Image By default, we will launch Firefox headlessly during `cypress run`. To run Firefox headed, you can pass the `--headed` argument to `cypress run`. +##### Webdriver BiDi and CDP Deprecation + +:::info + +Since Firefox 129, Chrome DevTools Protocol (CDP) has been [deprecated in Firefox](https://fxdx.dev/deprecating-cdp-support-in-firefox-embracing-the-future-with-webdriver-bidi/). +In Firefox 135 and above, Cypress defaults to automating the Firefox browser with WebDriver BiDi. +Cypress will no longer support CDP within Firefox in the future and is planned for removal in Cypress 15. + +If CDP still needs to be used, you can force enablement via the `FORCE_FIREFOX_CDP=1` environment variable, regardless of Firefox version. For example: + +```bash +FORCE_FIREFOX_CDP=1 npx cypress run --browser firefox +``` + +::: + ### WebKit (Experimental) Cypress has [experimental](/app/references/experiments) support for WebKit,