How to Fix cy.visit Failed Error in Cypress Tests

The cy.visit command fails in Cypress usually because the URL is incorrect, the server is not running, or Cypress security settings block the visit. To fix it, ensure the URL is correct and accessible, the server is running, and adjust Cypress config like baseUrl or chromeWebSecurity if needed.

Why This Happens

The cy.visit command fails when Cypress cannot load the page you want to test. This can happen if the URL is wrong, the web server is not running, or Cypress blocks the visit due to security settings like cross-origin restrictions.

javascript

describe('Visit test', () => {
  it('fails to visit', () => {
    cy.visit('http://localhost:9999')
  })
})

Output

CypressError: cy.visit() failed trying to load: http://localhost:9999

The server responded with a status of 404 (Not Found)

The Fix

Make sure the URL in cy.visit is correct and the server is running on that address. If testing a local app, start your server before running tests. Also, set baseUrl in cypress.config.js to simplify URLs. If cross-origin errors occur, disable chromeWebSecurity in config.

javascript

/// cypress.config.js
module.exports = {
  e2e: {
    baseUrl: 'http://localhost:3000',
    chromeWebSecurity: false
  }
}

// test file
describe('Visit test', () => {
  it('successfully visits', () => {
    cy.visit('/')
  })
})

Output

Test passes and page loads successfully without errors

Prevention

Always verify your server is running before tests. Use baseUrl to avoid hardcoding full URLs. Avoid cross-origin issues by keeping tests and app on the same domain or disabling chromeWebSecurity if necessary. Use Cypress commands like cy.request to check server availability before cy.visit.

Related Errors

Other common errors include Timeout exceeded when the server is slow or unreachable, and Cross origin error when trying to visit a URL outside the allowed domain. Fix these by increasing timeout or adjusting security settings.

Key Takeaways

Ensure the URL in cy.visit is correct and the server is running.

Set baseUrl in Cypress config to simplify URL management.

Disable chromeWebSecurity in config to avoid cross-origin visit failures.

Use cy.request to verify server availability before visiting.

Check error messages carefully to identify the root cause.