You need to enable JavaScript to run this app. TypeScript环境下React类组件访问State报'value'不存在于类型{}的问题
优惠活动
大模型
产品
解决方案
定价
更多

TypeScript环境下React类组件访问State报'value'不存在于类型{}的问题

问题现象

开发React表单类组件,已完成以下功能逻辑:

  • 构造函数初始化:设置初始state的value为空字符串,同时对handleChange、handleSubmit两个方法完成this绑定,对应代码:
constructor(props) {
  super(props);
  this.state = {value: ''};
  this.handleChange = this.handleChange.bind(this);
  this.handleSubmit = this.handleSubmit.bind(this);
}
  • 输入同步逻辑:handleChange方法实现输入框值变更时,将最新输入值同步更新到state.value,对应代码:
handleChange(event) {
  this.setState({value: event.target.value});
}
  • 提交逻辑预期:handleSubmit方法设计目标为表单提交时弹窗展示已录入的名称值,同时阻止表单默认页面跳转行为。但在该方法中访问this.state.value时,TypeScript抛出类型报错:

Property 'value' does not exist on type '{}'.ts(2339)

问题完整代码
class NameForm extends React.Component {
  constructor(props) {
    super(props);
    this.state = {value: ''};
    this.handleChange = this.handleChange.bind(this);
    this.handleSubmit = this.handleSubmit.bind(this);
  }

  handleChange(event) {
    this.setState({value: event.target.value});
  }

  handleSubmit(event) {
    alert('A name was submitted: ' + this.state.value);
    event.preventDefault();
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>
        <label>
          Name:
          <input type="text" value={this.state.value} onChange={this.handleChange} />
        </label>
        <input type="submit" value="Submit" />
      </form>
    );
  }
}
报错原因与修复方案

报错根因

定义React类组件时,未通过泛型参数显式声明组件的Props类型与State类型,TypeScript会默认将组件的state推导为空对象类型{},因此访问state上的自定义value字段时,会触发字段不存在的类型报错。

修复步骤

  • 定义State类型结构,明确state包含的字段与对应数据类型。本场景下State需要包含一个string类型的value字段
  • 定义Props类型,如果组件无自定义接收参数,可将Props声明为空对象类型
  • 类组件继承React.Component时,按顺序传入两个泛型参数:第一个为Props类型,第二个为State类型

修复后代码

// 声明State类型
interface NameFormState {
  value: string;
}

// 声明Props类型,无自定义传参时为空对象
interface NameFormProps {}

// 给React.Component传入泛型参数:<Props, State>
class NameForm extends React.Component<NameFormProps, NameFormState> {
  constructor(props: NameFormProps) {
    super(props);
    this.state = {value: ''};
    this.handleChange = this.handleChange.bind(this);
    this.handleSubmit = this.handleSubmit.bind(this);
  }

  handleChange(event: React.ChangeEvent<HTMLInputElement>) {
    this.setState({value: event.target.value});
  }

  handleSubmit(event: React.FormEvent<HTMLFormElement>) {
    alert('A name was submitted: ' + this.state.value);
    event.preventDefault();
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>
        <label>
          Name:
          <input type="text" value={this.state.value} onChange={this.handleChange} />
        </label>
        <input type="submit" value="Submit" />
      </form>
    );
  }
}

修改完成后,TypeScript可准确识别state结构,不会再抛出value字段不存在的报错,同时事件对象的类型校验会更精准,减少潜在的类型问题。

内容的提问来源于stack exchange,提问作者Rak

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.11 21:45:07