Skip to content

Commit 4d0a604

Browse files
committed
doc: add docs for synchronous XHR requests
1 parent 7400f99 commit 4d0a604

File tree

1 file changed

+18
-2
lines changed

1 file changed

+18
-2
lines changed

docs/app/references/error-messages.mdx

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -801,10 +801,10 @@ read a unique identifier from your CI provider as described in our
801801

802802
You may encounter this error if Cypress is detecting the exact same CI Build ID
803803
matching a previous CI Build ID in a run that was completed over 24 hours ago.
804-
You cannot run tests on a run that has been complete for that long. ​ ​You can
804+
You cannot run tests on a run that has been complete for that long. You can
805805
see the CI Build ID that is detected for each completed run by looking at the
806806
details section at the top of your run in
807-
[Cypress Cloud](https://on.cypress.io/cloud). ​ ​You can generate and pass in
807+
[Cypress Cloud](https://on.cypress.io/cloud). You can generate and pass in
808808
your own unique CI Build ID per run as described
809809
[here](/app/references/command-line#cypress-run-ci-build-id-lt-id-gt).
810810

@@ -946,6 +946,22 @@ there.
946946
It's possible to enable debugging these scripts by adding the `crossorigin`
947947
attribute and setting a `CORS` header.
948948

949+
### <Icon name="exclamation-triangle" color="red" /> Synchronous XHR requests
950+
951+
:::caution
952+
953+
<strong>Note</strong>
954+
955+
Synchronous XHR requests often cause hangs on the web, especially with poor network conditions or when the remote server is slow to respond. Synchronous XHR is now deprecated and should be avoided in favor of asynchronous requests.
956+
957+
:::
958+
959+
Cypress does not fully support synchronous XHR requests in the following scenarios:
960+
961+
- When using `cy.intercept()` with a `routeHandler` to intercept a synchronous XHR request.
962+
- When applying cookies to a synchronous XHR request.
963+
- When setting cookies from the response of a synchronous XHR request.
964+
949965
## Browser Errors
950966

951967
{/* keep old hash */}

0 commit comments

Comments
 (0)