4.2.0 release (cypress-io#2570)

* 4.2.0 release

* Document Electron --headed video recording (cypress-io#2568)

* Add 4.2.0 changelog file

* Add note about reserved CYPRESS_INTERNAL_ENV env var (cypress-io#2587)

* change cypress cache list command (cypress-io#2598)

* add tips for browser detection (cypress-io#2591)

* Point Google SEO to Translated Pages, closes cypress-io#1946 (cypress-io#2593)

* Adds Shortlinks for Supported Langugages

- updated CONTRIBUTING with additional instructions
- there's some potentially superfluous cy.visit being called in the first descibe block in the i18n test spec, but figured the optimization here might not matter?
- closes cypress-io#1714

* Point Google SEO to Translated Pages

- closes cypress-io#1946

* chore(deps): Update dependency @types/jest to version 25.1.4 🌟 (cypress-io#2592)

Co-authored-by: Renovate Bot <[email protected]>

* Add missing word to best-practices.md (cypress-io#2590)

I noticed a missing word in a sentence.

* Add two closing parenthesis on runOn ignoreOn (cypress-io#2589)

* change cypress cache list command

Co-authored-by: Abner Yang <[email protected]>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Renovate Bot <[email protected]>
Co-authored-by: Kyle <[email protected]>
Co-authored-by: Simone Mariotti <[email protected]>

* begin updating changelog with closed issues

* Finish current changelog

* add correct ANSI capitalization to textlintrc

* Add newly closed issue to changleog + make wording a bit less repetitive

* Add 2 more closed issues to changelog

* Add another closed issue to changelog

Co-authored-by: Jennifer Shehane <[email protected]>
Co-authored-by: Gleb Bahmutov <[email protected]>
Co-authored-by: Abner Yang <[email protected]>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Renovate Bot <[email protected]>
Co-authored-by: Kyle <[email protected]>
Co-authored-by: Simone Mariotti <[email protected]>

.textlintrc

@@ -15,6 +15,7 @@
         ["test runner", "Test Runner"],
 
         // Brands and Technologies
+        ["ansi", "ANSI"],
         "AppVeyor",
         "Babel",
         ["^Blob(?! %)", "Blob"],

source/_changelogs/4.2.0.md

@@ -0,0 +1,41 @@
+# 4.2.0
+
+*Released 3/16/2020*
+
+**Features:**
+
+- Videos can now be recorded when running Electron in `--headed` mode. Addresses {% issue 1767 %}.
+- {% url "`cypress cache list`" command-line#cypress-cache-list %} now prints the last time the cached binary was accessed for each version present. Addresses {% issue 6682 %}.
+
+**Bugfixes:**
+
+- We fixed a regression in {% url "3.8.3" changelog-3-8-3 %}  where HTTPS requests could experience slowdown. Fixes {% issue 6659 %}.
+- We now detect some installations of Firefox that were previously undetected. Fixes {% issue 6669 %}.
+- We fixed a race condition where an asynchronous error could fail to be caught when running the plugins file process. Fixes {% issue 6570 %}.
+- We now more thoroughly ensure the parent of an element exists when recursively calling actionability checks in order to prevent some maximum call stack errors. Fixes {% issue 6707 %}.
+- Specfiles containing `&` or `%` characters now correctly run instead of erroring. Fixes {% issue 4210 %}.
+- We added support for running tests on Jira plugins even when Jira scripts were not minified. Fixes {% issue 1436 %}.
+- We fixed a bug causing specs to hang after rerunning tests during `cypress open` when there was an exception if thrown in an `after` hook. Fixes {% issue 6619 %}.
+- {% url "`cypress verify`" command-line#cypress-verify %} no longer incorrectly prints messaging about this being the first time using that Cypress version. Fixes {% issue 6607 %}.
+- Screenshots no longer fail to be taken in Electron when Cypress `DEBUG` logs are enabled. Fixes {% issue 6662 %}.
+
+**Misc:**
+
+- A warning is now printed when setting the reserved key `CYPRESS_INTERNAL_ENV` to a non-production value. Addresses {% issue 6436 %}.
+- When DEBUG logs are printed from `cypress:launcher`, they now print a clearer log during browser detection for easier reading. Addresses {% issue 6700 %}.
+- The Test Runner now renders ANSI colors when there is a syntax error in the spec file. Addresses {% issue 6533 %}.
+- The Test Runner now has an icon indicating whether the specs list parent folder is collapsed.  Addresses {% issue 6277 %}.
+- There's better type information for {% url "`.click`" click %}, {% url "`.dblclick`" dblclick %}, and {% url "`.rightclick`" rightclick %} command's `position` argument. Addresses {% issue 6341 %}.
+- There's a more robust type signature for {% url "`.its()`" its %} and {% url "`.invoke()`" invoke %}. Addresses {% issue 6431 %}.
+- Using {% url "`Cypress.dom.isDetached`" dom#Is-detached %} no longer throws a type error in TypeScript projects. Addresses {% issue 4408 %}.
+- Using {% url "`cy.clearLocalStorage({ log:false })`" clearlocalstorage %} no longer throws a type error in TypeScript projects. Addresses {% issue 6615 %}.
+- We added types for {% url "`Cypress.sinon`" sinon %}. Addresses {% issue 6720 %}.
+- We've added the foundational work required to support experimental features in the Test Runner. Addresses {% issue 6257 %}.
+
+**Dependency Updates**
+
+- Upgraded Chrome browser version used during `cypress run` and when selecting Electron browser in `cypress open` from `78` to `80`. Addressed in {% PR 6555 %}.
+- Upgraded `electron` from `7.1.13` to `8.1.1`. Addressed in {% PR 6555 %}.
+- Upgraded `@ffmpeg-installer/ffmpeg` from `1.0.19` to `1.0.20`. Addressed in {% PR 6686 %}.
+- Upgraded `minimist` from `1.2.0` to `1.2.2`. Addressed in {% PR 6726 %}.
+- Replaced deprecated `request` with `cypress-io/request`. Addressed in {% PR 6679 %}.

source/guides/guides/command-line.md

@@ -195,10 +195,6 @@ Specifying the `--ci-build-id` may also be necessary.
 
 ### `cypress run --headed`
 
-{% note warning %}
-Video recording is not currently supported in Electron with the `--headed` flag. See {% issue 1767 %} for more details.
-{% endnote %}
-
 By default, Cypress will run tests in Electron headlessly.
 
 Passing `--headed` will force Electron to be shown. This matches how you run Electron via `cypress open`.
@@ -525,11 +521,17 @@ cypress cache path
 
 ### `cypress cache list`
 
-Print all existing installed versions of Cypress. The output will be a **space delimited** list of version numbers.
+Print all existing installed versions of Cypress. The output will be a table with cached versions and the last time the binary was used by the user, determined from the file's access time.
 
 ```shell
 cypress cache list
-3.0.0 3.0.1 3.0.2
+┌─────────┬──────────────┐
+│ version │ last used    │
+├─────────┼──────────────┤
+│ 3.0.0   │ 3 months ago │
+├─────────┼──────────────┤
+│ 3.0.1   │ 5 days ago   │
+└─────────┴──────────────┘
 ```
 
 ### `cypress cache clear`

source/guides/guides/environment-variables.md

@@ -127,6 +127,10 @@ Conflicting values will override values from your configuration file (`cypress.j
 
 Cypress will *strip off* the `CYPRESS_` when adding your environment variables.
 
+{% note danger %}
+The environment variable `CYPRESS_INTERNAL_ENV` is reserved and should not be set.
+{% endnote %}
+
 ### Export cypress env variables from the command line
 
 ```shell

source/guides/guides/screenshots-and-videos.md

@@ -27,10 +27,6 @@ Cypress clears any existing screenshots before `cypress run`. If you do not want
 
 # Videos
 
-{% note warning %}
-Video recording is not currently supported in Electron with the {% url "`--headed` flag" command-line#cypress-run-headed %}. See {% issue 1767 %} for more details.
-{% endnote %}
-
 Cypress records a video for each spec file when running tests.
 
 Video recording can be turned off entirely by setting {% url `video` configuration#Videos %} to `false` from within your configuration.