@mingto/tools 1.0.686 → 1.0.687

package/README.md

@@ -75,7 +75,7 @@ tools.getLocale()
 | `getFileIcon` | 获取文件图标 |
 | `getFileName` | 获取文件名 |
 | `getFilePathNotQuery` | 获取去除 query 的文件路径 |
-| `getFileQuery` | 获取文件路径 query |
+| `getFilePathQuery` | 获取文件路径 query |
 | `getFileSuffix` | 获取文件后缀 |
 | `getFileSuffixIcon` | 获取文件后缀图标 |
 | `getFileTitle` | 获取文件标题 |

package/dist/file/{get-file-query.d.ts → get-file-path-query.d.ts}

@@ -4,5 +4,5 @@
  * @param  filePath 文件路径。
  * @returns 查询参数对象。
  */
-declare function getFileQuery(filePath: string): Record<string, any>;
-export default getFileQuery;
+declare function getFilePathQuery(filePath: string): Record<string, any>;
+export default getFilePathQuery;

package/dist/file/index.d.ts

@@ -4,7 +4,7 @@ import { CompressFileSuffixEnum, DocumentFileSuffixEnum, FileSuffixEnum, ImageFi
 import { default as getFileIcon } from './get-file-icon';
 import { default as getFileName } from './get-file-name';
 import { default as getFilePathNotQuery } from './get-file-path-not-query';
-import { default as getFileQuery } from './get-file-query';
+import { default as getFilePathQuery } from './get-file-path-query';
 import { default as getFileSuffix } from './get-file-suffix';
 import { default as getFileSuffixIcon } from './get-file-suffix-icon';
 import { default as getFileTitle } from './get-file-title';
@@ -20,4 +20,4 @@ import { default as singleDownloadFile } from './single-download-file';
 import { default as singleDownloadFileBase64 } from './single-download-file-base64';
 import { default as updateFilePathQuery } from './update-file-path-query';
 export type { CompressFileSuffix, DocumentFileSuffix, FileSuffix, ImageFileSuffix, MarkdownFileSuffix, MusicFileSuffix, PptFileSuffix, VideoFileSuffix, };
-export { batchDownloadFile, CompressFileSuffixEnum, DocumentFileSuffixEnum, FileSuffixEnum, getFileIcon, getFileName, getFilePathNotQuery, getFileQuery, getFileSuffix, getFileSuffixIcon, getFileTitle, ImageFileSuffixEnum, isCompressFilePath, isDocumentFilePath, isFilePath, isImageFilePath, isMarkdownFilePath, isMusicFilePath, isPptFilePath, isVideoFilePath, MarkdownFileSuffixEnum, MusicFileSuffixEnum, PptFileSuffixEnum, singleDownloadFile, singleDownloadFileBase64, updateFilePathQuery, VideoFileSuffixEnum, };
+export { batchDownloadFile, CompressFileSuffixEnum, DocumentFileSuffixEnum, FileSuffixEnum, getFileIcon, getFileName, getFilePathNotQuery, getFilePathQuery, getFileSuffix, getFileSuffixIcon, getFileTitle, ImageFileSuffixEnum, isCompressFilePath, isDocumentFilePath, isFilePath, isImageFilePath, isMarkdownFilePath, isMusicFilePath, isPptFilePath, isVideoFilePath, MarkdownFileSuffixEnum, MusicFileSuffixEnum, PptFileSuffixEnum, singleDownloadFile, singleDownloadFileBase64, updateFilePathQuery, VideoFileSuffixEnum, };

package/dist/index.js

@@ -15979,21 +15979,17 @@ function chunkString(str) {
 	return chunks;
 }
 //#endregion
-//#region src/string/object-to-query-string.ts
-init__rollupPluginBabelHelpers();
+//#region src/string/get-url-not-query.ts
 /**
-* 将对象转换为 URL 查询字符串。
-* 该函数会遍历对象的键值对，将每个键和值进行 URL 编码，然后以 "key=value" 的形式拼接成字符串，并用 "&" 符号连接。
-*
-* @param obj - 需要转换的对象，对象的键为字符串，值为任意类型。
-* @returns 转换后的 URL 查询字符串。
+* 获取 URL 中不包含查询参数的主体部分。
 *
+* @param url URL。
+* @returns 不包含查询参数的 URL 主体。
 */
-function objectToQueryString(obj) {
-	return Object.entries(obj).map(function(_ref) {
-		var _ref2 = _slicedToArray(_ref, 2), key = _ref2[0], value = _ref2[1];
-		return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
-	}).join("&");
+function getUrlNotQuery(url) {
+	var _matchResult$;
+	var matchResult = url.match(/^([^?]*)/);
+	return (_matchResult$ = matchResult === null || matchResult === void 0 ? void 0 : matchResult[1]) !== null && _matchResult$ !== void 0 ? _matchResult$ : url;
 }
 //#endregion
 //#region src/string/query-string-to-object.ts
@@ -16014,6 +16010,54 @@ function queryStringToObject(queryString) {
 	}, {});
 }
 //#endregion
+//#region src/string/get-url-query.ts
+/**
+* 获取 URL 中的查询参数。
+*
+* @param url URL。
+* @returns 查询参数对象。
+*/
+function getUrlQuery(url) {
+	var _matchResult$;
+	var matchResult = url.match(/\?(.*)/);
+	return queryStringToObject((_matchResult$ = matchResult === null || matchResult === void 0 ? void 0 : matchResult[1]) !== null && _matchResult$ !== void 0 ? _matchResult$ : "");
+}
+//#endregion
+//#region src/string/object-to-query-string.ts
+init__rollupPluginBabelHelpers();
+/**
+* 将对象转换为 URL 查询字符串。
+* 该函数会遍历对象的键值对，将每个键和值进行 URL 编码，然后以 "key=value" 的形式拼接成字符串，并用 "&" 符号连接。
+*
+* @param obj - 需要转换的对象，对象的键为字符串，值为任意类型。
+* @returns 转换后的 URL 查询字符串。
+*
+*/
+function objectToQueryString(obj) {
+	return Object.entries(obj).map(function(_ref) {
+		var _ref2 = _slicedToArray(_ref, 2), key = _ref2[0], value = _ref2[1];
+		return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+	}).join("&");
+}
+//#endregion
+//#region src/string/update-url-query.ts
+init__rollupPluginBabelHelpers();
+/**
+* 更新 URL 的查询参数。
+*
+* @param url 完整 URL。
+* @param objectQuery 查询参数对象。
+* @param isAppend 是否合并原有查询参数，默认 `true` 表示合并；`false` 则仅使用新传入的参数。
+* @returns 更新后的 URL。
+*/
+function updateUrlQuery(url, objectQuery) {
+	var isAppend = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : true;
+	var urlPath = getUrlNotQuery(url);
+	var urlQuery = getUrlQuery(url);
+	var queryString = objectToQueryString(isAppend ? _objectSpread2(_objectSpread2({}, urlQuery), objectQuery) : objectQuery);
+	return checkEmpty(queryString) ? urlPath : "".concat(urlPath, "?").concat(queryString);
+}
+//#endregion
 //#region src/file/get-file-path-not-query.ts
 /**
 * 获取文件路径（不包含查询参数）。
@@ -16027,14 +16071,14 @@ function getFilePathNotQuery(filePath) {
 	return (_matchResult$ = matchResult === null || matchResult === void 0 ? void 0 : matchResult[1]) !== null && _matchResult$ !== void 0 ? _matchResult$ : "";
 }
 //#endregion
-//#region src/file/get-file-query.ts
+//#region src/file/get-file-path-query.ts
 /**
 * 获取 URL 中的查询参数。
 *
 * @param  filePath 文件路径。
 * @returns 查询参数对象。
 */
-function getFileQuery(filePath) {
+function getFilePathQuery(filePath) {
 	var _matchResult$;
 	var matchResult = filePath.match(filePathRegex);
 	return queryStringToObject((_matchResult$ = matchResult === null || matchResult === void 0 ? void 0 : matchResult[6]) !== null && _matchResult$ !== void 0 ? _matchResult$ : "");
@@ -16052,7 +16096,7 @@ function updateFilePathQuery(filePath, objectQuery) {
 	var isAppend = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : true;
 	var filePathNotQuery = getFilePathNotQuery(filePath);
 	var queryString = "";
-	if (isAppend) queryString = objectToQueryString(_objectSpread2(_objectSpread2({}, getFileQuery(filePath)), objectQuery));
+	if (isAppend) queryString = objectToQueryString(_objectSpread2(_objectSpread2({}, getFilePathQuery(filePath)), objectQuery));
 	else queryString = objectToQueryString(objectQuery);
 	return checkEmpty(queryString) ? filePathNotQuery : "".concat(filePathNotQuery, "?").concat(queryString);
 }
@@ -19793,4 +19837,4 @@ var src_default = {
 	}
 };
 //#endregion
-export { CompressFileSuffixEnum, DEFAULT_USER_AVATAR, DocumentFileSuffixEnum, FileSuffixEnum, ImageFileSuffixEnum, MarkdownFileSuffixEnum, MusicFileSuffixEnum, PptFileSuffixEnum, VideoFileSuffixEnum, add, batchDownloadFile, beParsedAsNumber, calcAspectRatio, canBeParsedAsNumber, checkArrayEmpty, checkEmpty, checkEmptyNotZero, checkObjectEmpty, chunkArray, chunkString, closeWorker, copyText, createAudioPermission, createWebSocket, createWorker, debounce, deepFreeze, src_default as default, divide, getAbsoluteUrl, getBrowserFingerprint, getDecimalPlaces, getFileIcon, getFileName, getFilePathNotQuery, getFileQuery, getFileSuffix, getFileSuffixIcon, getFileTitle, getUuid, isAndroid, isArray, isBoolean, isCompressFilePath, isDocumentFilePath, isFilePath, isFunction, isImageFilePath, isIos, isMarkdownFilePath, isMobile, isMusicFilePath, isNullOrUndefined, isNumber, isObject, isPc, isPptFilePath, isString, isUndefined, isValidBase64, isValidUrl, isVideoFilePath, isWebSocketSupported, multiply, objectToQueryString, pickObject, queryStringToObject, singleDownloadFile, downloadBase64File as singleDownloadFileBase64, subtract, throttle, timeDelay, updateFilePathQuery, useTheme };
+export { CompressFileSuffixEnum, DEFAULT_USER_AVATAR, DocumentFileSuffixEnum, FileSuffixEnum, ImageFileSuffixEnum, MarkdownFileSuffixEnum, MusicFileSuffixEnum, PptFileSuffixEnum, VideoFileSuffixEnum, add, batchDownloadFile, beParsedAsNumber, calcAspectRatio, canBeParsedAsNumber, checkArrayEmpty, checkEmpty, checkEmptyNotZero, checkObjectEmpty, chunkArray, chunkString, closeWorker, copyText, createAudioPermission, createWebSocket, createWorker, debounce, deepFreeze, src_default as default, divide, getAbsoluteUrl, getBrowserFingerprint, getDecimalPlaces, getFileIcon, getFileName, getFilePathNotQuery, getFilePathQuery, getFileSuffix, getFileSuffixIcon, getFileTitle, getUrlNotQuery, getUrlQuery, getUuid, isAndroid, isArray, isBoolean, isCompressFilePath, isDocumentFilePath, isFilePath, isFunction, isImageFilePath, isIos, isMarkdownFilePath, isMobile, isMusicFilePath, isNullOrUndefined, isNumber, isObject, isPc, isPptFilePath, isString, isUndefined, isValidBase64, isValidUrl, isVideoFilePath, isWebSocketSupported, multiply, objectToQueryString, pickObject, queryStringToObject, singleDownloadFile, downloadBase64File as singleDownloadFileBase64, subtract, throttle, timeDelay, updateFilePathQuery, updateUrlQuery, useTheme };

package/dist/string/get-url-not-query.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 获取 URL 中不包含查询参数的主体部分。
+ *
+ * @param url URL。
+ * @returns 不包含查询参数的 URL 主体。
+ */
+declare function getUrlNotQuery(url: string): string;
+export default getUrlNotQuery;

package/dist/string/get-url-query.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 获取 URL 中的查询参数。
+ *
+ * @param url URL。
+ * @returns 查询参数对象。
+ */
+declare function getUrlQuery(url: string): Record<string, any>;
+export default getUrlQuery;

package/dist/string/index.d.ts

@@ -1,4 +1,7 @@
 import { default as chunkString } from './chunk-string';
+import { default as getUrlNotQuery } from './get-url-not-query';
+import { default as getUrlQuery } from './get-url-query';
 import { default as objectToQueryString } from './object-to-query-string';
 import { default as queryStringToObject } from './query-string-to-object';
-export { chunkString, objectToQueryString, queryStringToObject };
+import { default as updateUrlQuery } from './update-url-query';
+export { chunkString, getUrlNotQuery, getUrlQuery, objectToQueryString, queryStringToObject, updateUrlQuery };

package/dist/string/update-url-query.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 更新 URL 的查询参数。
+ *
+ * @param url 完整 URL。
+ * @param objectQuery 查询参数对象。
+ * @param isAppend 是否合并原有查询参数，默认 `true` 表示合并；`false` 则仅使用新传入的参数。
+ * @returns 更新后的 URL。
+ */
+declare function updateUrlQuery(url: string, objectQuery: Record<string, string>, isAppend?: boolean): string;
+export default updateUrlQuery;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mingto/tools",
   "type": "module",
-  "version": "1.0.686",
+  "version": "1.0.687",
   "description": "明途公共工具库",
   "author": "hcc",
   "license": "ISC",