[enzyme-adapter-react-*, enzyme-adapter-utils] [fix] mount: ensure the root’s ref prop gets attached to the actual root

Fixes #2253.

Author: ljharb

packages/enzyme-adapter-react-13/src/ReactThirteenAdapter.js

@@ -129,7 +129,7 @@ class ReactThirteenAdapter extends EnzymeAdapter {
             Component: type,
             props,
             context,
-            ...(ref && { ref }),
+            ...(ref && { refProp: ref }),
           };
           const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
           const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-react-14/src/ReactFourteenAdapter.js

@@ -110,7 +110,7 @@ class ReactFourteenAdapter extends EnzymeAdapter {
             wrappingComponentProps: options.wrappingComponentProps,
             props,
             context,
-            ...(ref && { ref }),
+            ...(ref && { refProp: ref }),
           };
           const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
           const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-react-15.4/src/ReactFifteenFourAdapter.js

@@ -145,7 +145,7 @@ class ReactFifteenFourAdapter extends EnzymeAdapter {
             wrappingComponentProps: options.wrappingComponentProps,
             props,
             context,
-            ...(ref && { ref }),
+            ...(ref && { refProp: ref }),
           };
           const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
           const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-react-15/src/ReactFifteenAdapter.js

@@ -145,7 +145,7 @@ class ReactFifteenAdapter extends EnzymeAdapter {
             wrappingComponentProps: options.wrappingComponentProps,
             props,
             context,
-            ...(ref && { ref }),
+            ...(ref && { refProp: ref }),
           };
           const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
           const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-react-16.1/src/ReactSixteenOneAdapter.js

@@ -278,7 +278,7 @@ class ReactSixteenOneAdapter extends EnzymeAdapter {
             props,
             wrappingComponentProps,
             context,
-            ...(ref && { ref }),
+            ...(ref && { refProp: ref }),
           };
           const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
           const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-react-16.2/src/ReactSixteenTwoAdapter.js

@@ -280,7 +280,7 @@ class ReactSixteenTwoAdapter extends EnzymeAdapter {
             props,
             wrappingComponentProps,
             context,
-            ...(ref && { ref }),
+            ...(ref && { refProp: ref }),
           };
           const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
           const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-react-16.3/src/ReactSixteenThreeAdapter.js

@@ -299,7 +299,7 @@ class ReactSixteenThreeAdapter extends EnzymeAdapter {
             props,
             wrappingComponentProps,
             context,
-            ...(ref && { ref }),
+            ...(ref && { refProp: ref }),
           };
           const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
           const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-react-16/src/ReactSixteenAdapter.js

@@ -421,7 +421,7 @@ class ReactSixteenAdapter extends EnzymeAdapter {
               props,
               wrappingComponentProps,
               context,
-              ...(ref && { ref }),
+              ...(ref && { refProp: ref }),
             };
             const ReactWrapperComponent = createMountWrapper(el, { ...options, adapter });
             const wrappedEl = React.createElement(ReactWrapperComponent, wrapperProps);

packages/enzyme-adapter-utils/src/createMountWrapper.jsx

@@ -1,5 +1,6 @@
 import React from 'react';
 import PropTypes from 'prop-types';
+import { ref } from 'airbnb-prop-types';
 import RootFinder from './RootFinder';
 
 /* eslint react/forbid-prop-types: 0 */
@@ -68,11 +69,11 @@ export default function createMountWrapper(node, options = {}) {
     }
 
     render() {
-      const { Component } = this.props;
+      const { Component, refProp } = this.props;
       const { mount, props, wrappingComponentProps } = this.state;
       if (!mount) return null;
       // eslint-disable-next-line react/jsx-props-no-spreading
-      const component = <Component {...props} />;
+      const component = <Component ref={refProp} {...props} />;
       if (WrappingComponent) {
         return (
           // eslint-disable-next-line react/jsx-props-no-spreading
@@ -86,11 +87,13 @@ export default function createMountWrapper(node, options = {}) {
   }
   WrapperComponent.propTypes = {
     Component: makeValidElementType(adapter).isRequired,
+    refProp: PropTypes.oneOfType([PropTypes.string, ref()]),
     props: PropTypes.object.isRequired,
     wrappingComponentProps: PropTypes.object,
     context: PropTypes.object,
   };
   WrapperComponent.defaultProps = {
+    refProp: null,
     context: null,
     wrappingComponentProps: null,
   };

packages/enzyme-test-suite/test/ReactWrapper-spec.jsx

@@ -104,10 +104,43 @@ describeWithDOM('mount', () => {
 </div>`);
     });
 
-    it('calls ref', () => {
-      const spy = sinon.spy();
-      mount(<div ref={spy} />);
-      expect(spy).to.have.property('callCount', 1);
+    describeWithDOM('refs', () => {
+      it('calls ref', () => {
+        const spy = sinon.spy();
+        mount(<div ref={spy} />);
+        expect(spy).to.have.property('callCount', 1);
+      });
+
+      /* global HTMLElement */
+
+      it('passes an HTML element to `ref` when root rendered', () => {
+        const spy = sinon.spy();
+        mount(<div ref={spy} />);
+        expect(spy).to.have.property('callCount', 1);
+
+        // sanity check
+        expect(document.createElement('div')).to.be.instanceOf(HTMLElement);
+
+        const [[firstArg]] = spy.args;
+        expect(firstArg).to.be.instanceOf(HTMLElement);
+      });
+
+      it('passes an HTML element to `ref` when sub-rendered', () => {
+        const spy = sinon.spy();
+        class Foo extends React.Component {
+          render() {
+            return <div ref={spy} />;
+          }
+        }
+        mount(<Foo />);
+        expect(spy).to.have.property('callCount', 1);
+
+        // sanity check
+        expect(document.createElement('div')).to.be.instanceOf(HTMLElement);
+
+        const [[firstArg]] = spy.args;
+        expect(firstArg).to.be.instanceOf(HTMLElement);
+      });
     });
 
     describe('wrapping invalid elements', () => {