Babel 中文文档
  • 印记中文
  • 文档
  • 配置
  • 试用
  • 视频
  • 博客
  • 赞助
  • 团队
  • GitHub
Edit

@babel/plugin-transform-react-constant-elements

This plugin can speed up reconciliation and reduce garbage collection pressure by hoisting React elements to the highest possible scope, preventing multiple unnecessary reinstantiations.

Example

In

const Hr = () => {
  return <hr className="hr" />;
};

Out

const _ref = <hr className="hr" />;

const Hr = () => {
  return _ref;
};

Deopts

  • Spread Operator

    <div {...foobar} />
    
  • Refs

    <div ref="foobar" />
    <div ref={node => this.node = node} />
    
  • Mutable Properties

See https://github.com/facebook/react/issues/3226 for more on this

<div style={{ width: 100 }} />

Installation

npm install --save-dev @babel/plugin-transform-react-constant-elements

Usage

With a configuration file (Recommended)

{
  "plugins": ["@babel/plugin-transform-react-constant-elements"]
}

Options

allowMutablePropsOnTags

Array<string>, defaults to []

If you are using a particular library (like react-intl) that uses object properties, and you are sure that the element won't modify its own props, you can permit objects to be allowed for specific elements.

This will skip the Mutable Properties deopt.

{
  "plugins": [
    [
      "@babel/plugin-transform-react-constant-elements",
      { "allowMutablePropsOnTags": ["FormattedMessage"] }
    ]
  ]
}

You can read more about configuring plugin options here

Via CLI

babel --plugins @babel/plugin-transform-react-constant-elements script.js

Via Node API

require("@babel/core").transformSync("code", {
  plugins: ["@babel/plugin-transform-react-constant-elements"],
});

References

  • [facebook/react#3226] Optimizing Compiler: Reuse Constant Value Types like ReactElement
  • Example
  • Installation
  • Usage
    • With a configuration file (Recommended)
  • Options
    • allowMutablePropsOnTags
    • Via CLI
    • Via Node API
  • References
Babel 中文文档
文档
学习 ES2015
社区
视频用户Stack OverflowSlack 频道Twitter
更多
博客GitHub 组织GitHub 仓库Website 仓库旧版网址 6.x旧版网址 5.x