jsdoc unmount function

Author: bahmutov

cypress/component/basic/unmount/README.md

@@ -0,0 +1,19 @@
+# unmount
+
+If you need to test what the component is doing when it is being unmounted, use `unmount` function.
+
+```js
+import { mount, unmount } from 'cypress-react-unit-test'
+it('calls unmount prop', () => {
+  mount(...)
+  // cy commands
+  // now let's unmount
+  cy.then(unmount)
+
+  // confirm the component has been unmounted
+  // and performed everything needed in its
+  // componentWillUnmount method
+})
+```
+
+See [unmount-spec.js](unmount-spec.js) and [comp-spec.js](comp-spec.js)

cypress/component/basic/unmount/unmount-spec.js

@@ -0,0 +1,33 @@
+/// <reference types="cypress" />
+import React, { Component } from 'react'
+import { mount, unmount } from 'cypress-react-unit-test'
+
+class Comp extends Component {
+  componentWillUnmount() {
+    // simply calls the prop
+    this.props.onUnmount()
+  }
+
+  render() {
+    return <div>My component</div>
+  }
+}
+
+describe('Comp with componentWillUnmount', () => {
+  it('calls the prop', () => {
+    mount(<Comp onUnmount={cy.stub().as('onUnmount')} />)
+    cy.contains('My component')
+
+    // after we have confirmed the component exists
+    // we can remove it asynchronously
+    cy.then(() => {
+      // now unmount the mounted component
+      unmount()
+    })
+
+    // the component is gone from the DOM
+    cy.contains('My component').should('not.exist')
+    // the component has called the prop on unmount
+    cy.get('@onUnmount').should('have.been.calledOnce')
+  })
+})

lib/index.ts

@@ -130,6 +130,16 @@ export const mount = (jsx: React.ReactElement, options: MountOptions = {}) => {
 
 /**
  * Removes any mounted component
+ * @see https://github.com/bahmutov/cypress-react-unit-test/tree/master/cypress/component/basic/unmount
+ * @example
+  ```
+  import { mount, unmount } from 'cypress-react-unit-test'
+  it('works', () => {
+    mount(...)
+    // whenever you want to unmount
+    cy.then(unmount)
+  })
+  ```
  */
 export const unmount = () => {
   checkMountModeEnabled()