英文 | https://www.sangle7.com/
1、 TypeScript 和 DOM
当你开始使用 TypeScript 时,你会发现在浏览器环境中使用它,你需要非常了解它。假设我想在页面搜索框里找到一个
元素:
const textEl = document.querySelector('inpot');
console.log(textEl.value);
// 🛑 Property 'value' does not exist on type 'Element'.
Oops…… 抛出了一个错误,因为我把 ‘input’ 打成了 ‘inpot’
它怎么知道的?答案在于 lib.dom.d.ts 文件,该文件是 TypeScript 库的一部分,并且基本上描述了浏览器中发生的所有事情(对象,函数,事件)。
该定义的一部分是在 querySelector 方法的输入中使用的接口,并将特定的字符串文字(例如’div’, ‘table’或’input’)映射到相应的 HTML 元素类型:
interface HTMLElementTagNameMap {
a: HTMLAnchorElement;
abbr: HTMLElement;
address: HTMLElement;
applet: HTMLAppletElement;
area: HTMLAreaElement;
article: HTMLElement;
/* ... */
input: HTMLInputElement;
/* ... */
}
这不是一个完美的解决方案,因为它仅适用于基本元素选择器,但总比没有好,对吧?
这种’智能’TypeScript 行为的另一个示例是在处理浏览器事件时:
textEl.addEventListener('click', (e) => {
console.log(e.clientX);
});
上面的示例中的.clientX 在任何给定事件上都不可用-仅在 MouseEvent 上可用。然后 TypeScript 根据作为 addEventListener 方法中第一个参数的“click”文字确定事件的类型。
2、期望泛型
document.querySelector('input.action')
那么 HTMLELementTagNameMap 将不再有用,TypeScript 只会返回一个相当基本的 Element 类型。
与 querySelector 一样,函数通常可以返回各种不同的结构,而 TypeScript 不可能确定将是哪种结构。在那种情况下,您可以非常期待,该函数也是通用的,并且可以使用方便的通用语法提供该返回类型:
textEl = document.querySelector < HTMLInputElement > 'input.action';
console.log(textEl.value);
// 👍 'value' is available because we've instructed TS
// about the type the 'querySelector' function works with.
3、“我们真的找到了吗?”
该 document.querySelector(…)方法实际上并不总是返回一个对象,是吗?与选择器匹配的元素可能不在页面上-函数将返回 null 而不是对象。因此,默认情况下,访问.value 属性可能不会保存所有内容。
默认情况下,类型检查器认为 null 和 undefined 可分配给任何类型。您可以通过在 tsconfig.json 中添加严格的 null 检查来使其更加安全并限制这种行为:
{
"compilerOptions": {
"strictNullChecks": true
}
}
使用该设置后,如果您尝试访问可能为 null 的对象上的属性,TypeScript 将会报错,并且你将不得不确保该对象的存在,例如 通过用 if(textEl){...} 条件包装该部分。
除了 querySelector 之外,另一个流行的例子是 Array.find 方法,其结果可能是不确定的。
正如我们已经确定的那样,通过严格的 null 检查,TypeScript 将更加怀疑我们的价值观。另一方面,有时您仅从外部就知道将设置该值。在这种特殊情况下,您可以使用“后缀表达式运算符”:
const textEl = document.querySelector('input');
console.log(textEl!.value);
// 👍 with "!" we assure TypeScript
// that 'textEl' is not null/undefined
5、当迁移到 TS…
通常,当您具有要迁移到 TypeScript 的旧版代码库时,更大的麻烦之一就是使 id 遵守您的 TSLint 规则。您可以做的是通过添加以下内容来编辑所有这些文件
在每个文件的第一行中,这样 TSLint 不会真正检查它们。然后,仅当开发人员处理旧文件时,他才会删除此注释并仅修复该文件中的所有掉毛错误。这样一来,我们就不会进行革命,而只会进行进化-代码库会逐渐但安全地得到改善。
至于将实际类型添加到旧的 JavaScript 代码中,实际上通常可以不这样做。只有在您有一些令人讨厌的代码(例如, 为同一变量分配不同类型的值,您可能会遇到问题。如果重构不是一个小问题,您可以使用这个方法解决问题:
let mything = 2;
mything = 'hi';
// 🛑 Type '"hi"' is not assignable to type 'number'
mything = 'hi' as any;
// 👍 if you say "any", TypeScript says ¯\_(ツ)_/¯
但是真的,真的,真的将其用作最后的手段。我们不喜欢TypeScript中的 any。
6、更多限制
有时TypeScript无法推断类型。最常见的情况是一个函数参数:
function fn(param) {
console.log(param);
}
在内部,它需要在此处为param分配某种类型,因此它可以分配任何类型。由于我们希望将any限制为绝对最小值,因此通常建议使用另一个tsconfig.json设置来限制该行为:
{
"compilerOptions": {
"noImplicitAny": true
}
}
不幸的是,我们不能在函数返回类型上使用这种安全带(需要明确输入)。因此,如果改为使用函数fn(param):string {我会忘记该类型(函数fn(param){),TypeScript将不会关注我返回的内容,即使我从该函数返回了任何内容。更准确地说:它将根据您退回或未退回的商品推断出退货价值。
幸运的是,TSLint可以为您提供帮助。使用typedef规则,您可以使返回类型成为必需:
{
"rules": {
"typedef": [
true,
"call-signature"
]
}
}
7、类型保护
当值具有多种类型时,必须在算法中将其考虑在内,以区分一种类型与另一种类型。关于TypeScript的事情是它了解这种逻辑。
type BookId = number | string;
function returnFormatterId(id: BookId) {
return id.toUpperCase();
// 🛑 'toUpperCase' does not exist on type 'number'.
}
function returnFormatterId(id: BookId) {
if (typeof id === 'string') {
// we've made sure it's a string:
return id.toUpperCase(); // so it's 👍
}
// 👍 TS also understands that it
// has to be a number here:
return id.toFixed(2)
}
8、再谈泛型
interface Bookmark {
id: string;
}
class BookmarksService {
items: Bookmark[] = [];
}
您想在不同的应用程序中使用它,例如 用于存储书籍或电影。
interface Movie {
id: string;
name: string;
}
class SearchPageComponent {
movie: Movie;
constructor(private bs: BookmarksService) {}
getFirstMovie() {
// 🛑 types are not assignable
this.movie = this.bs.items[0];
// 👍 so you have to manually assert type:
this.movie = this.bs.items[0] as Movie;
}
getSecondMovie() {
this.movie = this.bs.items[1] as Movie;
}
}
我们可以做的是将 BookmarksService 类定义为通用类:
class BookmarksService<T> {
items: T[] = [];
}
好吧,不过现在它太通用了……我们要确保此类使用的类型能够满足Bookmark接口(即具有id:string属性)。这是改进的声明:
class BookmarksService<T extends Bookmark> {
items: T[] = [];
}
现在,在我们的SearchPageComponent中,我们只需指定一次类型:
class SearchPageComponent {
movie: Movie;
constructor(private bs: BookmarksService<Movie>) {}
getFirstMovie() {
this.movie = this.bs.items[0]; // 👍
}
getSecondMovie() {
this.movie = this.bs.items[1]; // 👍
}
}
对于该通用类,还有一项可能是有用的改进-如果您以这种通用身份在其他地方使用它,而又不想编写BookmarksService
的话。
class BookmarksService<T extends Bookmark = Bookmark> {
items: T[] = [];
}
const bs = new BookmarksService();
// I don't have to provide the type for the generic now
// - in that case 'bs' will be of that default type 'Bookmark'
9、路由参数
export interface DashboardRouteParams {
countryId: string;
deviceId: string;
}
const routes: Routes = [{
path: 'country/:countryId/device/:deviceId/dashboard'
}]
10、根据 API 响应创建 Interface
如果您收到来自API的大量嵌套响应,那么手动键入相应的接口确实很麻烦。这是应该由机器处理的任务!🤖
是其中的一些,但是坦率地说,它们的服务器通常不可用。由于URL的记忆力很强,我通常只是从它们开始:-)为了获得最佳结果和一些其他选项,请使用
-
https://app.quicktype.io/
它还提供了一个方便的Visual Studio Code插件~