Impact Score: 5/10
Cypress v1.2.0 โ Release Notes & Engineering Impact
Source available โ automated, not human-reviewed
Component: cypress ยท Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
โก Executive Summary (TL;DR)
Cypress v1.2.0. Source highlight: *Released 12/14/2017*
Who Does This Impact? (Role-Based Analysis)
๐ป Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
๐ Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
โ๏ธ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
โจ New Features & Capabilities (2)
- Added `Configuration API`
- Added `Recipes`
๐ง Bug Fixes & Patches (6)
- Plugins can now return a `Promise` and modify the yielded `config` to set new configuration values and environment variables. Fixes #1042 and #909 and #576.
- There is a new `userAgent` option in `cypress.json`. This enables you to change the `userAgent` of the browser for the entire browsing session. Fixes #364.
- There is a new `blacklistHosts` option in `cypress.json` that allows you to block requests made to those hosts. Blocked requests will respond with a `503` status code. This is useful for blocking 3rd party domains like Google Analytics. We have added a new recipe demonstrating this. Fixes #442.
- Added chai assertions in TypeScript to generate autocompletion. Fixes #1073.
- Updated TypeScript definitions to more accurately match the current Cypress API. Fixes #1050. Also note that if you were extending Cypress in TypeScript the `Chainer` interface changed. Please read 1048#issuecomment-351891910 to understand what you will need to update.
- Renamed `environmentVariables` to `env` in the Desktop GUI. Fixes #1052.
๐ View Raw Release Notes (Original Developer Log)
*Released 12/14/2017*
**Features:**
- Plugins can now return a `Promise` and modify the yielded `config` to set new configuration values and environment variables. Fixes [#1042](https://github.com/cypress-io/cypress/issues/1042) and [#909](https://github.com/cypress-io/cypress/issues/909) and [#576](https://github.com/cypress-io/cypress/issues/576).
- There is a new [`userAgent`](https://on.cypress.io/configuration#Browser) option in `cypress.json`. This enables you to change the `userAgent` of the browser for the entire browsing session. Fixes [#364](https://github.com/cypress-io/cypress/issues/364).
- There is a new [`blacklistHosts`](https://on.cypress.io/configuration#Browser) option in `cypress.json` that allows you to block requests made to those hosts. Blocked requests will respond with a `503` status code. This is useful for blocking 3rd party domains like Google Analytics. We have added a [new recipe](https://on.cypress.io/recipes#Stubbing-Google-Analytics) demonstrating this. Fixes [#442](https://github.com/cypress-io/cypress/issues/442).
- Added chai assertions in TypeScript to generate autocompletion. Fixes [#1073](https://github.com/cypress-io/cypress/issues/1073).
**Bugfixes:**
- Updated TypeScript definitions to more accurately match the current Cypress API. Fixes [#1050](https://github.com/cypress-io/cypress/issues/1050). Also note that if you were extending Cypress in TypeScript the `Chainer` interface changed. Please read [1048#issuecomment-351891910](https://github.com/cypress-io/cypress/issues/1048#issuecomment-351891910) to understand what you will need to update.
**Misc:**
- Renamed `environmentVariables` to `env` in the Desktop GUI. Fixes [#1052](https://github.com/cypress-io/cypress/issues/1052).
- [`Cypress.config()`](https://on.cypress.io/configuration#Cypress-config) now returns a complete set of configuration values. Fixes [#509](https://github.com/cypress-io/cypress/issues/509).
- Added TypeScript typings for bundled Cypress tools like `$`, `_`, etc. Fixes [#1046](https://github.com/cypress-io/cypress/issues/1046).
- Some error messages were made more passive. Fixes [#1025](https://github.com/cypress-io/cypress/issues/1025).
**Documentation Changes:**
- [Added `Configuration API`](https://on.cypress.io/configuration-api)
- [Added `Recipes`](https://on.cypress.io/recipes)
- [Updated `Configuration`](https://on.cypress.io/configuration)
- [Updated `Environment Variables`](https://on.cypress.io/environment-variables)
- [Updated `Using Cypress FAQ`](https://on.cypress.io/using-cypress-faq)
- [Updated `Plugins Guide`](https://on.cypress.io/plugins-guide)
- [Updated `Writing a Plugin API`](https://on.cypress.io/writing-a-plugin)