You need to enable JavaScript to run this app. React TS函数组件接收Gatsby PageProps与父Props时data、errors为undefined
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 05:45:00