@fangzhongya/utils 0.0.79 → 0.0.82

package/dist/window/download.d.ts

@@ -1,72 +1,2 @@
-/**
- * 通用文件下载方法
- */
-/**
- * 专门用于文本下载的方法
- * @param text 文本内容
- * @param filename 文件名
- * @param mimeType MIME 类型
- */
-declare function downloadText(text: string, filename?: string, mimeType?: string): void;
-/**
- * 专门用于 JSON 数据下载的方法
- * @param jsonData JSON 数据
- * @param filename 文件名
- */
-declare function downloadJSON(jsonData: object, filename?: string): void;
-/**
- * 专门用于 CSV 数据下载的方法
- * @param data 二维数组或对象数组
- * @param filename 文件名
- * @param headers CSV 表头
- */
-declare function downloadCSV(data: string[][] | object[], filename?: string, headers?: string[]): void;
-/**
- * 通过 AJAX 下载文件
- * @param url 文件 URL
- * @param filename 文件名
- * @param options 请求选项
- */
-declare function downloadViaAJAX(url: string, filename: string, options?: RequestInit): Promise<void>;
-/**
- * 通用文件下载方法 - 优化版
- */
-interface DownloadOptions {
-    filename?: string;
-    mimeType?: string;
-    charset?: string;
-    bom?: string;
-}
-/**
- * 通用文件下载方法
- * @param data 要下载的数据
- * @param options 下载选项
- */
-declare function downloadFile(data: BlobPart | object, options?: DownloadOptions): void;
-/**
- * 优化版 URL 下载方法 - 专门处理图片等直接下载问题
- * @param url 文件 URL
- * @param filename 文件名（可选）
- * @param options 额外选项
- */
-declare function downloadFromURL(url: string, filename?: string, options?: {
-    useBlob?: boolean;
-    headers?: Record<string, string>;
-    timeout?: number;
-}): Promise<void>;
-/**
- * 专门用于图片下载的方法
- * @param imageUrl 图片 URL
- * @param filename 文件名（可选）
- */
-declare function downloadImage(imageUrl: string, filename?: string): Promise<void>;
-/**
- * 批量下载多个文件
- * @param downloads 下载任务数组
- */
-declare function downloadMultipleFiles(downloads: Array<{
-    url: string;
-    filename?: string;
-}>): Promise<void[]>;
-
-export { downloadCSV, downloadFile, downloadFromURL, downloadImage, downloadJSON, downloadMultipleFiles, downloadText, downloadViaAJAX };
+import { a as downloadJSON, c as downloadViaAJAX, i as downloadImage, n as downloadFile, o as downloadMultipleFiles, r as downloadFromURL, s as downloadText, t as downloadCSV } from "../download-D0XMqoD0.js";
+export { downloadCSV, downloadFile, downloadFromURL, downloadImage, downloadJSON, downloadMultipleFiles, downloadText, downloadViaAJAX };

package/dist/window/download.js

@@ -1,21 +1,234 @@
-import {
-  downloadCSV,
-  downloadFile,
-  downloadFromURL,
-  downloadImage,
-  downloadJSON,
-  downloadMultipleFiles,
-  downloadText,
-  downloadViaAJAX
-} from "../chunk-ZLEU2YQ2.js";
-import "../chunk-MLKGABMK.js";
-export {
-  downloadCSV,
-  downloadFile,
-  downloadFromURL,
-  downloadImage,
-  downloadJSON,
-  downloadMultipleFiles,
-  downloadText,
-  downloadViaAJAX
-};
+//#region packages/window/download.ts
+/**
+* 通用文件下载方法
+*/
+/**
+* 专门用于文本下载的方法
+* @param text 文本内容
+* @param filename 文件名
+* @param mimeType MIME 类型
+*/
+function downloadText(text, filename = "text.txt", mimeType = "text/plain") {
+	downloadFile(text, {
+		filename,
+		mimeType
+	});
+}
+/**
+* 专门用于 JSON 数据下载的方法
+* @param jsonData JSON 数据
+* @param filename 文件名
+*/
+function downloadJSON(jsonData, filename = "data.json") {
+	downloadFile(jsonData, {
+		filename,
+		mimeType: "application/json"
+	});
+}
+/**
+* 专门用于 CSV 数据下载的方法
+* @param data 二维数组或对象数组
+* @param filename 文件名
+* @param headers CSV 表头
+*/
+function downloadCSV(data, filename = "data.csv", headers) {
+	let csvContent = "";
+	if (Array.isArray(data) && data.length > 0) {
+		if (Array.isArray(data[0])) csvContent = data.map((row) => row.map((cell) => `"${String(cell).replace(/"/g, "\"\"")}"`).join(",")).join("\n");
+		else if (typeof data[0] === "object") {
+			const objects = data;
+			const objectHeaders = headers || Object.keys(objects[0]);
+			csvContent = objectHeaders.map((header) => `"${String(header).replace(/"/g, "\"\"")}"`).join(",") + "\n";
+			csvContent += objects.map((obj) => objectHeaders.map((header) => `"${String(obj[header] || "").replace(/"/g, "\"\"")}"`).join(",")).join("\n");
+		}
+	}
+	downloadFile(csvContent, {
+		filename,
+		mimeType: "text/csv"
+	});
+}
+/**
+* 通过 AJAX 下载文件
+* @param url 文件 URL
+* @param filename 文件名
+* @param options 请求选项
+*/
+async function downloadViaAJAX(url, filename, options = {}) {
+	try {
+		const response = await fetch(url, {
+			method: "GET",
+			...options
+		});
+		if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+		const blob = await response.blob();
+		let finalFilename = filename;
+		if (!finalFilename) {
+			const contentDisposition = response.headers.get("content-disposition");
+			if (contentDisposition) {
+				const filenameMatch = contentDisposition.match(/filename="?(.+?)"?$/);
+				if (filenameMatch) finalFilename = filenameMatch[1];
+			}
+		}
+		downloadFile(blob, { filename: finalFilename });
+	} catch (error) {
+		console.error("AJAX 下载失败:", error);
+		throw new Error(`下载失败: ${error instanceof Error ? error.message : "未知错误"}`);
+	}
+}
+/**
+* 通用文件下载方法
+* @param data 要下载的数据
+* @param options 下载选项
+*/
+function downloadFile(data, options = {}) {
+	const { filename = "download", mimeType = "application/octet-stream", charset = "utf-8", bom = "" } = options;
+	try {
+		let blobData;
+		if (data instanceof Blob) blobData = data;
+		else if (typeof data === "object") blobData = bom + JSON.stringify(data, null, 2);
+		else if (typeof data === "string") blobData = bom + data;
+		else blobData = data;
+		const blob = new Blob([blobData], { type: `${mimeType};charset=${charset}` });
+		const blobUrl = URL.createObjectURL(blob);
+		const link = document.createElement("a");
+		link.href = blobUrl;
+		link.download = filename;
+		link.style.display = "none";
+		document.body.appendChild(link);
+		link.click();
+		setTimeout(() => {
+			document.body.removeChild(link);
+			URL.revokeObjectURL(blobUrl);
+		}, 100);
+	} catch (error) {
+		console.error("文件下载失败:", error);
+		throw new Error(`下载失败: ${error instanceof Error ? error.message : "未知错误"}`);
+	}
+}
+/**
+* 优化版 URL 下载方法 - 专门处理图片等直接下载问题
+* @param url 文件 URL
+* @param filename 文件名（可选）
+* @param options 额外选项
+*/
+async function downloadFromURL(url, filename, options = {}) {
+	const { useBlob = true, headers = {}, timeout = 3e4 } = options;
+	try {
+		if (!useBlob) {
+			const link = document.createElement("a");
+			link.href = url;
+			link.download = filename || getFilenameFromURL(url);
+			link.style.display = "none";
+			link.target = "_blank";
+			document.body.appendChild(link);
+			link.click();
+			setTimeout(() => {
+				document.body.removeChild(link);
+			}, 100);
+			return;
+		}
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), timeout);
+		const response = await fetch(url, {
+			method: "GET",
+			headers,
+			signal: controller.signal
+		});
+		clearTimeout(timeoutId);
+		if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
+		const blob = await response.blob();
+		let finalFilename = filename;
+		if (!finalFilename) {
+			const contentDisposition = response.headers.get("content-disposition");
+			if (contentDisposition) {
+				const filenameMatch = contentDisposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/);
+				if (filenameMatch && filenameMatch[1]) finalFilename = filenameMatch[1].replace(/['"]/g, "");
+			}
+			if (!finalFilename) finalFilename = getFilenameFromURL(url);
+		}
+		const mimeType = getMimeTypeFromBlob(blob, url);
+		downloadFile(blob, {
+			filename: finalFilename,
+			mimeType
+		});
+	} catch (error) {
+		console.error("URL 下载失败:", error);
+		if (error instanceof Error && error.name === "AbortError") throw new Error("下载超时，请检查网络连接或文件大小");
+		if (useBlob) {
+			console.log("Blob 方式失败，尝试直接下载...");
+			await downloadFromURL(url, filename, {
+				...options,
+				useBlob: false
+			});
+		} else throw new Error(`下载失败: ${error instanceof Error ? error.message : "未知错误"}`);
+	}
+}
+/**
+* 专门用于图片下载的方法
+* @param imageUrl 图片 URL
+* @param filename 文件名（可选）
+*/
+async function downloadImage(imageUrl, filename) {
+	await downloadFromURL(imageUrl, filename, {
+		useBlob: true,
+		headers: { Accept: "image/*" }
+	});
+}
+/**
+* 从 URL 中提取文件名
+*/
+function getFilenameFromURL(url) {
+	try {
+		const pathname = new URL(url).pathname;
+		const filename = pathname.substring(pathname.lastIndexOf("/") + 1);
+		if (!filename || filename === "/" || !filename.includes(".")) {
+			const extension = getFileExtensionFromURL(url) || "bin";
+			return `download_${Date.now()}.${extension}`;
+		}
+		return decodeURIComponent(filename);
+	} catch {
+		const extension = getFileExtensionFromURL(url) || "bin";
+		return `download_${Date.now()}.${extension}`;
+	}
+}
+/**
+* 从 URL 或 Blob 获取文件扩展名
+*/
+function getFileExtensionFromURL(url) {
+	const match = url.match(/\.([a-zA-Z0-9]+)(?:[?#]|$)/);
+	return match ? match[1].toLowerCase() : null;
+}
+/**
+* 从 Blob 或 URL 获取 MIME 类型
+*/
+function getMimeTypeFromBlob(blob, url) {
+	if (blob.type && blob.type !== "application/octet-stream") return blob.type;
+	const extension = getFileExtensionFromURL(url);
+	const mimeTypes = {
+		jpg: "image/jpeg",
+		jpeg: "image/jpeg",
+		png: "image/png",
+		gif: "image/gif",
+		webp: "image/webp",
+		svg: "image/svg+xml",
+		pdf: "application/pdf",
+		txt: "text/plain",
+		json: "application/json",
+		csv: "text/csv",
+		xml: "application/xml",
+		zip: "application/zip",
+		mp3: "audio/mpeg",
+		mp4: "video/mp4",
+		avi: "video/x-msvideo"
+	};
+	return extension && mimeTypes[extension] ? mimeTypes[extension] : "application/octet-stream";
+}
+/**
+* 批量下载多个文件
+* @param downloads 下载任务数组
+*/
+async function downloadMultipleFiles(downloads) {
+	return Promise.all(downloads.map((download) => downloadFromURL(download.url, download.filename)));
+}
+//#endregion
+export { downloadCSV, downloadFile, downloadFromURL, downloadImage, downloadJSON, downloadMultipleFiles, downloadText, downloadViaAJAX };

package/dist/window/getParam.cjs

@@ -1,35 +1,209 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-var _chunkEFP5GI25cjs = require('../chunk-EFP5GI25.cjs');
-require('../chunk-75ZPJI57.cjs');
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.buildQueryString = _chunkEFP5GI25cjs.buildQueryString; exports.buildUrl = _chunkEFP5GI25cjs.buildUrl; exports.getAllParams = _chunkEFP5GI25cjs.getAllParams; exports.getCurrentUrlParam = _chunkEFP5GI25cjs.getCurrentUrlParam; exports.getCurrentUrlParams = _chunkEFP5GI25cjs.getCurrentUrlParams; exports.getHashParam = _chunkEFP5GI25cjs.getHashParam; exports.getParam = _chunkEFP5GI25cjs.getParam; exports.getQueryParam = _chunkEFP5GI25cjs.getQueryParam; exports.getUrlParam = _chunkEFP5GI25cjs.getUrlParam; exports.getUrlParams = _chunkEFP5GI25cjs.getUrlParams; exports.isQueryString = _chunkEFP5GI25cjs.isQueryString; exports.isValidUrl = _chunkEFP5GI25cjs.isValidUrl; exports.parseHashParams = _chunkEFP5GI25cjs.parseHashParams; exports.parseQueryString = _chunkEFP5GI25cjs.parseQueryString; exports.parseUrlParams = _chunkEFP5GI25cjs.parseUrlParams;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region packages/window/getParam.ts
+/**
+* 从完整URL中解析查询参数
+* @param url - 完整的URL字符串
+* @returns 解析后的参数对象
+*/
+function parseUrlParams(url) {
+	const result = {};
+	try {
+		new URL(url).searchParams.forEach((value, key) => {
+			result[key] = decodeURIComponent(value);
+		});
+	} catch (error) {
+		console.warn("URL解析失败，尝试备用方案:", error);
+		const queryIndex = url.indexOf("?");
+		if (queryIndex !== -1) return parseQueryString(url.substring(queryIndex + 1));
+	}
+	return result;
+}
+/**
+* 从完整URL中获取指定参数
+* @param url - 完整的URL字符串
+* @param name - 参数名
+* @returns 参数值或null
+*/
+function getUrlParam(url, name) {
+	try {
+		const value = new URL(url).searchParams.get(name);
+		return value ? decodeURIComponent(value) : null;
+	} catch (error) {
+		console.warn("URL解析失败，尝试备用方案:", error);
+		const queryIndex = url.indexOf("?");
+		if (queryIndex === -1) return null;
+		return getQueryParam(url.substring(queryIndex + 1), name);
+	}
+}
+/**
+* 构建带查询参数的URL
+* @param baseUrl - 基础URL
+* @param params - 参数对象
+* @returns 构建后的完整URL
+*/
+function buildUrl(baseUrl, params) {
+	const url = new URL(baseUrl);
+	Object.entries(params).forEach(([key, value]) => {
+		url.searchParams.set(key, String(value));
+	});
+	return url.toString();
+}
+/**
+* 解析查询字符串（可以是 ?id=1&name=test 或 id=1&name=test 格式）
+* @param queryString - 查询字符串
+* @returns 解析后的参数对象
+*/
+function parseQueryString(queryString) {
+	const cleanString = queryString.replace(/^[?&]/, "");
+	if (!cleanString.trim()) return {};
+	const result = {};
+	try {
+		new URLSearchParams(cleanString).forEach((value, key) => {
+			result[key] = decodeURIComponent(value);
+		});
+	} catch (error) {
+		console.warn("查询字符串解析失败:", error);
+		cleanString.split("&").forEach((pair) => {
+			const [key, value = ""] = pair.split("=");
+			if (key) result[decodeURIComponent(key)] = decodeURIComponent(value);
+		});
+	}
+	return result;
+}
+/**
+* 从查询字符串中获取指定参数
+* @param queryString - 查询字符串
+* @param name - 参数名
+* @returns 参数值或null
+*/
+function getQueryParam(queryString, name) {
+	const cleanString = queryString.replace(/^[?&]/, "");
+	if (!cleanString.trim()) return null;
+	try {
+		const value = new URLSearchParams(cleanString).get(name);
+		return value ? decodeURIComponent(value) : null;
+	} catch (error) {
+		console.warn("查询字符串解析失败，尝试备用方案:", error);
+		const pairs = cleanString.split("&");
+		for (const pair of pairs) {
+			const [key, value = ""] = pair.split("=");
+			if (key === name) return decodeURIComponent(value);
+		}
+		return null;
+	}
+}
+/**
+* 将参数对象转换为查询字符串
+* @param params - 参数对象
+* @param includeQuestionMark - 是否包含开头的 ? 符号
+* @returns 查询字符串
+*/
+function buildQueryString(params, includeQuestionMark = true) {
+	const searchParams = new URLSearchParams();
+	Object.entries(params).forEach(([key, value]) => {
+		if (value !== void 0 && value !== null) searchParams.set(key, String(value));
+	});
+	const queryString = searchParams.toString();
+	return includeQuestionMark && queryString ? `?${queryString}` : queryString;
+}
+/**
+* 解析hash字符串中的参数
+* @param hash - hash字符串
+* @returns 解析后的参数对象
+*/
+function parseHashParams(hash) {
+	const cleanHash = hash.replace(/^#/, "");
+	const questionMarkIndex = cleanHash.indexOf("?");
+	if (questionMarkIndex === -1) return {};
+	return parseQueryString(cleanHash.substring(questionMarkIndex + 1));
+}
+/**
+* 从hash字符串中获取指定参数
+* @param hash - hash字符串
+* @param name - 参数名
+* @returns 参数值或null
+*/
+function getHashParam(hash, name) {
+	const cleanHash = hash.replace(/^#/, "");
+	const questionMarkIndex = cleanHash.indexOf("?");
+	if (questionMarkIndex === -1) return null;
+	return getQueryParam(cleanHash.substring(questionMarkIndex + 1), name);
+}
+/**
+* 获取当前页面的所有参数（包括查询参数和hash参数）
+* @returns 合并后的参数对象（hash参数优先）
+*/
+function getCurrentUrlParams() {
+	const result = {};
+	const queryParams = parseUrlParams(window.location.href);
+	Object.assign(result, queryParams);
+	const hashParams = parseHashParams(window.location.hash);
+	Object.assign(result, hashParams);
+	return result;
+}
+/**
+* 获取当前页面的指定参数（优先从hash中获取）
+* @param name - 参数名
+* @returns 参数值或null
+*/
+function getCurrentUrlParam(name) {
+	const hashValue = getHashParam(window.location.hash, name);
+	if (hashValue !== null) return hashValue;
+	return getUrlParam(window.location.href, name);
+}
+/**
+* 检查字符串是否为有效的URL
+*/
+function isValidUrl(url) {
+	try {
+		new URL(url);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* 检查字符串是否为查询字符串格式
+*/
+function isQueryString(str) {
+	if (/^[a-zA-Z]+:\/\//.test(str)) return false;
+	if (str.includes("/") && !str.includes("?")) return false;
+	return str.includes("=") || str.includes("?") || str.includes("&");
+}
+/**
+* 获取url中参数
+*/
+function getParam(URL) {
+	if (URL.includes("?")) URL = URL.split("?")[1];
+	URL = JSON.parse("{\"" + decodeURI(URL).replace(/"/g, "\"").replace(/&/g, "\",\"").replace(/=/g, "\":\"") + "\"}");
+	return JSON.stringify(URL);
+}
+function getUrlParams() {
+	const hash = window.location.href;
+	const questionMarkIndex = hash.indexOf("?");
+	if (questionMarkIndex === -1) return new URLSearchParams();
+	const queryString = hash.substring(questionMarkIndex + 1);
+	return new URLSearchParams(queryString);
+}
+function getAllParams() {
+	const params = getUrlParams();
+	const result = {};
+	for (const [key, value] of params.entries()) result[key] = value;
+	return result;
+}
+//#endregion
+exports.buildQueryString = buildQueryString;
+exports.buildUrl = buildUrl;
+exports.getAllParams = getAllParams;
+exports.getCurrentUrlParam = getCurrentUrlParam;
+exports.getCurrentUrlParams = getCurrentUrlParams;
+exports.getHashParam = getHashParam;
+exports.getParam = getParam;
+exports.getQueryParam = getQueryParam;
+exports.getUrlParam = getUrlParam;
+exports.getUrlParams = getUrlParams;
+exports.isQueryString = isQueryString;
+exports.isValidUrl = isValidUrl;
+exports.parseHashParams = parseHashParams;
+exports.parseQueryString = parseQueryString;
+exports.parseUrlParams = parseUrlParams;

package/dist/window/getParam.d.cts

@@ -1,80 +1,2 @@
-/**
- * 从完整URL中解析查询参数
- * @param url - 完整的URL字符串
- * @returns 解析后的参数对象
- */
-declare function parseUrlParams(url: string): Record<string, string>;
-/**
- * 从完整URL中获取指定参数
- * @param url - 完整的URL字符串
- * @param name - 参数名
- * @returns 参数值或null
- */
-declare function getUrlParam(url: string, name: string): string | null;
-/**
- * 构建带查询参数的URL
- * @param baseUrl - 基础URL
- * @param params - 参数对象
- * @returns 构建后的完整URL
- */
-declare function buildUrl(baseUrl: string, params: Record<string, string | number>): string;
-/**
- * 解析查询字符串（可以是 ?id=1&name=test 或 id=1&name=test 格式）
- * @param queryString - 查询字符串
- * @returns 解析后的参数对象
- */
-declare function parseQueryString(queryString: string): Record<string, string>;
-/**
- * 从查询字符串中获取指定参数
- * @param queryString - 查询字符串
- * @param name - 参数名
- * @returns 参数值或null
- */
-declare function getQueryParam(queryString: string, name: string): string | null;
-/**
- * 将参数对象转换为查询字符串
- * @param params - 参数对象
- * @param includeQuestionMark - 是否包含开头的 ? 符号
- * @returns 查询字符串
- */
-declare function buildQueryString(params: Record<string, string | number | boolean>, includeQuestionMark?: boolean): string;
-/**
- * 解析hash字符串中的参数
- * @param hash - hash字符串
- * @returns 解析后的参数对象
- */
-declare function parseHashParams(hash: string): Record<string, string>;
-/**
- * 从hash字符串中获取指定参数
- * @param hash - hash字符串
- * @param name - 参数名
- * @returns 参数值或null
- */
-declare function getHashParam(hash: string, name: string): string | null;
-/**
- * 获取当前页面的所有参数（包括查询参数和hash参数）
- * @returns 合并后的参数对象（hash参数优先）
- */
-declare function getCurrentUrlParams(): Record<string, string>;
-/**
- * 获取当前页面的指定参数（优先从hash中获取）
- * @param name - 参数名
- * @returns 参数值或null
- */
-declare function getCurrentUrlParam(name: string): string | null;
-/**
- * 检查字符串是否为有效的URL
- */
-declare function isValidUrl(url: string): boolean;
-/**
- * 检查字符串是否为查询字符串格式
- */
-declare function isQueryString(str: string): boolean;
-/**
- * 获取url中参数
- */
-declare function getParam(URL: string): string;
-declare function getUrlParams(): URLSearchParams;
-declare function getAllParams(): Record<string, string>;
-
-export { buildQueryString, buildUrl, getAllParams, getCurrentUrlParam, getCurrentUrlParams, getHashParam, getParam, getQueryParam, getUrlParam, getUrlParams, isQueryString, isValidUrl, parseHashParams, parseQueryString, parseUrlParams };
+import { a as getCurrentUrlParams, c as getQueryParam, d as isQueryString, f as isValidUrl, h as parseUrlParams, i as getCurrentUrlParam, l as getUrlParam, m as parseQueryString, n as buildUrl, o as getHashParam, p as parseHashParams, r as getAllParams, s as getParam, t as buildQueryString, u as getUrlParams } from "../getParam-15uTkanW.cjs";
+export { buildQueryString, buildUrl, getAllParams, getCurrentUrlParam, getCurrentUrlParams, getHashParam, getParam, getQueryParam, getUrlParam, getUrlParams, isQueryString, isValidUrl, parseHashParams, parseQueryString, parseUrlParams };