cypress-io · flotwig · Oct 23, 2019 · Aug 23, 2019 · Aug 23, 2019 · Aug 23, 2019
diff --git a/source/_changelogs/3.5.0.md b/source/_changelogs/3.5.0.md
@@ -0,0 +1,62 @@
+# 3.5.0
+
+*Released X/X/2019*
+
+**Features:**
+
+- Cypress app crash: "port" option should be a number or string  {% issue 3250 %}
+- Support `NO_PROXY=<-loopback>`, always have `NO_PROXY=localhost` otherwise {% issue 4780 %}
+- CSS problems on plugins error {% issue 4959 %}
+- moved Simulated click fixes {% issue 2956 %}
+- Handle browser not found object better {% issue 4966 %}
+- Error: Could not start Xvfb. Install Xvfb and run Cypress again. {% issue 5110 %}
+- `cy.visit()` results in ERR_SSL_VERSION_OR_CIPHER_MISMATCH {% issue 771 %}
+- `cy.visit()` and URL encoding {% issue 5034 %}
+- validate inputs to "cy" commands better {% issue 2953 %}
+- {% url "`cy.viewport()`" viewport %} now allows for viewport sizes up to 4,000 pixels. {% issue 5181 %}
+- {% url "`cy.viewport()`" viewport %} accepts new size presets for `iphone-xr`, `iphone-x`, `samsung-s10` and `samsung-note9`. Addresses {% issue 4967 %}.
+- Bundled Node Version 8.2 is too old {% issue 2253 %}
+- Large XHR response objects can exceed the maximum header size. {% issue 76 %}
+- Upgrade to the latest version of Electron {% issue 3568 %}
+- write EPROTO: SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure when visiting https site {% issue4394 %}
+- Cookies are not sent using fetch from electron client {% issue 4433 %}
+- Using apollo-client breaks the tests when run with electron {% issue 5044 %}
+- Fix bug where Chrome policy warnings are not active {% issue 4986 %}
+- ECC SSL Certificates not supported {% issue 4368 %}
+- Add `--config-file` CLI argument {% issue 1369 %}
+- Random failures over Regexp: Invalid regular expression {% issue 1746 %}
+- Correct reason not visible when element is detached from DOM {% issue 4946 %}
+- Should not truncate full url during {% url "`cy.request()`" request %} in stdout {% issue 3145 %}
+- Allow using external Node when running tasks / plugins {% issue 4432 %}
+
+**Bugfixes:**
+
+- Selector Playground doesn't highlight element currently being hovered over {% issue 4872 %}
+- `Cypress.env()` now properly escapes `<script></script>` tags in the configuration file {% issue 4952 %}
+- `response.body` isn't converted to JSON if `content-type` is `application/vnd.api+json` {% issue 5165 %}
+- `dest.end` error crash during run exit on GitLab CI / Windows {% issue 2181 %}
+- `onFocus` event incorrectly fires on a hidden element starting on v3.3.2 {% issue 4898 %}
+- jQuery v3 types are looking for Sizzle types {% issue 5245 %}
+- Cypress + TypeScript 3.6.2 errors due to outdated jQuery types {% issue 5065 %}
+- Cannot click on `readonly` inputs / textarea {% issue 4874 %}
+- Test runs infinitely with combination of async error, 'fail' event, and `done` callback, Cypress hangs up when using `done` within a `before` hook after `cy.request`. `beforeEach` with `done` causes tests to hang indefinitely when `done()` called in `promise.then()`.Mixing `cy.on()`/`cy.once()` with a one-argument `it()` function causes test to hang.  Addresses {% issue 1075 %}, {% issue 2478 %}, {% issue 3349 %}, and {% issue 4790 %}.
+
+**Misc:**
+
+- We now warn when using `cypress run` from the binary directly (not from an npm module) since this is not its intended use. Addresses {% issue 1573 %}.
+- We now warn on {% url "`cy.visit('file://...)`" visit %} to explain that this url format is not supported and suggest visiting relative HTML file. Addresses {% issue 4452 %}.
+- Setting `CYPRESS_ENV` to an unexpected value leads will not throw an error {% issue 1621 %}
+- Scrolling the specs list now only scrolls the list of spec files and no longer scrolls the search and filter bar. Addresses {% issue 4904 %}.
+- We fixed some layout issues within the Test Runner that were introduced in {% url "3.4.1" changelog#3-4-1 %}. Addresses {% issue 4888 %}, {% issue 4912 %}, and {% issue 4959 %}.
+- Stub / spy counter badge is cut off {% issue 4822 %}
+- We're continuing to make process in converting our codebase from CoffeeScript to JavaScript. Addresses {% issue 2690 %} in {% PR 5107 %}.
+
+**Documentation Changes:**
+
+**Dependency Updates**
+
+- Upgraded `electron` from `2.0.18` to `5.0.10`. Addressed in {% PR 4720 %}.
+- Upgraded `node` from `8.9.3` to `12.4.0`. Addressed in {% PR 4720 %}.
+- Upgaded `jquery` from `2.2.4` to `3.1.1`. Addressed in {% PR 1229 %}.
+- Upgraded `sanitize-filename` from `1.6.1` to `1.6.3`. Addressed in {% PR 5216 %}.
+- Upgraded `@cypress/get-windows-proxy` from `1.5.4` to `1.6.0`. Addressed in {% PR 5108 %}.
diff --git a/source/api/commands/viewport.md b/source/api/commands/viewport.md
@@ -42,16 +42,20 @@ A preset dimension to set the viewport. Preset supports the following options:
 
 | Preset | width | height |
 | ----------- | ----- | ------ |
-| `macbook-15`  | 1440  | 900    |
-| `macbook-13`  | 1280  | 800    |
-| `macbook-11`  | 1366  | 768    |
 | `ipad-2`      | 768   | 1024    |
 | `ipad-mini`   | 768   | 1024    |
-| `iphone-6+`   | 414   | 736    |
-| `iphone-6`    | 375   | 667    |
-| `iphone-5`    | 320   | 568    |
-| `iphone-4`    | 320   | 480    |
 | `iphone-3`    | 320   | 480    |
+| `iphone-4`    | 320   | 480    |
+| `iphone-5`    | 320   | 568    |
+| `iphone-6`    | 375   | 667    |
+| `iphone-6+`   | 414   | 736    |
+| `iphone-x`    | 375   | 812    |
+| `iphone-xr`   | 414   | 896    |
+| `macbook-11`  | 1366  | 768    |
+| `macbook-13`  | 1280  | 800    |
+| `macbook-15`  | 1440  | 900    |
+| `samsung-note9` | 414 | 846    |
+| `samsung-s10` | 360   | 760    |
 
 **{% fa fa-angle-right %} orientation** ***(String)***
 
@@ -236,6 +240,7 @@ When clicking on `viewport` within the command log, the console outputs the foll
 {% imgTag /img/api/viewport/console-log-shows-width-and-height-of-tested-viewport.png "Console Log viewport" %}
 
 {% history %}
+{% url "3.5.0" changelog#0-9-0 %} | Added support for presets `iphone-xr`, `iphone-x`, `samsung-s10`, and `samsung-note9`
 {% url "0.9.0" changelog#0-9-0 %} | `cy.viewport()` command added
 {% endhistory %}
 

diff --git a/source/api/commands/visit.md b/source/api/commands/visit.md
@@ -24,6 +24,7 @@ cy.visit(options)
 
 ```javascript
 cy.visit('http://localhost:3000')    // Yields the window of the remote page
+cy.visit('./pages/hello.html')
 ```
 
 ## Arguments
@@ -34,6 +35,9 @@ The URL to visit.
 
 Cypress will prefix the URL with the `baseUrl` configured in your {% url 'network options' configuration#Global %} if you've set one.
 
+You may also specify the relative path of an html file.  The path is relative to the root
+directory of the Cypress installation. Note that the `file://` prefix is not needed.
+
 **{% fa fa-angle-right %} options** ***(Object)***
 
 Pass in an options object to control the behavior of `cy.visit()`.
@@ -44,6 +48,7 @@ Option | Default | Description
 `method` | `GET` | The HTTP method to use in the visit. Can be `GET` or `POST`.
 `body` | `null` | An optional body to send along with a `POST` request. If it is a string, it will be passed along unmodified. If it is an object, it will be URL encoded to a string and sent with a `Content-Type: application/x-www-urlencoded` header.
 `headers` | `{}` | An object that maps HTTP header names to values to be sent along with the request. *Note:* `headers` will only be sent for the initial `cy.visit()` request, not for any subsequent requests.
+`qs` | `null` | Query parameters to append to the `url` of the request
 `log` | `true` | {% usage_options log %}
 `auth` | `null` | Adds Basic Authorization headers
 `failOnStatusCode` | `true` | Whether to fail on response codes other than `2xx` and `3xx`
@@ -140,6 +145,29 @@ cy.visit('http://localhost:3000/#/users', {
 })
 ```
 
+### Add query paramaters
+
+You can provide query parameters as an object to `cy.visit()` by passing `qs` to `options`.
+
+```js
+// visits http://localhost:3500/users?page=1&role=admin
+cy.visit('http://localhost:3500/users', {
+  qs: {
+    page: '1',
+    role: 'admin'
+  }
+})
+```
+
+The parameters passed to `qs` will be merged into existing query parameters on the `url`.
+
+```js
+// visits http://example.com/users?page=1&admins
+cy.visit('http://example.com/users?page=1', {
+  qs: { 'admins' }
+})
+```
+
 ### Submit a form
 
 To send a request that looks like a user submitting an HTML form, use a `POST` method with a `body` containing the form values:

diff --git a/source/guides/references/proxy-configuration.md b/source/guides/references/proxy-configuration.md
@@ -69,7 +69,7 @@ This section refers to your operating system's environment variables, *not* {% u
 
 Cypress automatically reads from your system's `HTTP_PROXY` environment variable and uses that proxy for all HTTP and HTTPS traffic. If an `HTTPS_PROXY` environment variable is set, HTTPS traffic will use that proxy instead.
 
-To bypass the proxy for certain domains, a `NO_PROXY` environment variable can be set to a comma-separated list of domain names to not proxy traffic for. By default, traffic to `localhost` will not be proxied.
+To bypass the proxy for certain domains, a `NO_PROXY` environment variable can be set to a comma-separated list of domain names to not proxy traffic for. By default, traffic to `localhost` will not be proxied. To make Cypress send traffic for `localhost` through the proxy, pass `<-loopback>` in `NO_PROXY`.
 
 If an uppercase and a lowercase version of the proxy settings are supplied (for example, `HTTP_PROXY` and `http_proxy` are both set), the lowercase variable will be preferred.