/** * Copyright 2013-present, Facebook, Inc. * All rights reserved. * * This source code is licensed under the BSD-style license found in the * LICENSE file in the root directory of this source tree. An additional grant * of patent rights can be found in the PATENTS file in the same directory. * * @emails react-core */ 'use strict'; var React; var ReactDOM; var ReactTestUtils; var createReactClass; // For testing DOM Fiber. global.requestAnimationFrame = function(callback) { setTimeout(callback); }; global.requestIdleCallback = function(callback) { setTimeout(() => { callback({ timeRemaining() { return Infinity; } }); }); }; describe('ReactClass-spec', () => { beforeEach(() => { React = require('react'); ReactDOM = require('react-dom'); ReactTestUtils = require('react-addons-test-utils'); createReactClass = require('./index'); }); it('should throw when `render` is not specified', () => { expect(function() { createReactClass({}); }).toThrowError( 'createClass(...): Class specification must implement a `render` method.' ); }); // TODO: Update babel-plugin-transform-react-display-name xit('should copy `displayName` onto the Constructor', () => { var TestComponent = createReactClass({ render: function() { return
; }, }); expect(TestComponent.displayName) .toBe('TestComponent'); }); it('should copy prop types onto the Constructor', () => { var propValidator = jest.fn(); var TestComponent = createReactClass({ propTypes: { value: propValidator, }, render: function() { return
; }, }); expect(TestComponent.propTypes).toBeDefined(); expect(TestComponent.propTypes.value) .toBe(propValidator); }); it('should warn on invalid prop types', () => { spyOn(console, 'error'); createReactClass({ displayName: 'Component', propTypes: { prop: null, }, render: function() { return {this.props.prop}; }, }); expect(console.error.calls.count()).toBe(1); expect(console.error.calls.argsFor(0)[0]).toBe( 'Warning: Component: prop type `prop` is invalid; ' + 'it must be a function, usually from React.PropTypes.' ); }); it('should warn on invalid context types', () => { spyOn(console, 'error'); createReactClass({ displayName: 'Component', contextTypes: { prop: null, }, render: function() { return {this.props.prop}; }, }); expect(console.error.calls.count()).toBe(1); expect(console.error.calls.argsFor(0)[0]).toBe( 'Warning: Component: context type `prop` is invalid; ' + 'it must be a function, usually from React.PropTypes.' ); }); it('should throw on invalid child context types', () => { spyOn(console, 'error'); createReactClass({ displayName: 'Component', childContextTypes: { prop: null, }, render: function() { return {this.props.prop}; }, }); expect(console.error.calls.count()).toBe(1); expect(console.error.calls.argsFor(0)[0]).toBe( 'Warning: Component: child context type `prop` is invalid; ' + 'it must be a function, usually from React.PropTypes.' ); }); it('should warn when mispelling shouldComponentUpdate', () => { spyOn(console, 'error'); createReactClass({ componentShouldUpdate: function() { return false; }, render: function() { return
; }, }); expect(console.error.calls.count()).toBe(1); expect(console.error.calls.argsFor(0)[0]).toBe( 'Warning: A component has a method called componentShouldUpdate(). Did you ' + 'mean shouldComponentUpdate()? The name is phrased as a question ' + 'because the function is expected to return a value.' ); createReactClass({ displayName: 'NamedComponent', componentShouldUpdate: function() { return false; }, render: function() { return
; }, }); expect(console.error.calls.count()).toBe(2); expect(console.error.calls.argsFor(1)[0]).toBe( 'Warning: NamedComponent has a method called componentShouldUpdate(). Did you ' + 'mean shouldComponentUpdate()? The name is phrased as a question ' + 'because the function is expected to return a value.' ); }); it('should warn when mispelling componentWillReceiveProps', () => { spyOn(console, 'error'); createReactClass({ componentWillRecieveProps: function() { return false; }, render: function() { return
; }, }); expect(console.error.calls.count()).toBe(1); expect(console.error.calls.argsFor(0)[0]).toBe( 'Warning: A component has a method called componentWillRecieveProps(). Did you ' + 'mean componentWillReceiveProps()?' ); }); it('should throw if a reserved property is in statics', () => { expect(function() { createReactClass({ statics: { getDefaultProps: function() { return { foo: 0, }; }, }, render: function() { return ; }, }); }).toThrowError( 'ReactClass: You are attempting to define a reserved property, ' + '`getDefaultProps`, that shouldn\'t be on the "statics" key. Define ' + 'it as an instance property instead; it will still be accessible on ' + 'the constructor.' ); }); // TODO: Consider actually moving these to statics or drop this unit test. xit('should warn when using deprecated non-static spec keys', () => { spyOn(console, 'error'); createReactClass({ mixins: [{}], propTypes: { foo: React.PropTypes.string, }, contextTypes: { foo: React.PropTypes.string, }, childContextTypes: { foo: React.PropTypes.string, }, render: function() { return
; }, }); expect(console.error.calls.count()).toBe(4); expect(console.error.calls.argsFor(0)[0]).toBe( 'createClass(...): `mixins` is now a static property and should ' + 'be defined inside "statics".' ); expect(console.error.calls.argsFor(1)[0]).toBe( 'createClass(...): `propTypes` is now a static property and should ' + 'be defined inside "statics".' ); expect(console.error.calls.argsFor(2)[0]).toBe( 'createClass(...): `contextTypes` is now a static property and ' + 'should be defined inside "statics".' ); expect(console.error.calls.argsFor(3)[0]).toBe( 'createClass(...): `childContextTypes` is now a static property and ' + 'should be defined inside "statics".' ); }); it('should support statics', () => { var Component = createReactClass({ statics: { abc: 'def', def: 0, ghi: null, jkl: 'mno', pqr: function() { return this; }, }, render: function() { return ; }, }); var instance = ; instance = ReactTestUtils.renderIntoDocument(instance); expect(instance.constructor.abc).toBe('def'); expect(Component.abc).toBe('def'); expect(instance.constructor.def).toBe(0); expect(Component.def).toBe(0); expect(instance.constructor.ghi).toBe(null); expect(Component.ghi).toBe(null); expect(instance.constructor.jkl).toBe('mno'); expect(Component.jkl).toBe('mno'); expect(instance.constructor.pqr()).toBe(Component); expect(Component.pqr()).toBe(Component); }); it('should work with object getInitialState() return values', () => { var Component = createReactClass({ getInitialState: function() { return { occupation: 'clown', }; }, render: function() { return ; }, }); var instance = ; instance = ReactTestUtils.renderIntoDocument(instance); expect(instance.state.occupation).toEqual('clown'); }); it('renders based on context getInitialState', () => { var Foo = createReactClass({ contextTypes: { className: React.PropTypes.string, }, getInitialState() { return {className: this.context.className}; }, render() { return ; }, }); var Outer = createReactClass({ childContextTypes: { className: React.PropTypes.string, }, getChildContext() { return {className: 'foo'}; }, render() { return ; }, }); var container = document.createElement('div'); ReactDOM.render(, container); expect(container.firstChild.className).toBe('foo'); }); it('should throw with non-object getInitialState() return values', () => { spyOn(console, 'error'); [['an array'], 'a string', 1234].forEach(function(state) { var Component = createReactClass({ getInitialState: function() { return state; }, render: function() { return ; }, }); var instance = ; expect(function() { instance = ReactTestUtils.renderIntoDocument(instance); }).toThrowError( 'Component.getInitialState(): must return an object or null' ); }); }); it('should work with a null getInitialState() return value', () => { var Component = createReactClass({ getInitialState: function() { return null; }, render: function() { return ; }, }); expect( () => ReactTestUtils.renderIntoDocument() ).not.toThrow(); }); it('should throw when using legacy factories', () => { spyOn(console, 'error'); var Component = createReactClass({ render() { return
; }, }); expect(() => Component()).toThrow(); expect(console.error.calls.count()).toBe(1); expect(console.error.calls.argsFor(0)[0]).toBe( 'Warning: Something is calling a React component directly. Use a ' + 'factory or JSX instead. See: https://fb.me/react-legacyfactory' ); }); it('replaceState and callback works', () => { var ops = []; var Component = createReactClass({ getInitialState() { return { step: 0 }; }, render() { ops.push('Render: ' + this.state.step); return
; } }); var instance = ReactTestUtils.renderIntoDocument(); instance.replaceState({ step: 1 }, () => { ops.push('Callback: ' + instance.state.step); }); expect(ops).toEqual([ 'Render: 0', 'Render: 1', 'Callback: 1', ]); }); it('isMounted works', () => { spyOn(console, 'error'); var ops = []; var instance; var Component = createReactClass({ displayName: 'MyComponent', log(name) { ops.push(`${name}: ${this.isMounted()}`); }, getInitialState() { this.log('getInitialState'); return {}; }, componentWillMount() { this.log('componentWillMount'); }, componentDidMount() { this.log('componentDidMount'); }, componentWillUpdate() { this.log('componentWillUpdate'); }, componentDidUpdate() { this.log('componentDidUpdate'); }, componentWillUnmount() { this.log('componentWillUnmount'); }, render() { instance = this; this.log('render'); return
; } }); var container = document.createElement('div'); ReactDOM.render(, container); ReactDOM.render(, container); ReactDOM.unmountComponentAtNode(container); instance.log('after unmount'); expect(ops).toEqual([ 'getInitialState: false', 'componentWillMount: false', 'render: false', 'componentDidMount: true', 'componentWillUpdate: true', 'render: true', 'componentDidUpdate: true', 'componentWillUnmount: false', 'after unmount: false', ]); expect(console.error.calls.count()).toBe(1); expect(console.error.calls.argsFor(0)[0]).toEqual( 'Warning: MyComponent: isMounted is deprecated. Instead, make sure to ' + 'clean up subscriptions and pending requests in componentWillUnmount ' + 'to prevent memory leaks.' ); }); });