feat(wait): 新增 wait.reject

src/utils/wait.test.ts

@@ -1,6 +1,7 @@
+import { run } from './run'
 import { wait } from './wait'
 
-describe(wait.name, () => {
+describe('wait', () => {
   test('表现正常', async () => {
     const start = Date.now()
     await wait(110)
@@ -17,3 +18,22 @@ describe(wait.name, () => {
     expect(cb).not.toBeCalled()
   })
 })
+
+describe('wait.reject', () => {
+  test('表现正常', async () => {
+    const start = Date.now()
+    const [err] = await run(() => wait.reject(110))
+    expect(err).not.toBeNull()
+    const end = Date.now()
+    expect(end - start >= 100).toBeTrue()
+  })
+
+  test('可取消等待', async () => {
+    const cb = jest.fn()
+    const w = wait.reject(100)
+    w.catch(cb)
+    w.cancel()
+    await wait(100)
+    expect(cb).not.toBeCalled()
+  })
+})

src/utils/wait.ts

@@ -28,3 +28,22 @@ export function wait(milliseconds: number): WaitResult {
   result.cancel = () => clearTimeout(timer)
   return result
 }
+
+/**
+ * 等待一段时间后 reject。
+ *
+ * @public
+ * @param milliseconds 等待时间(毫秒)
+ * @example
+ * ```typescript
+ * wait.reject(1000).catch(() => {
+ *   console.log('ok')
+ * }) // => 1秒后在控制台打印字符串: ok
+ * ```
+ */
+wait.reject = function reject(milliseconds: number): WaitResult {
+  const waitRes = wait(milliseconds)
+  const res: WaitResult = waitRes.then(() => Promise.reject()) as any
+  res.cancel = waitRes.cancel
+  return res
+}