大家好,我卡颂。
不知道大家在用React
开发时,有没有注意到react
与react-dom
这两个包中有个很奇葩的属性__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED
:
直译过来就是内部神秘属性,不要乱用!否则你会被炒鱿鱼。
为什么会有个这么唬人的属性?今天我们来聊聊。
React项目架构
我们在项目中习惯使用如下语句引入Hook
:
1 | 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
中导出的呢?就像这样:
1 | // 而不是 from 'react-dom' |
这就用到了开篇提到的变量__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED
。
内部结构
可以认为,当React
团队希望在react
与宿主环境对应的包之间共享数据时,就会把他保存在这个神秘的内部变量中。
比如上文提到的,Hook的具体实现。
再比如,object.assign
方法的polyfill
,在react
与react-dom
中都会用到,但如果两个包中分别引入,再分别打包,那么polyfill
的代码会重复出现在react
与react-dom
两个包中。
为了减少重复代码,react
会引入object.assign
方法的polyfill
,再将它保存在神秘的内部变量中。
react
作为react-dom
的peerDependencies
,当项目中引入这两个包后,react-dom
内部使用的object.assign
实际来自react
:
1 | // react-dom包内部 |
常见问题
了解了神秘的内部变量的作用,我们再来看看这种实现会造成的问题。
假设我们有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
。
总结
本文我们了解了react
与react-dom
中神秘的内部变量__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED
的作用。
他能够在这两个包之间传递共享的数据。
需要注意的一点是,如果你也想用这种方式在两个包之间共享数据,需要将其中一个包设为另一个包的peerDependencies
。
否则,在打包时,被共享的数据只会在两个包中分别存在一份。