Rax 错误码
在线上版本的 Rax 打包策略中,我们移除了冗长的错误提示以获得更小的包 (bundle) 体积,而使用一个数字类型的错误码来替代。本文可以帮助你找到错误码对应的错误原因,以便完成线上问题的排查。
需要注意的是,错误码仅是帮助快速完成异常定位,如果需要获取发生错误的调用栈,你仍需要将 Rax 打包为开发版本并通过 sourceMap
机制找到异常在源码中的位置。
注:线上版本指的是使用 rax-scripts 执行 build 操作时打出的代码包,会注入
process.env.NODE_ENV
变量的值为production
,你也可以直接使用预构建的分发版本rax/dist/rax.min.js
文件。
错误码 0
Type of createElement should not be null or undefined.
这个错误出现在调用 createElement
方法时。当传入的第一个参数为 null
或者 undefined
时会触发这个问题,通常可能是因为未获取到创建的 JSX 组件的引用:
以下例子中,如果引入的 Foo
为 null
或 undefined
,便会触发该错误。
import Foo from './some-where';
<Foo />
// compiled to `createElement(Foo)`
错误码 1
Hooks can only be called inside a component.
这个错误出现在调用 Rax hooks 相关 API 时。通常有两种可能,一是在业务中引入了多份 Rax,而调用 hooks 的 Rax 并没有实际参与渲染;二是在组件渲染流程外调用了 hooks,或者是在 class 组件中调用了 hooks API。
错误码 2
Invalid element type.
这个错误通常出现在渲染异常类型的节点时,Rax 接受的节点类型包括 Element(createElement 返回的对象),Array,String,Number,Boolean,null,undefined。
错误码 3
ref: multiple version of Rax used in project.
这个错误通常出现在使用 ref 时,引入了多份 Rax 实例。
错误码 4
Too many re-renders, the number of renders is limited to prevent an infinite loop.
这个错误通常出现在死循环调用的组件中,当短时间内渲染的次数超过阈值时,Rax 认为渲染流程陷入了无限循环。
错误码 5
Driver not found.
这个错误通常出现在调用 render
方法未传入 driver
时,从 Rax 1.0 开始,render 方法必须显式指定渲染的 driver
。
import { render, createElement } from 'rax';
import DriverUniversal from 'universal-driver';
render(<div />, null, { driver: DriverUniversal });