react-i18next documentation

react-i18next documentation

Powered by GitBook
Have an account? Sign in

Testing

Last updated 2 months ago
Edit on GitHub
Contents

For testing purpose of your component you should export the pure component without extending with the withNamespaces hoc and test that:

export MyComponent;
export default withNamespaces('ns')(MyComponent);

In the test, test the myComponent export passing a t function mock:

import { MyComponent } from './myComponent';
​
<MyComponent t={key => key} />

Or use https://github.com/kadirahq/react-stubber to stub i18n functionality:

const tDefault = (key) => key;
const StubbableInterpolate = mayBeStubbed(Interpolate);
const stubInterpolate = function () {
    stub(StubbableInterpolate, (props, context) => {
        const t = (context && context.t) || tDefault;
        return (<span>{t(props.i18nKey)}</span>);
    });
};

Or mock it like:

jest.mock('react-i18next', () => ({
  // this mock makes sure any components using the translate HoC receive the t function as a prop
  withNamespaces: () => Component => {
    Component.defaultProps = { ...Component.defaultProps, t: () => "" };
    return Component;
  },
}));

You can find a full sample for testing with jest here: https://github.com/i18next/react-i18next/tree/master/example/test-jest​

Testing without stubbing

Alternatively, you could also test I18next without stubbing anything, by providing the correct configuration and fully wrapping your container in the provider.

Example configuration for testing

import i18n from 'i18next';
​
i18n
  .init({
    fallbackLng: 'cimode',
    debug: false,
    saveMissing: false,
​
    interpolation: {
      escapeValue: false, // not needed for react!!
    },
​
    // react i18next special options (optional)
    react: {
      wait: false,
      nsMode: 'fallback', // set it to fallback to let passed namespaces to translated hoc act as fallbacks
    },
  });
​
​
export default i18n;

Example test using this configuration

import React from 'react';
import { Provider } from 'react-redux';
import { mount } from 'enzyme';
import { I18nextProvider } from 'react-i18next';
import configureStore from 'redux-mock-store';
import ContactTable from './ContactTable';
import actionTypes from '../constants';
import i18n from '../i18nForTests';
​
const mockStore = configureStore([]);
const store = mockStore({ contacts: [ ] });
​
it('dispatches SORT_TABLE', () => {
  const enzymeWrapper = mount(
    <Provider store={store}>
      <I18nextProvider i18n={i18n}>
        <ContactTable />
      </I18nextProvider>
    </Provider>
  );
  enzymeWrapper.find('.sort').simulate('click');
  const actions = store.getActions();
  expect(actions).toEqual([{ type: actionTypes.SORT_TABLE }]);
});

As translations aren't provided, this.props.i18n.language will be undefined. In case your application relies on that value you can mock resources by adding these lines to the object passed to init:

i18n
  .init({
    ...
    fallbackLng: 'en',
    resources: {
      en: {},
      de: {}
})

Now in your component this.props.i18n.language will return en.

Misc - Previous
Serverside Rendering
Contents