Files
cypress/docs/source/api/cypress-api/server.md
T
2017-05-15 14:10:01 -04:00

31 lines
989 B
Markdown

title: api-server
comments: true
---
Any configuration you pass to [`cy.server`](https://on.cypress.io/api/server) will only persist until the end of the test. If you find yourself passing the same configuration to each [`cy.server`](https://on.cypress.io/api/server), then you might want to permanently change the default options for all [`cy.server`](https://on.cypress.io/api/server) instances.
***
# [Cypress.Server.defaults( *object* )](#section-usage)
Change default configuration for [`cy.server`](https://on.cypress.io/api/server)
{% note info %}
A great place to put this configuration is in your `cypress/support/defaults.js` file, since it is loaded before any test files are evaluated.
{% endnote %}
***
# Usage
```javascript
// pass anything here you'd normally pass
// to cy.server(). These options will be the new defaults.
Cypress.Server.defaults({
delay: 500,
force404: false,
whitelist: function(xhr){
// handle custom logic for whitelisting
}
})
```