@base-web-kits/base-tools-web 1.2.6 → 1.2.7

package/dist/index.d.cts

@@ -0,0 +1,640 @@
+/**
+ * 复制文本到剪贴板（兼容移动端和PC）
+ * @returns Promise<void> 复制成功时 resolve，失败时 reject。
+ * @example
+ * await copyText('hello');
+ * toast('复制成功');
+ */
+declare function copyText(text: string): Promise<void>;
+/**
+ * 复制富文本 HTML 到剪贴板（移动端与 PC）
+ * 使用场景：图文混排文章、带样式段落，保留格式粘贴。
+ * @param html HTML字符串
+ * @example
+ * await copyHtml('<p><b>加粗</b> 与 <i>斜体</i></p>');
+ */
+declare function copyHtml(html: string): Promise<void>;
+/**
+ * 复制 DOM 节点到剪贴板（移动端与 PC）
+ * 使用场景：页面已有区域的可视化复制；元素使用 `outerHTML`，非元素使用其文本内容。
+ * @param node DOM 节点（元素或文本节点）
+ * @example
+ * const el = document.querySelector('#article')!;
+ * await copyNode(el);
+ */
+declare function copyNode(node: Node): Promise<void>;
+/**
+ * 复制单张图片到剪贴板（移动端与 PC，需浏览器支持 `ClipboardItem`）
+ * 使用场景：把本地 `canvas` 或 `Blob` 生成的图片直接粘贴到聊天/文档。
+ * @param image 图片源（Blob/Canvas/ImageBitmap）
+ * @example
+ * const canvas = document.querySelector('canvas')!;
+ * await copyImage(canvas);
+ */
+declare function copyImage(image: Blob | HTMLCanvasElement | ImageBitmap): Promise<void>;
+/**
+ * 复制 URL 到剪贴板（移动端与 PC）
+ * 写入 `text/uri-list` 与 `text/plain`，在支持 URI 列表的应用中可识别为链接。
+ * @param url 完整的 URL 字符串
+ * @example
+ * await copyUrl('https://example.com/page');
+ */
+declare function copyUrl(url: string): Promise<void>;
+/**
+ * 复制任意 Blob 到剪贴板（移动端与 PC，需 `ClipboardItem`）
+ * 使用场景：原生格式粘贴（如 `image/svg+xml`、`application/pdf` 等）。
+ * @param blob 任意 Blob 数据
+ * @example
+ * const svg = new Blob(['<svg></svg>'], { type: 'image/svg+xml' });
+ * await copyBlob(svg);
+ */
+declare function copyBlob(blob: Blob): Promise<void>;
+/**
+ * 复制 RTF 富文本到剪贴板（移动端与 PC）
+ * 同时写入 `text/plain`，增强与 Office/富文本编辑器的兼容性。
+ * @param rtf RTF 字符串（如：`{\\rtf1\\ansi ...}`）
+ * @example
+ * await copyRtf('{\\rtf1\\ansi Hello \\b World}');
+ */
+declare function copyRtf(rtf: string): Promise<void>;
+/**
+ * 复制表格到剪贴板（移动端与 PC）
+ * 同时写入多种 MIME：`text/html`（表格）、`text/tab-separated-values`（TSV）、`text/csv`、`text/plain`（TSV）。
+ * 使用场景：优化粘贴到 Excel/Google Sheets/Docs 的体验
+ * @param rows 二维数组，每行一个数组（字符串/数字）
+ * @example
+ * await copyTable([
+ *   ['姓名', '分数'],
+ *   ['张三', 95],
+ *   ['李四', 88],
+ * ]);
+ */
+declare function copyTable(rows: Array<Array<string | number>>): Promise<void>;
+
+type AppConfig = {
+    /** 全局 Toast 提示 */
+    toast?: (option: {
+        msg: string;
+        status: 'success' | 'fail';
+    }) => void;
+    /** 显示全局 Loading */
+    showLoading?: (option?: {
+        title?: string;
+    }) => void;
+    /** 隐藏全局 Loading */
+    hideLoading?: () => void;
+    /** 跳转登录页的方法 */
+    toLogin?: () => void;
+    /** 日志记录函数 */
+    log?: (level: 'info' | 'error' | 'warn' | 'debug', data: AppLogInfo) => void;
+};
+type AppLogInfo = {
+    /** 调用函数的名称 */
+    name: string;
+    /** 函数的调用状态 */
+    status?: 'success' | 'fail';
+    /** 函数的调用参数 */
+    option?: unknown;
+    /** 函数的调用结果 */
+    res?: unknown;
+    /** 函数的调用错误 */
+    e?: unknown;
+    /** 日志描述 */
+    desc?: string;
+    [key: string]: unknown;
+};
+/**
+ * 获取应用配置
+ */
+declare function getBaseToolsConfig(): AppConfig;
+/**
+ * 初始化应用配置 (在入口文件设置)
+ * @example
+ * setBaseToolsConfig({
+ * toast: ({ msg, status }) => (status === 'fail' ? message.error(msg) : message.success(msg)),
+ * showLoading: () => message.loading('加载中...'),
+ * hideLoading: () => message.destroy(),
+ * toLogin: () => reLogin(),
+ * log(level, data) {
+ *   if (data.name === 'request') {
+ *     sendLog('request', data); // 请求日志
+ *   } else if (level === 'error') {
+ *     sendLog('error', data); // 错误日志
+ *   } else {
+ *     sendLog('action', data); // 操作日志
+ *   }
+ * },
+ * });
+ */
+declare function setBaseToolsConfig(newConfig: AppConfig): void;
+
+/**
+ * 设置 Cookie（路径默认为 `/`）
+ * @param name Cookie 名称
+ * @param value Cookie 值（内部已使用 `encodeURIComponent` 编码）
+ * @param days 过期天数（从当前时间起算）
+ * @example
+ * setCookie('token', 'abc', 7);
+ */
+declare function setCookie(name: string, value: string, days: number): void;
+/**
+ * 获取 Cookie
+ * @param name Cookie 名称
+ * @returns 若存在返回解码后的值，否则 `null`
+ * @example
+ * const token = getCookie('token');
+ */
+declare function getCookie(name: string): string | null;
+/**
+ * 移除 Cookie（通过设置过期时间为过去）
+ * 路径固定为 `/`，确保与默认写入路径一致。
+ * @param name Cookie 名称
+ * @example
+ * removeCookie('token');
+ */
+declare function removeCookie(name: string): void;
+
+/**
+ * 获取用户代理字符串（UA）
+ * @returns navigator.userAgent.toLowerCase();
+ */
+declare function getUA(): string;
+/**
+ * 是否为移动端设备（含平板）
+ */
+declare function isMobile(): boolean;
+/**
+ * 是否为平板设备
+ */
+declare function isTablet(): boolean;
+/**
+ * 是否为 PC 设备
+ */
+declare function isPC(): boolean;
+/**
+ * 是否为 iOS 系统
+ */
+declare function isIOS(): boolean;
+/**
+ * 是否为 Android 系统
+ */
+declare function isAndroid(): boolean;
+/**
+ * 是否微信内置浏览器
+ */
+declare function isWeChat(): boolean;
+/**
+ * 是否为 Chrome 浏览器
+ * 已排除 Edge、Opera 等基于 Chromium 的浏览器
+ */
+declare function isChrome(): boolean;
+/**
+ * 检测是否支持触摸事件
+ */
+declare function isTouchSupported(): boolean;
+/**
+ * 获取设备像素比
+ */
+declare function getDevicePixelRatio(): number;
+/**
+ * 获取浏览器名字
+ */
+declare function getBrowserName(): string | null;
+/**
+ * 获取浏览器版本号
+ */
+declare function getBrowserVersion(): string | null;
+/**
+ * 获取操作系统信息
+ */
+declare function getOS(): string;
+
+/**
+ * 获取窗口宽度（不含滚动条）
+ * @returns 窗口宽度
+ */
+declare function getWindowWidth(): number;
+/**
+ * 获取窗口高度（不含滚动条）
+ * @returns 窗口高度
+ */
+declare function getWindowHeight(): number;
+/**
+ * 获取文档垂直滚动位置
+ * @example
+ * const top = getWindowScrollTop();
+ */
+declare function getWindowScrollTop(): number;
+/**
+ * 获取文档水平滚动位置
+ * @example
+ * const left = getWindowScrollLeft();
+ */
+declare function getWindowScrollLeft(): number;
+/**
+ * 平滑滚动到指定位置
+ * @param top 目标纵向滚动位置
+ * @param behavior 滚动行为，默认 'smooth'
+ * @example
+ * windowScrollTo(0);
+ */
+declare function windowScrollTo(top: number, behavior?: ScrollBehavior): void;
+/**
+ * 元素是否在视口内（可设置阈值）
+ * @param el 目标元素
+ * @param offset 额外判定偏移（像素，正数放宽，负数收紧）
+ * @returns 是否在视口内
+ */
+declare function isInViewport(el: Element, offset?: number): boolean;
+/**
+ * 锁定页面滚动（移动端/PC）
+ * 使用 `body{ position: fixed }` 技术消除滚动条抖动，记录并恢复滚动位置。
+ * @example
+ * lockBodyScroll();
+ */
+declare function lockBodyScroll(): void;
+/**
+ * 解除页面滚动锁定，恢复原始滚动位置
+ * @example
+ * unlockBodyScroll();
+ */
+declare function unlockBodyScroll(): void;
+
+/**
+ * 下载文件
+ * @param url 完整的下载地址 | base64字符串 | Blob对象
+ * @param fileName 自定义文件名（需含后缀）
+ * @example
+ * download('https://xx/xx.pdf');
+ * download('https://xx/xx.pdf', 'xx.pdf');
+ * download(blob, '图片.jpg');
+ */
+declare function download(url: string | Blob, fileName?: string): Promise<void>;
+/**
+ * 获取文件名
+ * @param disposition content-disposition头值
+ * @returns content-disposition中的filename
+ * @example
+ * const fileName = getDispositionFileName(headers['content-disposition']);
+ */
+declare function getDispositionFileName(disposition?: string): string;
+/**
+ * 动态加载 JS（重复执行不会重复加载，内部已排重）
+ * @param src js 文件路径
+ * @param attrs 可选的脚本属性，如 async、defer、crossOrigin
+ * @example
+ * await loadJs('https://xx/xx.js');
+ * await loadJs('/a.js', { defer: true });
+ */
+declare function loadJs(src: string, attrs?: Pick<HTMLScriptElement, 'async' | 'defer' | 'crossOrigin'>): Promise<void>;
+/**
+ * 判断某个 JS 地址是否已在页面中加载过
+ * @param src 相对、绝对路径的 JS 地址
+ * @returns 是否已加载过
+ * @example
+ * hasJs('https://xx/xx.js'); // boolean
+ * hasJs('/xx.js'); // boolean
+ * hasJs('xx.js'); // boolean
+ */
+declare function hasJs(src: string): boolean;
+/**
+ * 动态加载 CSS（重复执行不会重复加载，内部已排重）
+ * @param href css 文件地址
+ * @param attrs 可选属性，如 crossOrigin、media
+ * @example
+ * await loadCss('https://xx/xx.css');
+ * await loadCss('/a.css', { media: 'print' });
+ */
+declare function loadCss(href: string, attrs?: Pick<HTMLLinkElement, 'crossOrigin' | 'media'>): Promise<void>;
+/**
+ * 判断某个 CSS 地址是否已在页面中加载过
+ * @param href 相对、绝对路径的 CSS 地址
+ * @returns 是否已加载过
+ * @example
+ * hasCss('https://xx/xx.css'); // boolean
+ */
+declare function hasCss(href: string): boolean;
+/**
+ * 预加载图片
+ * @param src 图片地址
+ * @returns Promise<HTMLImageElement>
+ * @example
+ * await preloadImage('/a.png');
+ */
+declare function preloadImage(src: string): Promise<HTMLImageElement>;
+
+/** 请求方法类型 */
+type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'HEAD' | 'OPTIONS' | 'TRACE' | 'PATCH';
+/**
+ * 请求参数类型
+ * 包含 fetch 原生支持的 BodyInit 类型，以及支持自动 JSON 序列化的对象和数组
+ */
+type RequestData = string | ArrayBuffer | ArrayBufferView | Blob | FormData | URLSearchParams | ReadableStream<Uint8Array> | Record<string, unknown> | unknown[] | null;
+/**
+ * 响应数据类型
+ */
+type ResponseData = string | ArrayBuffer | Blob | Record<string, unknown> | unknown[] | null;
+/**
+ * 发起请求的配置 (对外,参数可选)
+ */
+type RequestConfig<D extends RequestData = RequestData> = Partial<RequestConfigBase<D>>;
+/**
+ * 自定义请求的配置 (接口字段参数必填)
+ */
+type RequestConfigBase<D extends RequestData = RequestData> = {
+    /** 接口地址 */
+    url: string;
+    /** 请求方法 */
+    method?: RequestMethod;
+    /** 请求头(会自动过滤undefined, null, "";不过滤0和false; 数字和布尔值会自动转换为字符串) */
+    header?: Record<string, string | number | boolean | null | undefined>;
+    /** 请求参数 */
+    data?: D;
+    /** 超时时间 (毫秒), 默认 60000 */
+    timeout?: number;
+    /** 接口返回响应数据的字段, 支持"a[0].b.c"的格式, 当配置false时返回完整的响应数据 */
+    resKey: string | false;
+    /** 接口返回响应消息的字段, 支持"a[0].b.c"的格式 */
+    msgKey: string;
+    /** 接口返回响应状态码的字段, 支持"a[0].b.c"的格式 */
+    codeKey: string;
+    /** 接口返回成功状态码的字段, 支持"a[0].b.c"的格式 (默认取 codeKey) */
+    successKey?: string;
+    /** 成功状态码 */
+    successCode: (number | string)[];
+    /** 登录过期状态码 */
+    reloginCode: (number | string)[];
+    /** 是否开启流式传输 (如 SSE) */
+    enableChunked?: boolean;
+    /** 响应类型 (默认 json, enableChunked为true时忽略) */
+    responseType?: 'text' | 'arraybuffer' | 'json';
+    /** 响应数据的缓存时间, 单位毫秒。仅在成功时缓存；仅缓存在内存，应用退出,缓存消失。(默认0,不开启缓存) */
+    cacheTime?: number;
+    /** 是否提示接口异常 (默认true) */
+    toastError?: boolean;
+    /** 是否显示进度条: 支持字符串,自定义文本 (默认true) */
+    showLoading?: boolean | string;
+    /** 是否输出日志 (默认true) */
+    showLog?: boolean;
+    /** 成功和失败时,额外输出的日志数据 (可覆盖内部log参数,如'name') */
+    logExtra?: Record<string, unknown>;
+    /** 响应数据的转换 */
+    resMap?: (data: ResponseData) => ResponseData;
+    /** 获取task对象, 用于取消请求或监听流式数据 */
+    onTaskReady?: (task: RequestTask) => void;
+};
+/**
+ * 请求任务对象 (用于取消请求或监听流式数据)
+ */
+interface RequestTask {
+    /** 取消请求 */
+    abort: () => void;
+    /** 监听流式数据块接收事件 */
+    onChunkReceived: (callback: ChunkCallback) => void;
+    /** 取消监听流式数据块接收事件 */
+    offChunkReceived: () => void;
+}
+/**
+ * 流式数据块接收事件回调
+ */
+type ChunkCallback = (response: {
+    data: ArrayBuffer;
+}) => void;
+/**
+ * 基础请求 (返回 Promise 和 Task 对象)
+ * 基于 fetch API 封装，支持流式请求
+ * @param config 请求配置
+ * @example
+ * // 在入口文件完成配置 (确保请求失败有toast提示,登录过期能够触发重新登录,log有日志输出)
+ * setBaseToolsConfig({
+ * toast: ({ msg, status }) => (status === 'fail' ? message.error(msg) : message.success(msg)),
+ * showLoading: ({ title }) => message.loading(title || '加载中...'),
+ * hideLoading: () => message.destroy(),
+ * toLogin: () => reLogin(),
+ * log(level, data) {
+ *   if (data.name === 'request') {
+ *     sendLog('request', data); // 请求日志
+ *   } else if (level === 'error') {
+ *     sendLog('error', data); // 错误日志
+ *   } else {
+ *     sendLog('action', data); // 操作日志
+ *   }
+ * },
+ * });
+ *
+ * // 封装项目的基础请求
+ * export function requestApi<T>(config: RequestConfig) {
+ *    return request<T>({
+ *      header: { token: 'xx', version: 'xx', tid: 'xx' }, // 会自动过滤空值
+ *      // resMap: (res) => res, // 响应数据的转换, 如解密操作 (可选)
+ *      resKey: 'data',
+ *      msgKey: 'message',
+ *      codeKey: 'status',
+ *      successCode: [1],
+ *      reloginCode: [-10],
+ *      ...config,
+ *    });
+ * }
+ *
+ * // 1. 基于上面 requestApi 的普通接口
+ * export function apiGoodList(data: { page: number, size: number }) {
+ *   return requestApi<GoodItem[]>({ url: '/goods/list', data, resKey: 'data.list' });
+ * }
+ *
+ * const goodList = await apiGoodList({ page:1, size:10 });
+ *
+ * // 2. 参数泛型的写法
+ * export function apiGoodList(config: RequestConfig<{ page: number, size: number }>) {
+ *   return requestApi<GoodItem[]>({ url: '/goods/list', resKey: 'data.list', ...config });
+ * }
+ *
+ * const goodList = await apiGoodList({ data: { page:1, size:10 } });
+ *
+ * // 3. 基于上面 requestApi 的流式接口
+ * export function apiChatStream(config: RequestConfig) {
+ *   return requestApi({
+ *     ...config,
+ *     url: '/sse/chatStream',
+ *     resKey: false,
+ *     showLoading: false,
+ *     responseType: 'arraybuffer', // 流式响应类型
+ *     enableChunked: true, // 开启分块传输
+ *   });
+ * }
+ *
+ * // 流式监听
+ * const onTaskReady = (task: RequestTask) => {
+ *    task.onChunkReceived((res) => {
+ *      console.log('ArrayBuffer', res.data);
+ *    });
+ * }
+ *
+ * // 流式发起
+ * const data = { content: '你好', chatId: 123 };
+ * await apiChatStream({ data, onTaskReady });
+ *
+ * // 流式取消 (在组件销毁或页面关闭时调用)
+ * task?.offChunkReceived(); // 取消监听,中断流式接收
+ * task?.abort(); // 取消请求 (若流式已生成,此时abort无效,因为请求已成功)
+ */
+declare function request<T, D extends RequestData = RequestData>(config: RequestConfigBase<D>): Promise<T>;
+/**
+ * 参数过滤undefined, 避免接口处理异常 (不可过滤 null 、 "" 、 false 、 0 这些有效值)
+ */
+declare function filterRequestData(data: Record<string, any>): Record<string, any>;
+/**
+ * 请求头过滤空值 (undefined, null, ""), 不过滤0和false
+ */
+declare function filterRequestHeader(header: RequestConfigBase['header']): Record<string, string>;
+
+/**
+ * web api 的调用配置
+ */
+type WebApiConfig<Res = any, Err = any> = {
+    /** 是否显示加载提示, 默认 false. (支持字符串,自定义文本) */
+    showLoading?: boolean | string;
+    /** 操作成功的toast提示, 默认不显示 */
+    toastSuccess?: ((res: Res) => false | string) | false | string;
+    /** 是否显示操作失败的详细错误信息, 默认 true. (支持字符串,自定义文本; 支持根据errMsg判断是否显示, 例如: (e) => !e.errMsg.includes('cancel') */
+    toastError?: ((e: Err) => boolean | string) | boolean | string;
+    /** 是否显示日志, 默认 true */
+    showLog?: boolean;
+    /** 响应数据的转换, 如解密操作 (返回值在成功日志中输出'resMap'字段) */
+    resMap?: (res: any) => Res;
+    /** 成功和失败时,额外输出的日志数据 (可覆盖内部log参数,如'name') */
+    logExtra?: Record<string, unknown>;
+};
+
+/**
+ * 上传文件的选项
+ */
+type UploadFileOption = {
+    /** 上传接口地址 */
+    url: string;
+    /** 要上传的文件对象 */
+    file: File;
+    /** 文件对应的 key, 默认'file' (服务端通过这个 key 获取文件的二进制内容) */
+    name?: string;
+    /** 请求头 */
+    header?: Record<string, string | number>;
+    /** 额外的formData参数 */
+    formData?: Record<string, string | number>;
+    /** 超时时间，单位 ms，默认 0（不超时） */
+    timeout?: number;
+};
+type OnUploadProgressUpdate = (res: UploadProgressEvent) => void;
+type UploadProgressEvent = {
+    /** 上传进度百分比: 0-100 */
+    progress: number;
+    /** 已上传字节数 */
+    loaded: number;
+    /** 总字节数 */
+    total: number;
+};
+type UploadTask = {
+    /** 上传进度 */
+    onProgressUpdate: (callback: OnUploadProgressUpdate) => void;
+    /** 取消上传 */
+    abort: () => void;
+};
+type UploadConfig = {
+    /** 获取task对象 */
+    onTaskReady?: (task: UploadTask) => void;
+};
+type UploadFail = {
+    message: string;
+    status: number;
+};
+/**
+ * 上传文件
+ * @param option 上传文件的选项
+ * @param config 配置项
+ * @example
+ * // 上传
+ * const res = await uploadFile({ url: 'https://xx', file: file});
+ *
+ * // 监听上传进度
+ * const res = await uploadFile({ url: 'https://xx', file: file}, {
+ *   onTaskReady: (task) =>
+ *     task.onProgressUpdate((res) => console.log('上传进度:', res.progress)),
+ * });
+ *
+ * // 解析上传结果
+ * console.log('uploadFile ok', JSON.parse(res));
+ */
+declare function uploadFile(option: UploadFileOption, config?: UploadConfig & WebApiConfig): Promise<string>;
+
+/**
+ * 写入 localStorage（自动 JSON 序列化）
+ * @param key 键名
+ * @param value 任意可序列化的值：对象、数组、字符串、数字、布尔值。(`null` 或 `undefined` 会自动移除该键)
+ * @param days 过期天数（从当前时间起算）
+ * @example
+ * setLocalStorage('user', { id: 1, name: 'Alice' }); // 对象
+ * setLocalStorage('age', 18); // 数字
+ * setLocalStorage('vip', true); // 布尔值
+ * setLocalStorage('token', 'abc123', 7); // 7 天后过期
+ */
+declare function setLocalStorage(key: string, value: unknown, days?: number): void;
+/**
+ * 读取 localStorage（自动 JSON 反序列化）
+ * 若值为合法 JSON，则返回反序列化后的数据；
+ * 若值非 JSON（如外部写入的纯字符串），则原样返回字符串。
+ * 不存在时返回 `null`。
+ * @param key 键名
+ * @returns 解析后的值或 `null`
+ * @example
+ * const user = getLocalStorage<{ id: number; name: string }>('user');
+ * const age = getLocalStorage<number>('age');
+ * const vip = getLocalStorage<boolean>('vip');
+ */
+declare function getLocalStorage<T = unknown>(key: string): T | null;
+/**
+ * 移除 localStorage 指定键
+ * @param key 键名
+ * @example
+ * removeLocalStorage('token');
+ */
+declare function removeLocalStorage(key: string): void;
+
+/**
+ * 获取url的查询参数值
+ * @param key 参数名
+ * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
+ * @returns 解码后的参数值 (若不存在|"null"|"undefined"，则返回 null)
+ * @example
+ * const q = getUrlParam('q'); // 默认当前地址
+ * const q = getUrlParam('q', 'https://a.com/?q=%E6%B5%8B%E8%AF%95'); // "测试"
+ * const a = getUrlParam('a', 'a=1'); // "1"
+ * const list = getUrlParam('list', 'list=[1,2]'); // "[1,2]"
+ * const list = getUrlParam('list', 'list=null'); // null
+ * const list = getUrlParam('list', 'list=undefined'); // null
+ */
+declare function getUrlParam(key: string, url?: string): string | null;
+/**
+ * 获取url的查询参数值,并转为number类型
+ * @param key 参数名
+ * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
+ * @returns 解码后的参数值 (若不存在|"非数字字符串"，则返回 null)
+ * @example
+ * const a = getUrlNumber('a'); // 默认当前地址
+ * const a = getUrlNumber('a', 'https://a.com/?a=1'); // 1
+ * const a = getUrlNumber('a', 'a=1'); // 1
+ * const a = getUrlNumber('a', 'a=1.2'); // 1.2
+ * const a = getUrlNumber('a', 'a=abc'); // null
+ */
+declare function getUrlNumber(key: string, url?: string): number | null;
+/**
+ * 获取url的所有查询参数值
+ * @param url 完整 URL 或仅查询串（如 "a=1&b=2"）
+ * @returns 解码后的键值对象（无参数返回空对象; "null"|"undefined"的参数会被忽略）
+ * @example
+ * const params = getUrlParams(); // 默认当前地址
+ * const params = getUrlParams('a=1&b=2'); // { a: "1", b: "2" }
+ * const params = getUrlParams('https://a.com/?a=1&b=2'); // { a: "1", b: "2" }
+ * const params = getUrlParams('a=1&b=null'); // { a: "1" }
+ * const params = getUrlParams('a=1&b=undefined'); // { a: "1" }
+ */
+declare function getUrlParams(url?: string): Record<string, string>;
+
+export { type AppConfig, type AppLogInfo, type ChunkCallback, type OnUploadProgressUpdate, type RequestConfig, type RequestConfigBase, type RequestData, type RequestMethod, type RequestTask, type ResponseData, type UploadConfig, type UploadFail, type UploadFileOption, type UploadProgressEvent, type UploadTask, copyBlob, copyHtml, copyImage, copyNode, copyRtf, copyTable, copyText, copyUrl, download, filterRequestData, filterRequestHeader, getBaseToolsConfig, getBrowserName, getBrowserVersion, getCookie, getDevicePixelRatio, getDispositionFileName, getLocalStorage, getOS, getUA, getUrlNumber, getUrlParam, getUrlParams, getWindowHeight, getWindowScrollLeft, getWindowScrollTop, getWindowWidth, hasCss, hasJs, isAndroid, isChrome, isIOS, isInViewport, isMobile, isPC, isTablet, isTouchSupported, isWeChat, loadCss, loadJs, lockBodyScroll, preloadImage, removeCookie, removeLocalStorage, request, setBaseToolsConfig, setCookie, setLocalStorage, unlockBodyScroll, uploadFile, windowScrollTo };