正文从这开始~
类型守卫
使用类型守卫来解决React中useRef
钩子“Object is possibly null”的错误。比如说,if (inputRef.current) {}
。一旦null
被排除在ref
的类型之外,我们就能够访问ref
上的属性。
【React报错之Object is possibly null】
文章图片
下面是一个错误如何发生的示例。
import {useEffect, useRef} from 'react';
export default function App() {
const inputRef = useRef(null);
useEffect(() => {
// ?? Object is possibly 'null'.ts(2531)
inputRef.current.focus();
}, []);
return (
);
}
代码片段中的问题是,TypeScript不能确保我们将一个元素或者一个值赋值给ref,所以它的
current
属性可能为null
。为了解决这个错误,在访问ref类型上的属性之前,我们必须使用类型守卫来从其类型中排除
null
。import {useEffect, useRef} from 'react';
export default function App() {
const inputRef = useRef(null);
useEffect(() => {
// ? ref could be null here
if (inputRef.current != null) {
// ? TypeScript knows that ref is not null here
inputRef.current.focus();
}
}, []);
return (
);
}
我们使用简单的
if
语句作为类型守卫,来确保ref
上的current
属性不存储null
。当程序进入到if
代码块中,TypeScript就会知道ref
对象上的current
属性就不会存储null
。确保在useRef钩子上使用泛型,正确的类型声明注意,我们传递了一个泛型来将ref
上的current
属性。
ref
的值类型声明为HTMLInputElement
。一些常用的类型有:
HTMLInputElement
, HTMLButtonElement
, HTMLAnchorElement
, HTMLImageElement
, HTMLTextAreaElement
, HTMLSelectElement
等等。如果你在
ref
中存储了不同的值,请确保将特定类型传递给useRef
钩子的泛型,例如const ref = useRef<{name: string}>(null);
。如果
ref
上的current
属性存储了null
,我们也可以使用可选链?.
操作符进行短路运算。import {useEffect, useRef} from 'react';
export default function App() {
const inputRef = useRef(null);
useEffect(() => {
// ? optional chaining (?.)
inputRef.current?.focus();
}, []);
return (
{/* Cannot find name 'button'.ts(2304) */}
);
}
如果引用是空值(
null
或者undefined
),可选链?.操作符会进行短路运算,而不会抛出错误。换句话说,如果ref
上的current
属性存储了null
,操作符会短路运算从而返回undefined
。而不会在undefined
上尝试调用focus
方法,导致一个运行时错误。非空断言 另一种解决方案是使用非空断言
!
操作符。import {useEffect, useRef} from 'react';
export default function App() {
const inputRef = useRef(null);
useEffect(() => {
// ? using non-null (!) assertion
inputRef.current!.focus();
}, []);
return (
{/* Cannot find name 'button'.ts(2304) */}
);
}
在TypeScript中,感叹号标记被称为非空断言操作符。被用来从类型中移除
null
和undefined
,而不用进行任何显式的类型检查。当我们使用非空断言时,基本上我们就是在告诉TS,
ref
对象上的current
属性不会存储null
或者undefined
。请注意,这种方法不是类型安全的,因为TypeScript不执行任何检查以确保属性不是空的。
总结 造成 "Object is possibly null"的错误是因为
useRef()
钩子可以传递一个初始值作为参数,而我们传递null
作为初始值。该钩子返回一个可变的ref
对象,其.current
属性被初始化为所传递的参数。当传递ref prop给一个元素时,比如
,React将ref
对象的.current
属性设置为相应的DOM节点,但TypeScript无法确定我们是否会将ref
设置为DOM元素,或在我们的代码中稍后设置其值。推荐阅读
- React|React UI组件库——如何快速实现antd的按需引入和自定义主题
- React|【React路由】编程式路由导航和withRouter的使用——push / replace
- React|React路由组件传参的三种方式——params、search、state
- React|【React组件】github搜索案例之 父子组件通信 (附源码)
- React|【React】React组件实例的三大属性之state,props,refs(你学废了吗)
- React|【ReactRouter5】路由的模糊匹配,重定向以及嵌套路由
- React|【React】深入理解React组件生命周期----图文详解(含代码)
- javascript|精读《useRef 与 createRef 的区别》
- 搞懂react类组件中的this指向