TS类型定义ts(2339)问题

这篇博客探讨了在使用 TypeScript 进行前端开发时遇到的一个常见问题:如何处理 API 返回的数据类型。作者通过一个具体的查询客户信息的例子,展示了在 JS 中正常工作但在 TS 中报错的情况。错误主要源于 TS 对类型定义的严格要求。解决方案包括使用 `any` 类型或者定义一个具体的接口来描述返回的数据结构。作者建议采用后者,因为它能提供更好的类型检查。通过创建一个名为 `ApiDataTypes` 的接口,作者展示了如何更准确地处理响应数据,从而避免类型错误。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

最近在学前端TS,遇到一些基础问题,特意记录一下。

简单一个业务操作,根据客户名称,查询对应的客户信息,以下ts中标红的为错误信息:

以下写法,在JS中是没问题的,事实上在当前TS环境下,也是可以取到API数据的;

报错的其是TS,如图,错误代码:ts(2339):

<template>
  <div>
    <el-input type="text" v-model="customer" />
    <el-button type="primary" @click="onsubmit">查询客户</el-button>
  </div>
</template>
<script setup lang='ts'>
import { getCustomer } from '@/api/customer';
import { ref } from 'vue'
import { ElMessageBox } from 'element-plus'
let customer = ref()
async function onsubmit() {
  await getCustomer(customer.value).then((res) => {
    //报错:AxiosResponse<any,any>类型不存在code属性
    if (res.code === 200) {
      const data= JSON.stringify(res.entity)
      ElMessageBox(data)
    }
  })
}
</script>

TS类型属性的定义,要求很严格,否则就会报错,如上例子。

解决方法,也很简单,就是要给res加上类型,才能取到它对应的属性值,以下为解决方法之一,加上any类型:

<template>
  <div>
    <el-input type="text" v-model="customer" />
    <el-button type="primary" @click="onsubmit">查询客户</el-button>
  </div>
</template>
<script setup lang='ts'>
import { getCustomer } from '@/api/customer';
import { ref } from 'vue'
import { ElMessageBox } from 'element-plus'

let customer = ref()
async function onsubmit() {
  await getCustomer(customer.value).then((res: any) => {
    if (res.code === 200) {
      const data: any = JSON.stringify(res.entity)
      ElMessageBox(data)
    }
  })
}
</script>

这是常用的解决方法,事实上any,也并不是最准确的好方法;

业务中,后台返回的数据,基本上会有一个比较固定的信息模型,所以前端在拿到接口时,已经知道,返回的数据类型。那么,我们就可以在前端定义一个对应 返回信息接口,如:

/**
 * 后台API返回的信息模型数据
 **/

export default interface ApiDataTypes {
    code: number // 请求code值
    message: string // 请求返回的提示文字
    entity: {} // 请求的data
    [propName: string]: any
}
export const ApiData: ApiDataTypes = {
    code: 0,
    message: '',
    entity: {},
}

这样的话,上面例子的代码就可以改为,第二种方法:

<template>
  <div>
    <el-input type="text" v-model="customer" />
    <el-button type="primary" @click="onsubmit">查询客户</el-button>
  </div>
</template>
<script setup lang='ts'>
import { getCustomer } from '@/api/customer';
import { ref } from 'vue'
import { ElMessageBox } from 'element-plus'
import apiDataType from '@/types/apiDataType'//引用接口

let customer = ref()
async function onsubmit() {
  await getCustomer(customer.value).then((res: any) => {
    //双重断言成,res指定为上面已经定义好的接口类型
    const list = <apiDataType><any>res 
    if (list.code === 200) {
      const data: any = JSON.stringify(list.entity)//这里的DATA也可以定义为数据模型
      ElMessageBox(data)
    }
  })
}
</script>
### Vue 3 中 TypeScript 类型定义的使用方法 在 Vue 3 和 TypeScript 结合使用的场景中,类型定义对于提高代码质量和开发体验至关重要。以下是关于如何在 Vue 3 中进行 TypeScript 类型定义的具体说明以及示例。 #### 配置项目环境 为了支持 Vue 3 和 TypeScript 的结合,需确保项目的 `tsconfig.json` 文件已正确配置。通常情况下,默认生成的 Vue CLI 或 Vite 脚手架会自动完成此设置。如果手动创建,则需要确认以下字段的存在: ```json { "compilerOptions": { "strict": true, "moduleResolution": "node", "esModuleInterop": true, "allowSyntheticDefaultImports": true, "target": "esnext", "module": "esnext", "jsx": "preserve" } } ``` 以上配置能够使 TypeScript 更好地理解 Vue 组件结构并提供精确的类型推断[^1]。 --- #### 定义 Props 类型 当使用 Composition API 并通过 `defineProps()` 方法声明 props 时,可以通过接口来定义其类型。例如: ```typescript <script setup lang="ts"> interface UserProps { name: string; age?: number; // 可选属性 } const props = defineProps<UserProps>(); </script> ``` 上述代码片段展示了如何利用 TypeScript 接口为组件的 props 提供类型安全的支持。注意,这种写法同样适用于运行时声明的情况[^2]。 --- #### 定义 Emits 类型 类似于 props 的处理方式,emits 的类型也可以被明确定义。这有助于开发者清楚知道当前组件可以触发哪些事件及其参数形式。下面是一个简单的例子: ```typescript <script setup lang="ts"> import { defineEmits } from 'vue'; interface EmitEvents { (e: 'update', value: boolean): void; (e: 'delete'): void; } const emit = defineEmits<EmitEvents>(); // 使用 emit 函数发送自定义事件 emit('update', true); emit('delete'); </script> ``` 这里采用了函数签名的形式描述每个可能发出的事件名称及对应的参数列表。 --- #### 外部库类型的引入 某些第三方库(如 Highcharts)可能缺乏内置的 TypeScript 类型定义文件。此时有两种解决方案:一是寻找社区维护的 @types 包;二是自行编写类型声明。以 Highcharts 为例,由于官方未提供完整的 `.d.ts` 文件,所以推荐安装由 DefinitelyTyped 社区管理的相关包: ```bash npm install --save-dev @types/highcharts ``` 假如目标插件确实没有任何可用的类型定义资源,则可模仿其他成熟框架的做法——比如 vue-router 已经具备详尽的 types 文件夹作为参考依据[^3]。 --- #### 示例总结 综合来看,在实际编码过程中应当充分利用 TypeScript 强大的静态分析能力,从而减少潜在错误的发生概率。无论是基础数据模型还是复杂交互逻辑,都应尽可能给予清晰准确的类型标注。 ```typescript <script setup lang="ts"> // 声明 Prop 类型 interface BookProp { title: string; author: string; yearPublished: number; } const bookProps = defineProps<BookProp>(); // 声明 Emit 类型 interface BookEmit { (e: 'borrowed', id: number): void; (e: 'returned'): void; } const emitBookEvent = defineEmits<BookEmit>(); function handleBorrow(id: number) { emitBookEvent('borrowed', id); } function handleReturn() { emitBookEvent('returned'); } </script> <template> <div class="book-info"> <h2>{{ bookProps.title }}</h2> <p>Author: {{ bookProps.author }}</p> <button @click="handleBorrow(1)">Borrow</button> <button @click="handleReturn">Return</button> </div> </template> ``` ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值