feat: assert fn

.vscode/settings.json

@@ -13,5 +13,8 @@
   "editor.formatOnSave": true,
   "[sql]": {
     "editor.formatOnSave": false
+  },
+  "[json]": {
+    "editor.defaultFormatter": "denoland.vscode-deno"
   }
 }

ts/README.md

@@ -0,0 +1,10 @@
+# TypeScript 相关函数说明
+
+该文件夹内的代码分为三种:
+
+1. 类型.
+2. 类型判断函数.
+3. 类型断言函数.
+
+类型断言函数在已知 API 结构等场景下非常有用. 类型断言函数不同于普通的 `as` 断言,
+`as` 断言一般不会做任何检查, 而类型断言函数而是真的做了一些检查.

ts/object.ts

@@ -14,3 +14,20 @@ export function isUnknownObject(v: unknown): v is UnknownObject {
   }
   return true;
 }
+
+/** 断言为未知对象 */
+export function assertUnknownObject(v: unknown): asserts v is UnknownObject {
+  if (typeof v !== 'object' || v === null) {
+    throw new TypeError('Expected an object');
+  }
+}
+
+/**
+ * 断言为数组
+ * @param v 需要断言的变量
+ */
+export function assertArray(v: unknown): asserts v is Array<unknown> {
+  if (!Array.isArray(v)) {
+    throw new TypeError('Expected an array');
+  }
+}