React:不要动,否则你会被炒鱿鱼

11,889 阅读4分钟

大家好,我卡颂。

不知道大家在用React开发时,有没有注意到reactreact-dom这两个包中有个很奇葩的属性__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED

直译过来就是内部神秘属性,不要乱用!否则你会被炒鱿鱼

为什么会有个这么唬人的属性?今天我们来聊聊。

欢迎加入人类高质量前端框架研究群,带飞

React项目架构

我们在项目中习惯使用如下语句引入Hook

import {useState} from 'react';

这是不是意味着所有Hook的具体实现都在react这个包中?实际不是的。

所有Hook的具体实现在ReactFiberHooks.new.js方法中,该方法来自于react-reconciler这个包。

那为什么我们项目中从来没有主动引入过这个包呢?因为react-reconciler中被使用的部分,被打包进react-dom中了。

简单来说,React为了实现跨平台渲染,采用的是一个主模块 + 一个渲染器的模式。

其中主模块就是react包,他提供了所有通用方法。

渲染器针对宿主环境不同而不同,比如:

  • 浏览器环境使用ReactDOM/client渲染器

  • SSR使用ReactDOM/server渲染器

  • Native环境使用ReactNative渲染器

渲染器除了宿主环境相关的代码外,还有大量通用逻辑(比如Diff算法)。

所以可以认为,react-dom是由如下多个包中被使用的部分打包而成:

  • shared,一个存放通用方法的包

  • react-reconciler,提供包括Hooks的实现、Diff算法、优先级调度等更新相关功能

  • react-dom,提供宿主环境方法,比如DOM的增/移动/删/改

  • 等等其他包

这也是为什么宿主环境千差万别,但都能通过执行useState改变状态,触发视图更新。

原因在于 —— Hooks的实现宿主环境操作视图的方法被打包进了同一个包中。

既然Hooks的实现被打包进react-dom(或其他宿主环境对应的包)中,那如何做到最终使用时是从react中导出的呢?就像这样:

// 而不是 from 'react-dom'
import {useState} from 'react';

这就用到了开篇提到的变量__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED

内部结构

可以认为,当React团队希望在react宿主环境对应的包之间共享数据时,就会把他保存在这个神秘的内部变量中。

比如上文提到的,Hook的具体实现

再比如,object.assign方法的polyfill,在reactreact-dom中都会用到,但如果两个包中分别引入,再分别打包,那么polyfill的代码会重复出现在reactreact-dom两个包中。

为了减少重复代码,react会引入object.assign方法的polyfill,再将它保存在神秘的内部变量中。

react作为react-dompeerDependencies,当项目中引入这两个包后,react-dom内部使用的object.assign实际来自react

// react-dom包内部
const react = require('react');
const { assign } = react.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;

常见问题

了解了神秘的内部变量的作用,我们再来看看这种实现会造成的问题。

假设我们有2个项目:

  • 组件库项目A,负责开发组件

  • 业务项目B,依赖A

B安装依赖后,A会出现在B的node_modules中。

为了调试方便,我们用npm link功能将B中依赖的A由B的node_modules中的A改为组件库项目A

npm link后,B中业务代码使用的useState来自于B的node_modules中的react

而B中引入的组件库A的组件中使用的useState来自于A的node_modules中的react

不同的react对应不同的__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,最终对应不同的react-dom

这就会造成报错。

解决办法是在项目中为react增加别名(alias),使项目中所有用到react的地方都指向同一个react

总结

本文我们了解了reactreact-dom中神秘的内部变量__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED的作用。

他能够在这两个包之间传递共享的数据。

需要注意的一点是,如果你也想用这种方式在两个包之间共享数据,需要将其中一个包设为另一个包的peerDependencies

否则,在打包时,被共享的数据只会在两个包中分别存在一份。

我正在参与掘金技术社区创作者签约计划招募活动,点击链接报名投稿