精进TypeScript--优选接口的联合,而不是联合的接口

2024-04-05 03:36

本文主要是介绍精进TypeScript--优选接口的联合,而不是联合的接口,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

如果你创建的一个属性是联合类型的接口,你应该问一下这个类型作为更精确的接口的联合是否更有意义

要记住的事情:

  • 具有多个属性对于联合类型的接口通常是一个错误的选择,因为它们掩盖了这些属性之间的关系
  • 接口的联合更精确,且可以被 TypeScript 所理解

假设你正在构建一个矢量绘图程序,并希望为具有特定几何类型的图层定义一个接口。

interface Layer {layout: FillLayout | LineLayout | PointLayout;paint: FillPaint | LinePaint | PointPaint;
}

字段layout控制形状的绘制方式和位置(是圆角还是直角),而 paint 字段控制样式(线条颜色、粗细、虚实等)

如果有一个图层,它的 layout 是 LineLayout,但它的 paint 属性是FillPaint,这样有意义吗?可能没有意义,允许这种可能性会使得使用库时更容易出错,并且使这个接口难以使用。

一个更好的建模方式是为每一种类型的图层提供单独的接口:

interface FillLayer {layout: FillLayout;paint: FillPaint;
}
interface LineLayer {layout: LineLayout;paint: LinePaint;
}
interface PointLayer {layout: PointLayout;paint: PointPaint;
}
type Layer = FillLayer | LineLayer | PointLayer;

以这种方式定义 Layer,你就可以排除混合 layout 和 point 属性的可能性。

这种模式最常见的例子是 “标签联合类型”,在这种情况下,其中一个属性是字符串字面量类型的联合:

interface FillLayer {type: 'fill';layout: FillLayout;paint: FillPaint;
}
interface LineLayer {type: 'line';layout: LineLayout;paint: LinePaint;
}
interface PointLayer {type: 'point';layout: PointLayout;paint: PointPaint;
}
type Layer = FillLayer | LineLayer | PointLayer;

type 属性就是“标签”,可以用来确定你在运行时处理的 Layer 是哪种类型。TypeScript 也能够根据标签来收缩 Layer 的类型:

function drawLayer(layer: Layer) {if (layer.type === 'fill') {const {paint} = layer; // FillPaintconst {layout} = layer; // FillLayout} else if (layer.type === 'line') {const {paint} = layer; // LinePaintconst {layout} = layer; // LineLayout} else {const {paint} = layer; // PointPaintconst {layout} = layer; // PointLayout}
}

通过正确地对这个类型中属性之间的关系进行建模,你可以帮助 TypeScript 检查你的代码的正确性。但是使用同样的代码初始化 Layer 会被类型断言弄得杂乱无章。

因为标签联合类型与 TypeScript 的类型检查器配合得很好,所以它们在 TypeScript 代码中是无处不在的。你要了解这个模式,并在合适的时候应用它。

如果你把可选字段视为它们的类型和 undefined 的联合类型,那么它们也适合这种模式。考虑一下这个类型:

interface Person {name: string;palceOfBirth?: string; // 这些要么存在、要么不存在dateOfBirth?: Date;
}

一个带有类型信息的注释是表明可能存在问题的强烈信号。在 palceOfBirth和 dateOfBirth 字段之间可能存在一个你还有告诉 TypeScript 的关系。

一个更好的建模方式是将这两个属性移动到一个对象中。这类似于将null移动到边界上:

interface Person {name: string;birth?: {place: string;date: Date;}
}

如果类型的结构不在你的控制范围内(例如,一个 API 接口),那么你仍然可以使用现在很熟悉的接口的联合来建模这些字段之间的关系:

interface Name {name: string;
}interface PersonWithBirth extends Name {placeOfBirth: string;dateOfBirth: Date;
}type Person = Name | PersonWithBirth;
// 这样的好处:
function eulogize(p: Person) {if ('placeOfBirth' in p) {const {dateOfBirth} = p; // OK,类型是 Date}
}

在这两种情况下,类型定义使属性之间的关系更加清晰。

这篇关于精进TypeScript--优选接口的联合,而不是联合的接口的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/877545

相关文章

详解Java如何向http/https接口发出请求

《详解Java如何向http/https接口发出请求》这篇文章主要为大家详细介绍了Java如何实现向http/https接口发出请求,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 用Java发送web请求所用到的包都在java.net下,在具体使用时可以用如下代码,你可以把它封装成一

Java后端接口中提取请求头中的Cookie和Token的方法

《Java后端接口中提取请求头中的Cookie和Token的方法》在现代Web开发中,HTTP请求头(Header)是客户端与服务器之间传递信息的重要方式之一,本文将详细介绍如何在Java后端(以Sp... 目录引言1. 背景1.1 什么是 HTTP 请求头?1.2 为什么需要提取请求头?2. 使用 Spr

VMWare报错“指定的文件不是虚拟磁盘“或“The file specified is not a virtual disk”问题

《VMWare报错“指定的文件不是虚拟磁盘“或“Thefilespecifiedisnotavirtualdisk”问题》文章描述了如何修复VMware虚拟机中出现的“指定的文件不是虚拟... 目录VMWare报错“指定的文件不是虚拟磁盘“或“The file specified is not a virt

python与QT联合的详细步骤记录

《python与QT联合的详细步骤记录》:本文主要介绍python与QT联合的详细步骤,文章还展示了如何在Python中调用QT的.ui文件来实现GUI界面,并介绍了多窗口的应用,文中通过代码介绍... 目录一、文章简介二、安装pyqt5三、GUI页面设计四、python的使用python文件创建pytho

Java 后端接口入参 - 联合前端VUE 使用AES完成入参出参加密解密

加密效果: 解密后的数据就是正常数据: 后端:使用的是spring-cloud框架,在gateway模块进行操作 <dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>30.0-jre</version></dependency> 编写一个AES加密

java线程深度解析(一)——java new 接口?匿名内部类给你答案

http://blog.csdn.net/daybreak1209/article/details/51305477 一、内部类 1、内部类初识 一般,一个类里主要包含类的方法和属性,但在Java中还提出在类中继续定义类(内部类)的概念。 内部类的定义:类的内部定义类 先来看一个实例 [html]  view plain copy pu

模拟实现vector中的常见接口

insert void insert(iterator pos, const T& x){if (_finish == _endofstorage){int n = pos - _start;size_t newcapacity = capacity() == 0 ? 2 : capacity() * 2;reserve(newcapacity);pos = _start + n;//防止迭代

京东物流查询|开发者调用API接口实现

快递聚合查询的优势 1、高效整合多种快递信息。2、实时动态更新。3、自动化管理流程。 聚合国内外1500家快递公司的物流信息查询服务,使用API接口查询京东物流的便捷步骤,首先选择专业的数据平台的快递API接口:物流快递查询API接口-单号查询API - 探数数据 以下示例是参考的示例代码: import requestsurl = "http://api.tanshuapi.com/a

股票数据接口-陈科肇

陈科肇 新浪财经 sz-深圳sh-上海历史分价表:http://market.finance.sina.com.cn/pricehis.php?symbol=sz000506&startdate=2016-12-27&enddate=2016-12-27历史成交明细(当日成交明细):http://vip.stock.finance.sina.com.cn/quotes_service/v

C和指针:结构体(struct)和联合(union)

结构体和联合 结构体 结构体包含一些数据成员,每个成员可能具有不同的类型。 数组的元素长度相同,可以通过下标访问(转换为指针)。但是结构体的成员可能长度不同,所以不能用下标来访问它们。成员有自己的名字,可以通过名字访问成员。 结构声明 在声明结构时,必须列出它包含的所有成员。 struct tag {member-list} variable-list ; 定义一个结构体变量x(包含