Merge pull request #4078 from cypress-io/8.4.0-release

Author: flotwig

content/_changelogs/8.4.0.md

@@ -0,0 +1,23 @@
+## 8.4.0
+
+_Released 09/13/2021_
+
+**Features:**
+
+- When the URL contains non-ASCII characters, you can use the new `decode`
+  option of `cy.url()` to decode it. Addresses
+  [#17399](https://github.com/cypress-io/cypress/issues/17399).
+
+**Bugfixes:**
+
+- Cypress now better handles situations where the extension was installed in a
+  read-only location. Fixes
+  [#3852](https://github.com/cypress-io/cypress/issues/3852).
+- A clearer error message is now thrown for `.check()` or `.uncheck()` when
+  there are no matching value attributes found.
+  Fixes[#7379](https://github.com/cypress-io/cypress/issues/7379).
+- Hooks will no longer rerun on unrelated tests in some situations after a
+  domain navigation. Fixes
+  [#17705](https://github.com/cypress-io/cypress/issues/17705).
+- `clientCertificate` types have been added for the Cypress configuration. Fixes
+  [#17799](https://github.com/cypress-io/cypress/issues/17799).

content/api/commands/url.md

@@ -35,6 +35,7 @@ Pass in an options object to change the default behavior of `cy.url()`.
 
 | Option    | Default                                                              | Description                                                                              |
 | --------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `decode`  | `false`                                                              | Decode URL                                                                               |
 | `log`     | `true`                                                               | Displays the command in the [Command log](/guides/core-concepts/test-runner#Command-Log) |
 | `timeout` | [`defaultCommandTimeout`](/guides/references/configuration#Timeouts) | Time to wait for `cy.url()` to resolve before [timing out](#Timeouts)                    |
 
@@ -55,6 +56,15 @@ cy.url().should('include', '/users/1/edit') // => true
 cy.url().should('eq', 'http://localhost:8000/users/1/edit') // => true
 ```
 
+### `decode` option
+
+When the URL contains non-ASCII characters, use the `decode` option.
+
+```javascript
+// For the curious, '사랑' means 'love' in Korean.
+cy.url({ decode: true }).should('contain', '사랑')
+```
+
 ## Notes
 
 ### Href Shorthand
@@ -142,6 +152,7 @@ When clicking on URL within the Command Log, the console outputs the following:
 
 | Version                                       | Changes                  |
 | --------------------------------------------- | ------------------------ |
+| [8.4.0](/guides/references/changelog#8-4-0)   | `decode` option added    |
 | [< 0.3.3](/guides/references/changelog#0-3-3) | `cy.url()` command added |
 
 ## See also