react-intl v3升级

趁着周末做下react-intl的类库升级。当前最新版本是v4.6.9,项目使用的版本是v2.3.18,这里决定升级到v3@latest

升级带来的benefit

  1. 修复已知的BUG,原先的版本当我传入de-de,国际化失效,当时的workaround是我将localData的key永远设定为en
  2. 针对localeData部分,体积会减小,因为已经使用了浏览器自带的Intl相关API
  3. withRef迁移到forwardRef,这也是目前组件间引用传递通用的方式,有益于统一
  4. 之前已经做了React,Redux这些主要类库的升级,Intl升级有益于整体架子将来的迭代升级
  5. 之前的国际化方法,比如formatMessage返回的是Node节点,比如包含了Span标签,而v3返回的是文本,严格来说渲染也会降低浏览器的开销,毕竟少了一对节点,当然比如有些国际化地方需要简单的文本,这样就可以直接满足

开源虽免费,版本须谨慎,但永恒不变,对于发展中的WEB技术和本身的产品项目都是不利的,所以还是需要渐进升级。

升级细目

官方也给出了v2=>v3的升级指南,当然升级从来都没那么顺利过,于是这里将关键点一一说明

配置

如何升级呢,看这里,这里罗列了主要的关键点,但比如values类型文件等,根据错误提示,直接替换修改即可。

package.json

1
"react-intl": "^3.12.1"

注意

v3已自带TS类型定义,之前的@types/react-intl需remove

tsconfig.json

1
2
3

"lib": ["es2015", "es2017", "dom", "es2018.intl", "esnext.intl"]

typings.d.ts


因为我拓展全局window属性,将intl实例赋值上去,所以需要如下定义

1
2
3
4
5
6
7
8
import { IntlShape } from 'react-intl';

declare global {
interface Window {
intl: IntlShape;
}
}

注意

  • 假如不需要的,skip该配置
  • declare module '*.svg';declare global两种模块声明存在冲突,需要物理分离成两个声明文件。假如全局声明没有import,则declare global是可以省略的

UT

intl的升级对于UT也是会有影响的,主要在工具函数上,配置如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
import { mount, render, shallow } from 'enzyme';
import React from 'react';
import { createIntl, IntlProvider } from 'react-intl';
import renderer from 'react-test-renderer';

const messages = {}; // en.json

const intl = createIntl({ locale: 'en', messages, onError: () => '' });

function nodeWithIntlProp(node) {
return React.cloneElement(node, { intl });
}

export function mountWithIntl(node) {
return mount(node, {
// @ts-ignore
wrappingComponent: IntlProvider,
wrappingComponentProps: {
locale: 'en',
defaultLocale: 'en',
messages
}
});
}

export function renderWithIntl(node) {
return render(<IntlProvider locale='en' messages={messages} onError={() => ''}>{node}</IntlProvider>);
}

export function rendererWithIntl(node) {
return renderer.create(<IntlProvider locale='en' messages={messages} onError={() => ''}>{node}</IntlProvider>);
}

接口定义修改

InjectedIntlProps=>WrappedComponentProps,
withRef=>forwardRef

全局替换即可,但注意别搞错了。

写在最后

经过如上的配置,升级即可完成。当然这里因为我考虑到系统稳定性,所以没有从v2直接升级v4,但粗略看了下3=>4的变化较小,所以等系统稳定一段时间,再做升级

参考文档