README.md

CypressHelpers

cypress tips and tricks i've found

Instead of cycling windows, i found it was more helpful to create a page with iframes in it, and then target/enter/exit the iframes as needed

so i would have one frame represent a user visiting one page,

and then a second frame representing a user visiting another page, maybe sending websocket events for example,

then going back to the first frame, to see if the event was sent and that the page updated

shoutout to https://www.npmjs.com/package/cypress-iframe which is similar, but not quite the same

Cypress Frame Helper Commands Reference

1. download frame_helpers.js to your /cypress/support/ folder

2. import 'frame_helpers' or require('frame_helpers') in the support/index.js file

• cy.frameEnter(selector) - switch current context to a iframe element
• cy.frameExit() - go back to base page context which contains the iframes
• cy.frameVisit(selector,url) - make frame visit a url
• cy.frameReload(selector) - reload the frame
• cy.frameResize(selector,width,height) - resize the frame to test responsive changes

Tip 1: Switching "Tabs" / Switching between windows

Cypress Tab Helper Commands Reference

See tab-helpers.js. Just add it to your support/commands.js file

They're really popup-windows or child-windows, but i call them tabs for api brevity

see https://github.com/jakedowns/CypressHelpers/blob/master/tab_window_switching_test.cy.js for example usage

• cy.openTab(url, opts)
• cy.tabVisit(url, window_name)
• cy.switchToTab(tab_name)
• cy.closeTab(index_or_name) - pass nothing to close active tab
• cy.closeAllTabs()
• cy.visit added support for options.tab_name (defaults to root)
• debugTabHelper

Why?

If you're like me, when you first started using Cypress you fell in love immedately but then were annoyed by some of their opinionated descisions. For example: not supporting switching between "tabs" or pop-up windows. Luckily, vp of eng of Cypress, @bahmutov posted on his peronal Blog and Github repo about frame-busting and "Cypress using child window":

• Original Blog Post
• His cypress-open-child-window Repo
  • My Fork of his Repo
    • My PR "expanded to support switching between the windows and closing the popup and continuing to test against the original context" While there are a few ways to achieve this, i found Dr. Gleb Bahmutov's technique the most straight-forward.

Here is how i've expanded upon that original concept with some convience helpers to keep my tests readable when testing multiple windows:

Note: this only works if you're within the same "baseDomain":

OK:

• base.domain/pageA
• sub.base.domain/pageB

NOT OK:

• some.otherdomain/pageC