/** * Copyright (c) 2013-present, Facebook, Inc. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. * * @emails react-core */ 'use strict'; var PropTypes; var React; var ReactDOM; var createReactClass; // Catch stray warnings var env = jasmine.getEnv(); var callCount = 0; var oldError = console.error; var newError = function() { callCount++; oldError.apply(this, arguments); }; console.error = newError; env.beforeEach(() => { callCount = 0; jasmine.addMatchers({ toBeReset() { return { compare(actual) { if (actual !== newError && !jasmine.isSpy(actual)) { return { pass: false, message: 'Test did not tear down console.error mock properly.' }; } return {pass: true}; } }; }, toNotHaveBeenCalled() { return { compare(actual) { return { pass: callCount === 0, message: 'Expected test not to warn. If the warning is expected, mock ' + "it out using spyOn(console, 'error'); and test that the " + 'warning occurs.' }; } }; } }); }); env.afterEach(() => { expect(console.error).toBeReset(); expect(console.error).toNotHaveBeenCalled(); }); // Suppress warning expectations for prod builds function suppressDevMatcher(obj, name) { const original = obj[name]; obj[name] = function devMatcher() { try { original.apply(this, arguments); } catch (e) { // skip } }; } function expectDev(actual) { const expectation = expect(actual); if (process.env.NODE_ENV === 'production') { Object.keys(expectation).forEach(name => { suppressDevMatcher(expectation, name); suppressDevMatcher(expectation.not, name); }); } return expectation; } function renderIntoDocument(element) { var node = document.createElement('div'); return ReactDOM.render(element, node); } describe('ReactClass-spec', () => { beforeEach(() => { PropTypes = require('prop-types'); React = require('react'); ReactDOM = require('react-dom'); createReactClass = require(process.env.TEST_ENTRY); }); 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}; } }); expectDev(console.error.calls.count()).toBe(1); expectDev(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}; } }); expectDev(console.error.calls.count()).toBe(1); expectDev(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}; } }); expectDev(console.error.calls.count()).toBe(1); expectDev(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 ; } }); expectDev(console.error.calls.count()).toBe(1); expectDev(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 ; } }); expectDev(console.error.calls.count()).toBe(2); expectDev(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 ; } }); expectDev(console.error.calls.count()).toBe(1); expectDev(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: PropTypes.string }, contextTypes: { foo: PropTypes.string }, childContextTypes: { foo: PropTypes.string }, render: function() { return ; } }); expectDev(console.error.calls.count()).toBe(4); expectDev(console.error.calls.argsFor(0)[0]).toBe( 'createClass(...): `mixins` is now a static property and should ' + 'be defined inside "statics".' ); expectDev(console.error.calls.argsFor(1)[0]).toBe( 'createClass(...): `propTypes` is now a static property and should ' + 'be defined inside "statics".' ); expectDev(console.error.calls.argsFor(2)[0]).toBe( 'createClass(...): `contextTypes` is now a static property and ' + 'should be defined inside "statics".' ); expectDev(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 =