React前端開發(fā)createElement源碼解讀
React 與 Babel
元素標(biāo)簽轉(zhuǎn)譯
用過(guò) React 的同學(xué)都知道,當(dāng)我們這樣寫時(shí):
<div id="foo">bar</div>
Babel 會(huì)將其轉(zhuǎn)譯為:
React.createElement("div", {id: "foo"}, "bar");
我們會(huì)發(fā)現(xiàn),createElement 的第一個(gè)參數(shù)是元素類型,第二個(gè)參數(shù)是元素屬性,第三個(gè)參數(shù)是子元素
組件轉(zhuǎn)譯
如果我們用的是一個(gè)組件呢?
function Foo({id}) {
return <div id={id}>foo</div>
}
<Foo id="foo">
<div id="bar">bar</div>
</Foo>
Babel 則會(huì)將其轉(zhuǎn)譯為:
function Foo({id}) {
return React.createElement("div", {id: id}, "foo")}
React.createElement(Foo, {id: "foo"},
React.createElement("div", {id: "bar"}, "bar")
);
我們會(huì)發(fā)現(xiàn),createElement 的第一個(gè)參數(shù)傳入的是變量 Foo
子元素轉(zhuǎn)譯
如果我們有多個(gè)子元素呢?
<div id="foo"> <div id="bar">bar</div> <div id="baz">baz</div> <div id="qux">qux</div> </div>
Babel 則會(huì)將其轉(zhuǎn)譯為:
React.createElement("div", { id: "foo"},
React.createElement("div", {id: "bar"}, "bar"),
React.createElement("div", {id: "baz"}, "baz"),
React.createElement("div", {id: "qux"}, "qux")
);
我們會(huì)發(fā)現(xiàn),子元素其實(shí)是作為參數(shù)不斷追加傳入到函數(shù)中
createElement
那 React.createElement 到底做了什么呢?
源碼
我們查看 React 的 GitHub 倉(cāng)庫(kù):github.com/facebook/re…,查看 pacakges/react/index.js文件,可以看到 createElement 的定義在 ./src/React文件:
// 簡(jiǎn)化后
export {createElement} from './src/React';
我們打開 ./src/React.js文件:
import {
createElement as createElementProd
} from './ReactElement';
const createElement = __DEV__
? createElementWithValidation
: createElementProd;
export { createElement };
繼續(xù)查看 ./ReactElement.js文件,在這里終于找到最終的定義,鑒于這里代碼較長(zhǎng),我們將代碼極度簡(jiǎn)化一下:
const RESERVED_PROPS = {
key: true,
ref: true,
__self: true,
__source: true,
};
export function createElement(type, config, ...children) {
let propName;
// Reserved names are extracted
const props = {};
// 第一段
let key = '' + config.key;
let ref = config.ref;
let self = config.__self;
let source = config.__source;
// 第二段
for (propName in config) {
if (config.hasOwnProperty(propName) && !RESERVED_PROPS.hasOwnProperty(propName)) {
props[propName] = config[propName];
}
}
// 第三段
props.children = children;
// 第四段
if (type && type.defaultProps) {
const defaultProps = type.defaultProps;
for (propName in defaultProps) {
if (props[propName] === undefined) {
props[propName] = defaultProps[propName];
}
}
}
// 第五段
return ReactElement(
type,
key,
ref,
self,
source,
ReactCurrentOwner.current,
props,
);
}
這里可以看出,createElement 函數(shù)主要是做了一個(gè)預(yù)處理,然后將處理好的數(shù)據(jù)傳入 ReactElement 函數(shù)中,我們先分析下 createElement 做了什么。
函數(shù)入?yún)?/h3>
我們以最一開始的例子為例:
<div id="foo">bar</div>
// 轉(zhuǎn)譯為
React.createElement("div", {id: "foo"}, "bar");
對(duì)于createElement 的三個(gè)形參,其中type 表示類型,既可以是標(biāo)簽名字符串(如 div 或 span),也可以是 React 組件(如 Foo)
config 表示傳入的屬性,children 表示子元素
第一段代碼 __self 和 __source
現(xiàn)在我們開始看第一段代碼:
// 第一段 let key = '' + config.key; let ref = config.ref; let self = config.__self; let source = config.__source;
可以看到在 createElement 函數(shù)內(nèi)部,key、ref、__self、__source 這四個(gè)參數(shù)是單獨(dú)獲取并處理的,key 和 ref 很好理解,__self 和 __source 是做什么用的呢?
通過(guò)這個(gè) issue,我們了解到,__self 和 __source 是 babel-preset-react注入的調(diào)試信息,可以提供更有用的錯(cuò)誤信息。
我們查看 babel-preset-react 的文檔,可以看到:
development
boolean 類型,默認(rèn)值為 false. 這可以用于開啟特定于開發(fā)環(huán)境的某些行為,例如添加 __source 和 __self。 在與 env 參數(shù) 配置或 js 配置文件 配合使用時(shí),此功能很有用。
如果我們?cè)囍_啟 development 參數(shù),就會(huì)看到 __self 和 __source 參數(shù),依然以 <div id="foo">bar</div> 為例,會(huì)被 Babel 轉(zhuǎn)譯成:
var _jsxFileName = "/Users/kevin/Desktop/react-app/src/index.js";
React.createElement("div", {
id: "foo",
__self: this,
__source: {
fileName: _jsxFileName,
lineNumber: 5,
columnNumber: 13
}
}, "bar");
第二段代碼 props 對(duì)象
現(xiàn)在我們看第二段代碼:
// 第二段
for (propName in config) {
if (config.hasOwnProperty(propName) && !RESERVED_PROPS.hasOwnProperty(propName)) {
props[propName] = config[propName];
}
}
這段代碼實(shí)現(xiàn)的功能很簡(jiǎn)單,就是構(gòu)建一個(gè) props 對(duì)象,去除傳入的 key、ref、__self、__source屬性,這就是為什么在組件中,我們明明傳入了 key 和ref,但我們無(wú)法通過(guò) this.props.key 或者 this.props.ref 來(lái)獲取傳入的值,就是因?yàn)樵谶@里被去除掉了。
而之所以去除,React 給出的解釋是,key 和 ref 是用于 React 內(nèi)部處理的,如果你想用比如 key 值,你可以再傳一個(gè)其他屬性,用跟 key 相同的值即可。
第三段代碼 children
現(xiàn)在我們看第三段代碼,這段代碼被精簡(jiǎn)的很簡(jiǎn)單:
// 第三段 props.children = children;
這是其實(shí)是因?yàn)槲覀優(yōu)榱撕?jiǎn)化代碼,用了 ES6 的擴(kuò)展運(yùn)算法,實(shí)際的源碼里會(huì)復(fù)雜且有一些差別:
const childrenLength = arguments.length - 2;
if (childrenLength === 1) {
props.children = children;
} else if (childrenLength > 1) {
const childArray = Array(childrenLength);
for (let i = 0; i < childrenLength; i++) {
childArray[i] = arguments[i + 2];
}
props.children = childArray;
}
我們也可以發(fā)現(xiàn),當(dāng)只有一個(gè)子元素的時(shí)候,children 其實(shí)會(huì)直接賦值給 props.children,也就是說(shuō),當(dāng)只有一個(gè)子元素時(shí),children 是一個(gè)對(duì)象(React 元素),當(dāng)有多個(gè)子元素時(shí),children 是一個(gè)包含對(duì)象(React 元素)的數(shù)組。
第四段代碼 defaultProps
現(xiàn)在我們看第四段代碼:
// 第四段
if (type && type.defaultProps) {
const defaultProps = type.defaultProps;
for (propName in defaultProps) {
if (props[propName] === undefined) {
props[propName] = defaultProps[propName];
}
}
}
這段其實(shí)是處理組件的defaultProps,無(wú)論是函數(shù)組件還是類組件都支持 defaultProps,舉個(gè)使用例子:
// 函數(shù)組件
function Foo({id}) {
return <div id={id}>foo</div>
}
Foo.defaultProps = {
id: 'foo'
}
// 類組件
class Header extends Component {
static defaultProps = {
id: 'foo'
}
render () {
const { id } = this.props
return <div id={id}>foo</div>
}
}
第五段代碼 owner
現(xiàn)在我們看第五段代碼:
// 第五段
return ReactElement(
type,
key,
ref,
self,
source,
ReactCurrentOwner.current,
props,
);
這段就是把前面處理好的 type、key 等值傳入 ReactElement 函數(shù)中,那 ReactCurrentOwner.current是個(gè)什么鬼?
我們根據(jù)引用地址查看 ReactCurrentOwner定義的文件:
/**
* Keeps track of the current owner.
*
* The current owner is the component who should own any components that are
* currently being constructed.
*/
const ReactCurrentOwner = {
/**
* @internal
* @type {ReactComponent}
*/
current: null,
};
export default ReactCurrentOwner;
其初始的定義非常簡(jiǎn)單,根據(jù)注釋,我們可以了解到 ReactCurrentOwner.current 就是指向處于構(gòu)建過(guò)程中的組件的 owner,具體作用在以后的文章中還有介紹,現(xiàn)在可以簡(jiǎn)單的理解為,它就是用于記錄臨時(shí)變量。
ReactElement
源碼
現(xiàn)在我們開始看 ReactElement 函數(shù),其實(shí)這個(gè)函數(shù)的內(nèi)容更簡(jiǎn)單,代碼精簡(jiǎn)后如下:
const ReactElement = function(type, key, ref, self, source, owner, props) {
const element = {
// This tag allows us to uniquely identify this as a React Element
$$typeof: REACT_ELEMENT_TYPE,
// Built-in properties that belong on the element
type: type,
key: key,
ref: ref,
props: props,
// Record the component responsible for creating this element.
_owner: owner,
};
return element;
};
如你所見(jiàn),它就是返回一個(gè)對(duì)象,這個(gè)對(duì)象包括 $$typeof、type、key 等屬性,這個(gè)對(duì)象就被稱為 “React 元素”。它描述了我們?cè)谄聊簧峡吹降膬?nèi)容。React 會(huì)通過(guò)讀取這些對(duì)象,使用它們構(gòu)建和更新 DOM
REACT_ELEMENT_TYPE
而 REACT_ELEMENT_TYPE 查看引用的 packages/shared/ReactSymbols 文件,可以發(fā)現(xiàn)它就是一個(gè)唯一常量值,用于標(biāo)示是 React 元素節(jié)點(diǎn)
export const REACT_ELEMENT_TYPE = Symbol.for('react.element');
那還有其他類型的節(jié)點(diǎn)嗎? 查看這個(gè)定義 REACT_ELEMENT_TYPE 的文件,我們發(fā)現(xiàn)還有:
export const REACT_PORTAL_TYPE: symbol = Symbol.for('react.portal');
export const REACT_FRAGMENT_TYPE: symbol = Symbol.for('react.fragment');
export const REACT_STRICT_MODE_TYPE: symbol = Symbol.for('react.strict_mode');
export const REACT_PROFILER_TYPE: symbol = Symbol.for('react.profiler');
export const REACT_PROVIDER_TYPE: symbol = Symbol.for('react.provider');
export const REACT_CONTEXT_TYPE: symbol = Symbol.for('react.context');
// ...
你可能會(huì)自然的理解為 $$typeof 還可以設(shè)置為 REACT_FRAGMENT_TYPE等值。
我們可以寫代碼實(shí)驗(yàn)一下,比如使用 Portal,打印一下返回的對(duì)象:
import ReactDOM from 'react-dom/client';
import {createPortal} from 'react-dom'
const root = ReactDOM.createRoot(document.getElementById('root'));
function Modal() {
const portalObject = createPortal(<div id="foo">foo</div>, document.getElementById("root2"));
console.log(portalObject)
return portalObject
}
root.render(<Modal />);
打印的對(duì)象為:

它的 $$typeof 確實(shí)是 REACT_PORTAL_TYPE
而如果我們使用 Fragment:
import ReactDOM from 'react-dom/client';
import React from 'react';
const root = ReactDOM.createRoot(document.getElementById('root'));
function Modal() {
const fragmentObject = (
<React.Fragment>
<div id="foo">foo</div>
</React.Fragment>
);
console.log(fragmentObject)
return fragmentObject
}
root.render(<Modal />);
打印的對(duì)象為:

我們會(huì)發(fā)現(xiàn),當(dāng)我們使用 fragment 的時(shí)候,返回的對(duì)象的 $$typeof 卻依然是 REACT_ELEMENT_TYPE 這是為什么呢?
其實(shí)細(xì)想一下我們使用 portals 的時(shí)候,我們用的是 React.createPortal 的方式,但 fragments 走的依然是普通的 React.createElement 方法,createElement 的代碼我們也看到了,并無(wú)特殊處理 $$typeof 的地方,所以自然是 REACT_ELEMENT_TYPE
那么 $$typeof 到底是為什么存在呢?其實(shí)它主要是為了處理 web 安全問(wèn)題,試想這樣一段代碼:
let message = { text: expectedTextButGotJSON };
// React 0.13 中有風(fēng)險(xiǎn)
<p>
{message.text}
</p>
如果 expectedTextButGotJSON是來(lái)自于服務(wù)器的值,比如:
// 服務(wù)端允許用戶存儲(chǔ) JSON
let expectedTextButGotJSON = {
type: 'div',
props: {
dangerouslySetInnerHTML: {
__html: '/* something bad */'
},
},
// ...
};
let message = { text: expectedTextButGotJSON };
這就很容易受到 XSS 攻擊,雖然這個(gè)攻擊是來(lái)自服務(wù)器端的漏洞,但使用 React 我們可以處理的更好。如果我們用 Symbol 標(biāo)記每個(gè) React 元素,因?yàn)榉?wù)端的數(shù)據(jù)不會(huì)有 Symbol.for('react.element'),React 就可以檢測(cè) element.$$typeof,如果元素丟失或者無(wú)效,則可以拒絕處理該元素,這樣就保證了安全性。
回顧
至此,我們完整的看完了 React.createElement 的源碼,現(xiàn)在我們?cè)倏?React 官方文檔的這段:
以下兩種示例代碼完全等效:
const element = (
<h1 className="greeting">
Hello, world!
</h1>
);
const element = React.createElement(
'h1',
{className: 'greeting'},
'Hello, world!'
);
React.createElement() 會(huì)預(yù)先執(zhí)行一些檢查,以幫助你編寫無(wú)錯(cuò)代碼,但實(shí)際上它創(chuàng)建了一個(gè)這樣的對(duì)象:
// 注意:這是簡(jiǎn)化過(guò)的結(jié)構(gòu)
const element = {
type: 'h1',
props: {
className: 'greeting',
children: 'Hello, world!'
}
};
這些對(duì)象被稱為 “React 元素”。它們描述了你希望在屏幕上看到的內(nèi)容。React 通過(guò)讀取這些對(duì)象,然后使用它們來(lái)構(gòu)建 DOM 以及保持隨時(shí)更新。
現(xiàn)在你對(duì)這段是不是有了更加深入的認(rèn)識(shí)?
React 系列的預(yù)熱系列,帶大家從源碼的角度深入理解 React 的各個(gè) API 和執(zhí)行過(guò)程
以上就是React前端開發(fā)createElement源碼解讀的詳細(xì)內(nèi)容,更多關(guān)于React前端開發(fā)createElement的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
高性能React開發(fā)React Server Components詳解
ReactServerComponents通過(guò)服務(wù)器端渲染、自動(dòng)代碼分割等技術(shù),實(shí)現(xiàn)了高性能的React開發(fā),它解決了客戶端數(shù)據(jù)請(qǐng)求鏈?zhǔn)窖舆t、敏感數(shù)據(jù)暴露風(fēng)險(xiǎn)等問(wèn)題,提供了更好的用戶體驗(yàn)和安全性,本文介紹高性能React開發(fā)React Server Components詳解,感興趣的朋友一起看看吧2025-03-03
React項(xiàng)目中報(bào)錯(cuò):Parsing error: The keyword &a
ESLint 默認(rèn)使用的是 ES5 語(yǔ)法,如果你想使用 ES6 或者更新的語(yǔ)法,你需要在 ESLint 的配置文件如:.eslintrc.js等中設(shè)置 parserOptions,這篇文章主要介紹了React項(xiàng)目中報(bào)錯(cuò):Parsing error: The keyword 'import' is reservedeslint的問(wèn)題及解決方法,需要的朋友可以參考下2023-12-12
react 報(bào)錯(cuò)Module build failed: Browserslis
這篇文章主要介紹了react 報(bào)錯(cuò)Module build failed: BrowserslistError: Unknown browser query `dead`問(wèn)題的解決方法,需要的朋友可以參考下2023-06-06
React跨路由組件動(dòng)畫實(shí)現(xiàn)
在 React 中路由之前的切換動(dòng)畫可以使用 react-transition-group 來(lái)實(shí)現(xiàn),但對(duì)于不同路由上的組件如何做到動(dòng)畫過(guò)渡是個(gè)很大的難題,目前社區(qū)中也沒(méi)有一個(gè)成熟的方案,本文給大家分享React跨路由組件動(dòng)畫實(shí)現(xiàn),感興趣的朋友一起看看吧2023-10-10
React-redux?中useSelector使用源碼分析
在一個(gè) action 被分發(fā)(dispatch) 后,useSelector() 默認(rèn)對(duì) select 函數(shù)的返回值進(jìn)行引用比較 ===,并且僅在返回值改變時(shí)觸發(fā)重渲染,,這篇文章主要介紹了React-redux?中useSelector使用,需要的朋友可以參考下2023-10-10
探討JWT身份校驗(yàn)與React-router無(wú)縫集成
這篇文章主要為大家介紹了JWT身份校驗(yàn)與React-router無(wú)縫集成的探討解析,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-06-06
詳解如何使用React?Redux實(shí)現(xiàn)異步請(qǐng)求
這篇文章主要為大家詳細(xì)介紹了如何使用React?Redux實(shí)現(xiàn)異步請(qǐng)求,文中的示例代碼講解詳細(xì),具有一定的借鑒價(jià)值,有需要的小伙伴可以參考一下2025-01-01

