feat: isFile isBlob

README.md

@@ -24,7 +24,7 @@
 - 🛠️   Provide utilities frequently used in daily development
 - 🛠️   Utilities implementation is very lightweight
 - 🛠️   Written based on ts, providing complete ts types
-- 💪   Make sure more than 90% unit test coverage, providing stability assurance
+- 💪   Make sure more than 99% unit test coverage, providing stability assurance
 
 ### Installation
 

README.zh-CN.md

@@ -24,7 +24,7 @@
 - 🛠️   提供日常开发中经常使用的实用工具
 - 🛠️   工具实现非常轻量
 - 🛠️   使用 ts 编写，提供完善的类型支持
-- 💪   确保 90% 以上单元测试覆盖率，提供稳定性保证
+- 💪   确保 99% 以上单元测试覆盖率，提供稳定性保证
 
 ### 安装
 

docs/.vitepress/items/general.ts

@@ -17,6 +17,8 @@ export const generalItems = [
   { text: 'isSymbol', link: '/general/is-symbol' },
   { text: 'isWeakMap', link: '/general/is-weak-map' },
   { text: 'isWeakSet', link: '/general/is-weak-set' },
+  { text: 'isBlob', link: '/general/is-blob' },
+  { text: 'isFile', link: '/general/is-file' },
   { text: 'isArrayBuffer', link: '/general/is-array-buffer' },
   { text: 'isTypedArray', link: '/general/is-typed-array' },
   { text: 'isDataView', link: '/general/is-data-view' },

docs/general/is-blob.md

@@ -0,0 +1,23 @@
+# isBlob
+
+Determine whether the input value is a `Blob`.
+
+### Usage
+
+```ts
+import { isBlob } from 'rattail'
+
+isBlob(new Blob(['Hello, World!'], { type: 'text/plain' })) // return true
+```
+
+### Arguments
+
+| Arg     | Type  | Defaults |
+| ------- | :---: | -------: |
+| `value` | `any` |          |
+
+### Return
+
+|   Type    |
+| :-------: |
+| `boolean` |

docs/general/is-file.md

@@ -0,0 +1,24 @@
+# isFile
+
+Determine whether the input value is a `File`.
+
+### Usage
+
+```ts
+import { isFile } from 'rattail'
+
+isFile(new File(['Hello, world!'], 'hello.txt', { type: 'text/plain' }))
+// return true
+```
+
+### Arguments
+
+| Arg     | Type  | Defaults |
+| ------- | :---: | -------: |
+| `value` | `any` |          |
+
+### Return
+
+|   Type    |
+| :-------: |
+| `boolean` |

docs/index.md

@@ -20,7 +20,7 @@ features:
   - title: General
     details: Provide utilities frequently used in daily development
   - title: Tests Coverage
-    details: Make sure more than 90% unit test coverage, providing stability assurance
+    details: Make sure more than 99% unit test coverage, providing stability assurance
   - title: Lightweight
     details: Utilities implementation is very lightweight
   - title: Ts-friendly

docs/zh/general/is-blob.md

@@ -0,0 +1,23 @@
+# isBlob
+
+判断输入值是否是 `Blob`。
+
+### 使用
+
+```ts
+import { isBlob } from 'rattail'
+
+isBlob(new Blob(['Hello, World!'], { type: 'text/plain' })) // return true
+```
+
+### 参数列表
+
+| 参数    | 类型  | 默认值 |
+| ------- | :---: | -----: |
+| `value` | `any` |        |
+
+### 返回值
+
+|   类型    |
+| :-------: |
+| `boolean` |

docs/zh/general/is-file.md

@@ -0,0 +1,24 @@
+# isFile
+
+判断输入值是否是 `File`。
+
+### 使用
+
+```ts
+import { isFile } from 'rattail'
+
+isFile(new File(['Hello, world!'], 'hello.txt', { type: 'text/plain' }))
+// return true
+```
+
+### 参数列表
+
+| 参数    | 类型  | 默认值 |
+| ------- | :---: | -----: |
+| `value` | `any` |        |
+
+### 返回值
+
+|   类型    |
+| :-------: |
+| `boolean` |

docs/zh/index.md

@@ -17,7 +17,7 @@ features:
   - title: 通用
     details: 提供日常开发中经常使用的实用工具
   - title: 测试覆盖
-    details: 确保 90% 以上单元测试覆盖率，提供稳定性保证
+    details: 确保 99% 以上单元测试覆盖率，提供稳定性保证
   - title: 轻量
     details: 工具实现非常轻量
   - title: Ts 友好

src/general/index.ts

@@ -33,3 +33,5 @@ export * from './isWindow'
 export * from './supportTouch'
 export * from './toRawType'
 export * from './toTypeString'
+export * from './isFile'
+export * from './isBlob'

src/general/isBlob.ts

@@ -0,0 +1,5 @@
+import { toRawType } from './toRawType'
+
+export function isBlob(val: unknown): val is Blob {
+  return toRawType(val) === 'Blob'
+}

src/general/isFile.ts

@@ -0,0 +1,5 @@
+import { toRawType } from './toRawType'
+
+export function isFile(val: unknown): val is File {
+  return toRawType(val) === 'File'
+}

tests/general.spec.ts

@@ -1,4 +1,4 @@
-import { it, expect } from 'vitest'
+import { it, expect, vi } from 'vitest'
 import {
   isNonEmptyArray,
   isString,
@@ -20,6 +20,8 @@ import {
   isNullish,
   isWindow,
   isTruthy,
+  isFile,
+  isBlob,
   toRawType,
   hasOwn,
   supportTouch,
@@ -257,6 +259,16 @@ it('isWindow', () => {
   expect(isWindow(undefined)).toBe(false)
 })
 
+it('isFile', () => {
+  expect(isFile(new File([], 'test.txt'))).toBe(true)
+  expect(isFile(new Blob([]))).toBe(false)
+})
+
+it('isBlob', () => {
+  expect(isBlob(new Blob([]))).toBe(true)
+  expect(isBlob(new File([], 'test.txt'))).toBe(false)
+})
+
 it('hasOwn', () => {
   expect(hasOwn({ foo: 1 }, 'foo')).toBe(true)
   expect(hasOwn({ foo: 1 }, 'bar')).toBe(false)
@@ -276,7 +288,7 @@ it('inMobile', () => {
 })
 
 it('getGlobalThis', () => {
-  expect(getGlobalThis()).toBe(global)
+  expect(getGlobalThis()).toBe(globalThis)
   expect(getGlobalThis()).toBe(window)
   expect(getGlobalThis()).toBe(self)
 })

tests/math.spec.ts

@@ -51,4 +51,8 @@ it('sumHash', () => {
   const a: Record<string, any> = { a: '123', self: undefined }
   a.self = a
   expect(sumHash(a)).toBe('76b6e174')
+
+  const b: any = { a: '123' }
+  b.valueOf = undefined
+  expect(sumHash(b)).toBe('4d3182a6')
 })