什么是 ts-tagged？
ts-tagged 是一个基于 TypeScript 的标记性类型系统的库，它允许您在 TypeScript 中进行更严格的类型检查。使用这个库可以定义自己的标记类型，以便在编译时执行更多的类型检查。
安装 ts-tagged
要安装 ts-tagged，请使用 npm 命令行工具：
npm install ts-tagged
如何使用 ts-tagged？
首先，您需要导入 Tagged 类型和 tag 函数：
import { Tagged, tag } from 'ts-tagged';
接下来，您需要定义自己的标记类型。例如，如果您想定义一个表示账户余额的标记类型，可以这样写：
type BalanceTag = Tagged<number, 'Balance'>;
其中，BalanceTag 是一个类型别名，它将 number 类型与 'Balance' 标记结合起来。这意味着您可以创建一个 BalanceTag 类型的变量，并且这个变量只能包含数字，并且带有 'Balance' 标记：
const balance: BalanceTag = tag(100, 'Balance');
上面的代码中，使用 tag 函数将 100 和 'Balance' 标记结合起来，得到了一个 BalanceTag 类型的变量 balance。
现在，如果您尝试将 balance 变量的值更改为一个字符串，TypeScript 将会抛出一个类型错误，因为它只能包含数字值：
balance = tag('100', 'Balance'); // 报错：Type 'string' is not assignable to type 'number'
ts-tagged 的优势
使用 ts-tagged 可以让您在编译时执行更多的类型检查，从而减少运行时错误。例如，假设您正在开发一个银行应用程序，如果使用 number 类型来表示账户余额，那么可能会在一些地方意外地将支出金额添加到余额中，从而导致账户出现负数。但是，如果您使用带有 'Balance' 标记的 BalanceTag 类型来表示余额，则 TypeScript 将会在编译期间捕获这些错误。
除了提高代码可靠性之外，ts-tagged 还可以增加代码的清晰度和可读性。例如，假设您有一个函数，它接受一个数字参数，并返回一个带有 'Percent' 标记的类型：
function toPercent(num: number): Tagged<number, 'Percent'> { return tag(num, 'Percent'); }
使用该函数可以很容易地创建一个带有 'Percent' 标记的变量：
const rate: Tagged<number, 'Percent'> = toPercent(0.1);
这样，即使您不知道 rate 变量的确切类型，也可以通过它的标记 'Percent' 很容易地猜测出它表示的是一个百分比值。
示例代码
以下是一个使用 ts-tagged 的完整示例，它定义了带有 'Balance' 和 'Amount' 标记的类型，并演示了如何使用这些类型进行更严格的类型检查：
-- -------------------- ---- ------- ------ - ------- --- - ---- ------------ ---- ---------- - -------------- ----------- ---- --------- - -------------- ---------- -------- ------------------ ----------- ------- ----------- ---------- - ------ ----------- - ------- ----------- - ----- -------- ---------- - -------- ----------- ----- ------- --------- - ------- ---------- ----- ----------- ---------- - ------------------ -------- -- ----- ------------- ---------- - ------------------ --------- -- ------- ------------ -- --- ---------- -- ---- -----------展开代码
结
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/55037
