27、TypeScript 开发中的最佳实践与注意事项

TypeScript 开发中的最佳实践与注意事项

避免动态 this 绑定

在设计新的 API 时，尽量避免使用动态 this 绑定。尽管它过去很流行，但一直是造成混淆的源头，而且箭头函数的盛行使得这种 API 在现代 JavaScript 中更难使用。

要点总结 ：
- 理解 this 绑定的工作原理。
- 如果 this 是 API 的一部分，在回调中为其提供类型。
- 避免在新 API 中使用动态 this 绑定。

镜像类型以消除依赖

假设你编写了一个用于解析 CSV 文件的库。其 API 很简单：传入 CSV 文件的内容，然后返回一个将列名映射到值的对象列表。为了方便 Node.js 用户，你允许内容可以是字符串或 Node.js Buffer：

// parse-csv.ts
import {Buffer} from 'node:buffer';
function parseCSV(contents: string | Buffer): {[column: string]: string}[]  {
  if (typeof contents === 'object') {
    // It's a buffer
    return parseCSV(contents.toString('utf8'));
  }
  // ...
}

Buffer 的类型定义来自 Node.js 类型声明，你必须安装它们：