getUA

实用函数,用于返回当前用户代理字符串,或允许覆盖该字符串。

使用场景

  • 用户代理检测:获取当前浏览器的用户代理字符串。
  • 测试:覆盖用户代理以测试不同的浏览器环境。
  • 功能检测:根据用户代理有条件地启用功能。

示例

import { getUA } from 'funtool';

// 获取当前用户代理
const ua = getUA(); // 例如: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..."

// 覆盖用户代理以进行测试
const testUA = getUA('Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)');

函数签名

function getUA(overrideUA?: string): string

参数

  • overrideUA:可选字符串,用于覆盖检测到的用户代理。

返回值

返回:

  • 如果提供了 overrideUA 字符串,则返回该字符串。
  • 如果可用,则返回 navigator.userAgent 字符串。
  • 如果以上两者都不可用,则返回空字符串。

注意事项

  • 主要供其他与用户代理相关的实用工具内部使用。
  • 对于测试移动/桌面行为很有用。
  • 在非浏览器环境中返回空字符串。