feat: 新增 ii

src/ii.ts

@@ -0,0 +1,13 @@
+import { AnyFunction } from './isFunction'
+
+/**
+ * 立即调用函数并返回其返回值。
+ *
+ * 注：`ii = immediately invoke`
+ *
+ * @param fn 要调用的函数
+ * @returns 返回被调用函数的返回值
+ */
+export function ii<F extends AnyFunction>(fn: F): ReturnType<F> {
+  return fn()
+}

src/index.ts

@@ -23,6 +23,7 @@ export * from './getDaysInMonth'
 export * from './getType'
 export * from './groupBy'
 export * from './has'
+export * from './ii'
 export * from './inBrowser'
 export * from './includes'
 export * from './inNode'

test/index.test.ts

@@ -1783,3 +1783,20 @@ describe('request', () => {
     server.close()
   })
 })
+
+describe('ii', () => {
+  test('ok', () => {
+    typedExpectEqual(
+      vtils.ii(() => 1),
+      1,
+    )
+    typedExpectEqual(
+      vtils.ii(() => [2]),
+      [2],
+    )
+    typedExpectEqual(
+      vtils.ii(() => ({ hello: 'world' })),
+      { hello: 'world' },
+    )
+  })
+})