Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions docs/api/cypress-api/browser.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
22 changes: 11 additions & 11 deletions docs/api/cypress-api/isbrowser.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
24 changes: 24 additions & 0 deletions docs/app/references/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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_
Expand Down
16 changes: 16 additions & 0 deletions docs/app/references/launching-browsers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down