@allkit/shared 0.0.1

package/src/device/__test__/device.test.ts

@@ -0,0 +1,138 @@
+import { describe, expect, test } from 'vitest'
+import { getDeviceBrand, EnumDeviceBrand } from '../'
+
+describe('device.ts', () => {
+  test('getDeviceBrand - iPhone设备', () => {
+    // 模拟iPhone的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.IPHONE)
+  })
+
+  test('getDeviceBrand - 小米设备', () => {
+    // 模拟小米设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value:
+        'Mozilla/5.0 (Linux; U; Android 15; zh-cn; 23116PN5BC Build/AQ3A.240627.003) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.6261.119 Mobile Safari/537.36 XiaoMi/MiuiBrowser/19.7.30708',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.XIAOMI)
+  })
+
+  test('getDeviceBrand - OPPO设备', () => {
+    // 模拟OPPO设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Linux; Android 10; OPPO R11)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.OPPO)
+  })
+
+  test('getDeviceBrand - VIVO设备', () => {
+    // 模拟VIVO设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value:
+        'Mozilla/5.0 (Linux; Android 15; V2227A) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.6778.200 Mobile Safari/537.36 VivoBrowser/26.3.3.0',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.VIVO)
+  })
+
+  test('getDeviceBrand - 华为设备', () => {
+    // 模拟华为设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Linux; Android 10; HUAWEI P40)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.HUAWEI)
+  })
+
+  test('getDeviceBrand - 荣耀设备', () => {
+    // 模拟荣耀设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Linux; Android 10; Honor 30)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.HONOR)
+  })
+
+  test('getDeviceBrand - 一加设备', () => {
+    // 模拟一加设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Linux; Android 10; ONEPLUS A6000)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.ONE_PLUS)
+  })
+
+  test('getDeviceBrand - 三星设备', () => {
+    // 模拟三星设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Linux; Android 10; SAMSUNG Galaxy S21)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.SAMSUNG)
+  })
+
+  test('getDeviceBrand - 魅族设备', () => {
+    // 模拟魅族设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Linux; Android 10; MEIZU 18)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.MEIZU)
+  })
+
+  test('getDeviceBrand - 联想设备', () => {
+    // 模拟联想设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Linux; Android 10; LENOVO Legion)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(EnumDeviceBrand.LENOVO)
+  })
+
+  test('getDeviceBrand - 未知设备', () => {
+    // 模拟未知设备的userAgent
+    Object.defineProperty(navigator, 'userAgent', {
+      writable: true,
+      configurable: true,
+      value: 'Mozilla/5.0 (Unknown Device)',
+    })
+
+    const brand = getDeviceBrand()
+    expect(brand).toBe(undefined)
+  })
+})

package/src/device/index.ts

@@ -0,0 +1,125 @@
+/**
+ * 是否是Android客户端
+ * @example
+ * ```ts
+ * let result= isAndroid()
+ * ```
+ */
+
+export function isAndroid() {
+  return navigator.userAgent.indexOf('Android') > -1
+}
+/**
+ * 是否是ios客户端
+ * @example
+ * ```ts
+ * let result= isIos()
+ * ```
+ */
+export function isIos() {
+  return /(iPhone|iPad|iPod)/i.test(navigator.userAgent)
+}
+
+/**
+ * 是否是鸿蒙系统
+ * @example
+ * ```ts
+ * let result= isHarmony()
+ * ```
+ */
+export function isHarmony() {
+  return window.navigator.userAgent.includes('OpenHarmony')
+}
+
+/**
+ * 是否是微信客户端
+ * @example
+ * ```ts
+ * let result= isWeChat()
+ * ```
+ */
+export function isWeChat() {
+  return navigator.userAgent.toLowerCase().indexOf('micromessenger') !== -1
+}
+/**
+ * 是否是微信小程序
+ * @example
+ * ```ts
+ * let result= isWxMiniProgram()
+ * ```
+ */
+export function isWxMiniProgram() {
+  return isWeChat() && window.navigator.userAgent.includes('miniProgram')
+}
+
+export enum EnumDeviceBrand {
+  /** 小米 */
+  XIAOMI = 'xiaomi',
+  /** OPPO */
+  OPPO = 'oppo',
+  /** Vivo */
+  VIVO = 'vivo',
+  /** 华为 */
+  HUAWEI = 'huawei',
+  /** 荣耀 */
+  HONOR = 'honor',
+  /** 一加 */
+  ONE_PLUS = 'oneplus',
+  /** 三星 */
+  SAMSUNG = 'samsung',
+  /** 苹果 */
+  IPHONE = 'iphone',
+  /** 魅族 */
+  MEIZU = 'meizu',
+  /** 联想 */
+  LENOVO = 'lenovo',
+}
+
+/**
+ * 获取设备厂商
+ * @example
+ * ```ts
+ * let brand = getDeviceBrand()
+ * ```
+ */
+export function getDeviceBrand() {
+  const userAgent = navigator.userAgent.toLowerCase()
+  if (userAgent.includes('iphone') || userAgent.includes('ipad') || userAgent.includes('ipod')) {
+    return EnumDeviceBrand.IPHONE
+  }
+
+  if (
+    userAgent.includes('xiaomi') ||
+    userAgent.includes('miui') ||
+    userAgent.includes('redmi') ||
+    userAgent.includes('mix')
+  ) {
+    return EnumDeviceBrand.XIAOMI
+  }
+  if (userAgent.includes('oppo') || userAgent.includes('realme') || userAgent.includes('heytap')) {
+    return EnumDeviceBrand.OPPO
+  }
+  if (userAgent.includes('vivo')) {
+    return EnumDeviceBrand.VIVO
+  }
+  if (userAgent.includes('huawei')) {
+    return EnumDeviceBrand.HUAWEI
+  }
+  if (userAgent.includes('oneplus')) {
+    return EnumDeviceBrand.ONE_PLUS
+  }
+  if (userAgent.includes('honor')) {
+    return EnumDeviceBrand.HONOR
+  }
+
+  if (userAgent.includes('samsung')) {
+    return EnumDeviceBrand.SAMSUNG
+  }
+  if (userAgent.includes('meizu')) {
+    return EnumDeviceBrand.MEIZU
+  }
+  if (userAgent.includes('lenovo')) {
+    return EnumDeviceBrand.LENOVO
+  }
+  return undefined
+}

package/src/element/index.ts

@@ -0,0 +1,100 @@
+import { isClient, isWindow } from '../is'
+
+export const getGlobalThis = () => {
+  if (typeof globalThis !== 'undefined') {
+    return globalThis
+  }
+
+  if (isClient) {
+    return window
+  }
+  //@ts-ignore
+  return typeof global !== 'undefined' ? global : self
+}
+
+export const requestAnimationFrame = (fn: FrameRequestCallback): number => {
+  const globalThis = getGlobalThis()
+
+  return globalThis.requestAnimationFrame
+    ? globalThis.requestAnimationFrame(fn)
+    : globalThis.setTimeout(fn)
+}
+
+export const cancelAnimationFrame = (handle: number) => {
+  const globalThis = getGlobalThis()
+
+  globalThis.cancelAnimationFrame
+    ? globalThis.cancelAnimationFrame(handle)
+    : globalThis.clearTimeout(handle)
+}
+
+export const raf = () =>
+  new Promise((resolve) => {
+    requestAnimationFrame(resolve)
+  })
+
+export const doubleRaf = () =>
+  new Promise((resolve) => {
+    requestAnimationFrame(() => {
+      requestAnimationFrame(resolve)
+    })
+  })
+
+// shorthand only
+export const getStyle = (element: Element) => window.getComputedStyle(element)
+
+/** 获取dom的rect */
+export const getRect = (element: Element | Window): DOMRect => {
+  if (isWindow(element)) {
+    const width = element.innerWidth
+    const height = element.innerHeight
+    const rect = {
+      x: 0,
+      y: 0,
+      top: 0,
+      left: 0,
+      right: width,
+      bottom: height,
+      width,
+      height,
+    }
+
+    return {
+      ...rect,
+      toJSON: () => rect,
+    }
+  }
+
+  return element.getBoundingClientRect()
+}
+
+export const inViewport = (element: HTMLElement) => {
+  const { top, bottom, left, right } = getRect(element)
+  const { width, height } = getRect(window)
+
+  const xInViewport = left <= width && right >= 0
+  const yInViewport = top <= height && bottom >= 0
+
+  return xInViewport && yInViewport
+}
+
+export const preventDefault = (event: Event) => {
+  if (event.cancelable === false) {
+    return
+  }
+
+  event.preventDefault()
+}
+
+export const getScrollTop = (element: Element | Window) => {
+  const top = 'scrollTop' in element ? element.scrollTop : element.scrollY
+
+  // iOS scroll bounce cause minus scrollTop
+  return Math.max(top, 0)
+}
+
+export const getScrollLeft = (element: Element | Window) => {
+  const left = 'scrollLeft' in element ? element.scrollLeft : element.scrollX
+
+  return Math.max(left, 0)
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+export * from './clipboard'
+export * from './cloneDeep'
+export * from './cookie'
+export * from './date'
+export * from './device'
+export * from './element'
+export * from './is'
+export * from './lodash'
+export * from './number'
+export * from './storage'
+export * from './string'
+export * from './timer'
+
+export * from './constants'

package/src/is/__test__/is.test.ts

@@ -0,0 +1,320 @@
+import { describe, expect, test } from 'vitest'
+import { isEmpty, isEmptyValue, isInteger, isNumeric, isObject, isPlainObject } from '../'
+
+describe('is.ts', () => {
+  test('isObject - param simple object', () => {
+    const obj = {
+      a: 1,
+      b: 2,
+    }
+    expect(isObject(obj)).toBe(true)
+  })
+  test('isObject - param not object', () => {
+    const obj = 1
+    expect(isObject(obj)).toBe(false)
+  })
+  test('isObject - param null', () => {
+    const obj = null
+    expect(isObject(obj)).toBe(false)
+  })
+  test('isObject - param undefined', () => {
+    const obj = undefined
+    expect(isObject(obj)).toBe(false)
+  })
+  test('isObject - param array', () => {
+    const obj = [1, 2, 3]
+    expect(isObject(obj)).toBe(true)
+  })
+  test('isObject - param function', () => {
+    const obj = () => {
+      console.log('111')
+    }
+    expect(isObject(obj)).toBe(false)
+  })
+  test('isObject - param date', () => {
+    const obj = new Date()
+    expect(isObject(obj)).toBe(true)
+  })
+  test('isObject - param map', () => {
+    const obj = new Map()
+    expect(isObject(obj)).toBe(true)
+  })
+  test('isObject - param set', () => {
+    const obj = new Set()
+    expect(isObject(obj)).toBe(true)
+  })
+
+  test('isPlainObject - param simple object', () => {
+    const obj = {
+      a: 1,
+      b: 2,
+    }
+    expect(isPlainObject(obj)).toBe(true)
+  })
+  test('isPlainObject - param not object', () => {
+    const obj = 1
+    expect(isPlainObject(obj)).toBe(false)
+  })
+  test('isPlainObject - param null', () => {
+    const obj = null
+    expect(isPlainObject(obj)).toBe(false)
+  })
+  test('isPlainObject - param undefined', () => {
+    const obj = undefined
+    expect(isPlainObject(obj)).toBe(false)
+  })
+  test('isPlainObject - param array', () => {
+    const obj = [1, 2, 3]
+    expect(isPlainObject(obj)).toBe(false)
+  })
+
+  test('isEmpty - param not object', () => {
+    const obj = 1
+    expect(isEmpty(obj)).toBe(false)
+  })
+  test('isEmpty - param empty object', () => {
+    const obj = {}
+    expect(isEmpty(obj)).toBe(true)
+  })
+  test('isEmpty - param empty array', () => {
+    const obj = [] as any[]
+    expect(isEmpty(obj)).toBe(true)
+  })
+  test('isEmpty - param empty map', () => {
+    const obj = new Map()
+    expect(isEmpty(obj)).toBe(true)
+  })
+  test('isEmpty - param empty set', () => {
+    const obj = new Set()
+    expect(isEmpty(obj)).toBe(true)
+  })
+  test('isEmpty - param empty string', () => {
+    const obj = ''
+    expect(isEmpty(obj)).toBe(true)
+  })
+
+  test('isEmptyValue - param not object', () => {
+    const obj = 1
+    expect(isEmptyValue(obj)).toBe(false)
+  })
+  test('isEmptyValue - param empty string', () => {
+    const obj = ''
+    expect(isEmptyValue(obj)).toBe(true)
+  })
+  test('isEmptyValue - param null', () => {
+    const obj = null
+    expect(isEmptyValue(obj)).toBe(true)
+  })
+  test('isEmptyValue - param undefined', () => {
+    const obj = undefined
+    expect(isEmptyValue(obj)).toBe(true)
+  })
+
+  test('isEmptyValue - param 0', () => {
+    const obj = 0
+    expect(isEmptyValue(obj)).toBe(false)
+  })
+
+  test('isNumeric - param null', () => {
+    const obj = null
+    expect(isNumeric(obj)).toBe(false)
+  })
+  test('isNumeric - param undefined', () => {
+    const obj = undefined
+    expect(isNumeric(obj)).toBe(false)
+  })
+
+  test('isNumeric - param is object', () => {
+    const obj = {}
+    expect(isNumeric(obj)).toBe(false)
+  })
+
+  test('isNumeric - param 0', () => {
+    const obj = 0
+    expect(isNumeric(obj)).toBe(true)
+  })
+  test('isNumeric - param 0', () => {
+    const obj = '0'
+    expect(isNumeric(obj)).toBe(true)
+  })
+  test('isNumeric - param 1', () => {
+    const obj = 1
+    expect(isNumeric(obj)).toBe(true)
+  })
+  test('isNumeric - param 1 string', () => {
+    const obj = '1'
+    expect(isNumeric(obj)).toBe(true)
+  })
+
+  test('isNumeric - param 1.1 string', () => {
+    const obj = '1.1'
+    expect(isNumeric(obj)).toBe(true)
+  })
+
+  test('isNumeric - param 1.1.1', () => {
+    const obj = '1.1.1'
+    expect(isNumeric(obj)).toBe(false)
+  })
+
+  // isInteger 测试
+  test('isInteger - param positive integer number', () => {
+    expect(isInteger(123)).toBe(true)
+  })
+
+  test('isInteger - param negative integer number', () => {
+    expect(isInteger(-456)).toBe(true)
+  })
+
+  test('isInteger - param zero', () => {
+    expect(isInteger(0)).toBe(true)
+  })
+
+  test('isInteger - param positive integer string', () => {
+    expect(isInteger('123')).toBe(true)
+  })
+
+  test('isInteger - param negative integer string', () => {
+    expect(isInteger('-456')).toBe(true)
+  })
+
+  test('isInteger - param zero string', () => {
+    expect(isInteger('0')).toBe(true)
+  })
+
+  test('isInteger - param float number', () => {
+    expect(isInteger(3.14)).toBe(false)
+  })
+
+  test('isInteger - param float string', () => {
+    expect(isInteger('3.14')).toBe(false)
+  })
+
+  test('isInteger - param string with trailing dot', () => {
+    expect(isInteger('1.')).toBe(false)
+  })
+
+  test('isInteger - param string with leading dot', () => {
+    expect(isInteger('.5')).toBe(false)
+  })
+
+  test('isInteger - param NaN', () => {
+    expect(isInteger(NaN)).toBe(false)
+  })
+
+  test('isInteger - param Infinity', () => {
+    expect(isInteger(Infinity)).toBe(false)
+  })
+
+  test('isInteger - param -Infinity', () => {
+    expect(isInteger(-Infinity)).toBe(false)
+  })
+
+  test('isInteger - param empty string', () => {
+    expect(isInteger('')).toBe(false)
+  })
+
+  test('isInteger - param non-numeric string', () => {
+    expect(isInteger('abc')).toBe(false)
+  })
+
+  test('isInteger - param null', () => {
+    expect(isInteger(null)).toBe(false)
+  })
+
+  test('isInteger - param undefined', () => {
+    expect(isInteger(undefined)).toBe(false)
+  })
+
+  test('isInteger - param object', () => {
+    expect(isInteger({})).toBe(false)
+  })
+
+  test('isInteger - param array', () => {
+    expect(isInteger([1, 2, 3])).toBe(false)
+  })
+
+  test('isInteger - param string with leading zeros', () => {
+    expect(isInteger('007')).toBe(false)
+  })
+
+  test('isInteger - param string with spaces', () => {
+    expect(isInteger(' 123 ')).toBe(false)
+  })
+
+  test('isInteger - param string with plus sign', () => {
+    expect(isInteger('+123')).toBe(false)
+  })
+
+  // isNumeric 额外测试
+  test('isNumeric - param positive float number', () => {
+    expect(isNumeric(3.14)).toBe(true)
+  })
+
+  test('isNumeric - param negative float number', () => {
+    expect(isNumeric(-0.5)).toBe(true)
+  })
+
+  test('isNumeric - param positive float string', () => {
+    expect(isNumeric('3.14')).toBe(true)
+  })
+
+  test('isNumeric - param negative float string', () => {
+    expect(isNumeric('-0.5')).toBe(true)
+  })
+
+  test('isNumeric - param negative integer string', () => {
+    expect(isNumeric('-789')).toBe(true)
+  })
+
+  test('isNumeric - param string with trailing dot', () => {
+    expect(isNumeric('1.')).toBe(false)
+  })
+
+  test('isNumeric - param string with leading dot', () => {
+    expect(isNumeric('.5')).toBe(false)
+  })
+
+  test('isNumeric - param NaN', () => {
+    expect(isNumeric(NaN)).toBe(false)
+  })
+
+  test('isNumeric - param Infinity', () => {
+    expect(isNumeric(Infinity)).toBe(false)
+  })
+
+  test('isNumeric - param -Infinity', () => {
+    expect(isNumeric(-Infinity)).toBe(false)
+  })
+
+  test('isNumeric - param empty string', () => {
+    expect(isNumeric('')).toBe(false)
+  })
+
+  test('isNumeric - param non-numeric string', () => {
+    expect(isNumeric('abc')).toBe(false)
+  })
+
+  test('isNumeric - param array', () => {
+    expect(isNumeric([1, 2, 3])).toBe(false)
+  })
+
+  test('isNumeric - param string with leading zeros', () => {
+    expect(isNumeric('007')).toBe(false)
+  })
+
+  test('isNumeric - param string with spaces', () => {
+    expect(isNumeric(' 123 ')).toBe(false)
+  })
+
+  test('isNumeric - param string with plus sign', () => {
+    expect(isNumeric('+123')).toBe(false)
+  })
+
+  test('isNumeric - param scientific notation string', () => {
+    expect(isNumeric('1e10')).toBe(false)
+  })
+
+  test('isNumeric - param multiple dots', () => {
+    expect(isNumeric('1.2.3')).toBe(false)
+  })
+})