React TS函数组件接收Gatsby PageProps与父Props时data、errors为undefined
错误原因定位
- React 函数组件仅接收一个入参:所有传入属性合并后的单一props对象,不存在第二个入参。第一种写法实际相当于定义了两个形参,第二个形参
{ data, errors }对应的位置根本不会有React传入的值,所以永远返回undefined;第一个形参正常拿到了整个props对象,解构path自然可以正常工作。 - Gatsby 的
PageProps是框架编译时自动注入到组件props里的属性集合,和父组件传入的自定义data、errors属性,是完全平级存在于同一个props对象中的,不需要拆分接收。 - 第二种写法能拿到
data、errors,是因为这两个属性本来就在这个唯一的props对象里;看似拿不到path,实际是没有做对应的类型定义,也没有在解构时把path从props对象里取出,并非path不存在于props中。
正确实现方式
核心思路是把框架自带的Props类型和自定义Props类型合并,从同一个props对象中统一解构所有需要的属性:
import { graphql, PageProps } from 'gatsby' // 按照实际业务结构定义父组件传入的自定义props类型 type CustomEventsProps = { data: Record<string, any> // 替换为你实际的data数据类型 errors: Record<string, string> // 替换为你实际的errors数据类型 } // 通过交叉类型合并Gatsby注入的PageProps和自定义props,得到完整的组件props类型 type EventsComponentProps = PageProps & CustomEventsProps // 从同一个props对象中统一解构所有需要的属性 const Events = ({ path, data, errors }: EventsComponentProps) => { // 此处Gatsby注入的path、父组件传入的data和errors均可正常访问 }
关键注意点
- 不要为框架注入props和自定义props拆分函数形参,两类属性是平级合并在同一个props对象里的。
- 用交叉类型做类型定义时,TS会自动提示所有可用属性,既不会漏识别Gatsby注入的
path、pageContext等内置属性,也能正确校验父组件传入的自定义属性类型。 - 调试时可以直接打印整个props对象,能直观看到所有属性是并列存在的,不存在层级嵌套导致的获取不到问题。
内容的提问来源于stack exchange,提问作者user992731
相关产品推荐
相关产品推荐

