当前位置: 首页 > 文档资料 > Rax 中文文档 >

Rax 错误码

优质
小牛编辑
131浏览
2023-12-01

在线上版本的 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 组件的引用:

以下例子中,如果引入的 Foonullundefined,便会触发该错误。

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 });