@hzab/utils 1.1.6 → 1.1.7

package/src/url.ts

@@ -1,155 +1,181 @@
-/**
- * 替换 search 字符串
- * @param url
- * @param search
- * @returns
- */
-export function replaceSearch(url: string, search: string) {
-  if (!url || typeof url !== "string") {
-    console.warn("Warn replaceSearch: 请传入正确的 url 字符串");
-    return url;
-  }
-  const _url = fixUrlQuery(url);
-
-  const hashIdx = _url.indexOf("#");
-  const queryIdx = _url.indexOf("?");
-  let hash = "";
-  let resUrl = _url;
-  // 无 query 时也要截掉 hash，否则后面再拼 hash 会重复
-  if (queryIdx >= 0) {
-    resUrl = _url.slice(0, queryIdx);
-  } else if (hashIdx >= 0) {
-    resUrl = _url.slice(0, hashIdx);
-  }
-  if (hashIdx >= 0) {
-    hash = _url.slice(hashIdx);
-  }
-
-  resUrl += search?.indexOf("?") >= 0 ? "" : "?";
-  resUrl += search;
-  resUrl += hash;
-
-  return resUrl;
-}
-
-/**
- * 把对象转为 query 参数
- * @param query
- */
-export function objToSearch(query, opt) {
-  if (!query || typeof query !== "object") {
-    console.warn("Warn objToSearch: 请传入正确的对象");
-    return;
-  }
-  // @deprecated 兼容老的入参写法
-  let hasQuery = opt?.hasQuery;
-  if (typeof opt === "boolean") {
-    hasQuery = opt;
-  }
-  const { isEncode } = opt || {};
-  let search = hasQuery ? "?" : "";
-  Object.keys(query).forEach((key) => {
-    if (search && search != "?") {
-      search += "&";
-    }
-    const _key = isEncode ? encodeURIComponent(key) : key;
-    search += _key;
-    search += "=";
-    const val = isEncode ? encodeURIComponent(query[key]) : query[key];
-    search += val;
-  });
-  return search;
-}
-
-/**
- * 修复 query，解决 query 在 hash 后面的情况
- * @param url
- * @returns
- * 源数据：/#/login?a=1&b=2
- * 结果：/?a=1&b=2#/login
- */
-export function fixUrlQuery(url) {
-  if (!url || typeof url !== "string") {
-    console.warn("Warn handleUrlQuery: 请传入正确的 url 字符串");
-    return url;
-  }
-  const hashIdx = url.indexOf("#");
-  const queryIdx = url.indexOf("?");
-
-  // 双 query 情况
-  if (queryIdx < hashIdx) {
-    let hash = url.slice(hashIdx);
-    const hashQueryIdx = hash.indexOf("?");
-    if (hashQueryIdx >= 0) {
-      const _url = url.slice(0, queryIdx);
-      const urlQuery = url.slice(queryIdx, hashIdx)?.replace(/\/$/, "");
-      const hashQuery = hash.slice(hashQueryIdx)?.replace("?", "")?.replace(/\/$/, "");
-      hash = hash.slice(0, hashQueryIdx);
-      return `${_url}${urlQuery}&${hashQuery}${hash}`;
-    }
-    return url;
-  }
-
-  // query 在 hash # 之后
-  if (queryIdx >= 0 && hashIdx >= 0 && queryIdx > hashIdx) {
-    const hash = url.slice(hashIdx, queryIdx);
-    const search = url.slice(queryIdx);
-    return `${url.slice(0, hashIdx)}${search}${hash}`;
-  }
-  return url;
-}
-
-/**
- * 获取 url 中的 query 值的对象
- * @param query
- */
-export function searchToObj(url) {
-  if (!url || typeof url !== "string") {
-    console.warn("Warn getSearchParams: 请传入正确的 url 字符串.");
-    return;
-  }
-  let _url = fixUrlQuery(url)
-    // 解决 query 在 /# 之前导致 query 参数多了 / 的问题
-    .replace("/#", "#");
-  const queryIdx = _url.indexOf("?");
-  const hashIdx = _url.indexOf("#");
-  if (queryIdx < 0) {
-    return;
-  }
-  // 去除 hash 相关数据及 query 的 "?"
-  if (hashIdx >= 0 && queryIdx >= 0) {
-    _url = _url.slice(queryIdx + 1, hashIdx);
-  } else if (queryIdx >= 0) {
-    _url = _url.slice(queryIdx + 1);
-  }
-  const res = {};
-  _url.split("&")?.forEach((it) => {
-    const arr = it.split("=");
-    const key = decodeURIComponent(arr[0]);
-    const val = decodeURIComponent(arr[1] ?? "");
-    res[key] = val;
-  });
-  return res;
-}
-
-/**
- * 添加 url 中的 query 的参数
- * @param url
- * @param params
- * @returns url string
- */
-export function addQuery(url, params) {
-  const newObj = { ...searchToObj(url), ...params };
-  return replaceSearch(url, objToSearch(newObj, !!params));
-}
-
-/**
- * 添加 url 中的 query 参数，返回 search
- * @param url
- * @param params
- * @returns search string
- */
-export function addSearch(url: string, params: Record<string, unknown>) {
-  const newObj = { ...searchToObj(url), ...params };
-  return objToSearch(newObj, !!params);
-}
+/**
+ * 替换 search 字符串
+ * @param url
+ * @param search
+ * @returns
+ */
+export function replaceSearch(url: string, search: string) {
+  if (!url || typeof url !== "string") {
+    console.warn("Warn replaceSearch: 请传入正确的 url 字符串");
+    return url;
+  }
+  const _url = fixUrlQuery(url);
+
+  const hashIdx = _url.indexOf("#");
+  const queryIdx = _url.indexOf("?");
+  let hash = "";
+  let resUrl = _url;
+  // 无 query 时也要截掉 hash，否则后面再拼 hash 会重复
+  if (queryIdx >= 0) {
+    resUrl = _url.slice(0, queryIdx);
+  } else if (hashIdx >= 0) {
+    resUrl = _url.slice(0, hashIdx);
+  }
+  if (hashIdx >= 0) {
+    hash = _url.slice(hashIdx);
+  }
+
+  resUrl += search?.indexOf("?") >= 0 ? "" : "?";
+  resUrl += search;
+  resUrl += hash;
+
+  return resUrl;
+}
+
+/**
+ * 把对象转为 query 参数
+ * @param query
+ */
+export function objToSearch(query, opt) {
+  if (!query || typeof query !== "object") {
+    console.warn("Warn objToSearch: 请传入正确的对象");
+    return;
+  }
+  // @deprecated 兼容老的入参写法
+  let hasQuery = opt?.hasQuery;
+  if (typeof opt === "boolean") {
+    hasQuery = opt;
+  }
+  const { isEncode } = opt || {};
+  let search = hasQuery ? "?" : "";
+  Object.keys(query).forEach((key) => {
+    if (search && search != "?") {
+      search += "&";
+    }
+    const _key = isEncode ? encodeURIComponent(key) : key;
+    search += _key;
+    search += "=";
+    const val = isEncode ? encodeURIComponent(query[key]) : query[key];
+    search += val;
+  });
+  return search;
+}
+
+/**
+ * 修复 query，解决 query 在 hash 后面的情况
+ * @param url
+ * @returns
+ * 源数据：/#/login?a=1&b=2
+ * 结果：/?a=1&b=2#/login
+ */
+export function fixUrlQuery(url) {
+  if (!url || typeof url !== "string") {
+    console.warn("Warn handleUrlQuery: 请传入正确的 url 字符串");
+    return url;
+  }
+  const hashIdx = url.indexOf("#");
+  const queryIdx = url.indexOf("?");
+
+  // 双 query 情况
+  if (queryIdx < hashIdx) {
+    let hash = url.slice(hashIdx);
+    const hashQueryIdx = hash.indexOf("?");
+    if (hashQueryIdx >= 0) {
+      const _url = url.slice(0, queryIdx);
+      const urlQuery = url.slice(queryIdx, hashIdx)?.replace(/\/$/, "");
+      const hashQuery = hash.slice(hashQueryIdx)?.replace("?", "")?.replace(/\/$/, "");
+      hash = hash.slice(0, hashQueryIdx);
+      return `${_url}${urlQuery}&${hashQuery}${hash}`;
+    }
+    return url;
+  }
+
+  // query 在 hash # 之后
+  if (queryIdx >= 0 && hashIdx >= 0 && queryIdx > hashIdx) {
+    const hash = url.slice(hashIdx, queryIdx);
+    const search = url.slice(queryIdx);
+    return `${url.slice(0, hashIdx)}${search}${hash}`;
+  }
+  return url;
+}
+
+/**
+ * 获取 url 中的 query 值的对象
+ * 支持：完整 URL、`?a=1`、`&a=1`、纯 `a=1&b=2`
+ * @param query
+ */
+export function searchToObj(url) {
+  if (!url || typeof url !== "string") {
+    console.warn("Warn getSearchParams: 请传入正确的 url 字符串.");
+    return;
+  }
+
+  let queryBody;
+  if (url.includes("?")) {
+    const _url = fixUrlQuery(url)
+      // 解决 query 在 /# 之前导致 query 参数多了 / 的问题
+      .replace("/#", "#");
+    const queryIdx = _url.indexOf("?");
+    const hashIdx = _url.indexOf("#");
+    if (queryIdx < 0) {
+      return;
+    }
+    // 去除 hash 相关数据及 query 的 "?"
+    queryBody = hashIdx >= 0 ? _url.slice(queryIdx + 1, hashIdx) : _url.slice(queryIdx + 1);
+  } else {
+    // 纯 query：`a=1&b=2` / `&a=1`（无 ? 且非完整 URL）
+    const bare = url.replace(/^[?&]+/, "").split("#")[0];
+    if (!bare || !bare.includes("=") || url.includes("://")) {
+      return;
+    }
+    queryBody = bare;
+  }
+  if (!queryBody) {
+    return;
+  }
+
+  const res = {};
+  queryBody.split("&")?.forEach((it) => {
+    if (!it) {
+      return;
+    }
+    const eqIdx = it.indexOf("=");
+    const rawKey = eqIdx >= 0 ? it.slice(0, eqIdx) : it;
+    const rawVal = eqIdx >= 0 ? it.slice(eqIdx + 1) : "";
+    try {
+      res[decodeURIComponent(rawKey)] = decodeURIComponent(rawVal);
+    } catch {
+      // 非法转义序列：保留原值，避免整段解析抛错
+      res[rawKey] = rawVal;
+    }
+  });
+  return res;
+}
+
+/**
+ * 添加 url 中的 query 的参数
+ * @param url
+ * @param params
+ * @param opt.isEncode 是否对 key/value 做 encodeURIComponent（默认 false，保持 1.x 既有输出）
+ * @returns url string
+ */
+export function addQuery(url, params, opt: { isEncode?: boolean } = {}) {
+  const newObj = { ...searchToObj(url), ...params };
+  return replaceSearch(url, objToSearch(newObj, { hasQuery: !!params, isEncode: opt?.isEncode }));
+}
+
+/**
+ * 添加 url 中的 query 参数，返回 search
+ * @param url
+ * @param params
+ * @param opt.isEncode 是否对 key/value 做 encodeURIComponent（默认 false，保持 1.x 既有输出）
+ * @returns search string
+ */
+export function addSearch(
+  url: string,
+  params: Record<string, unknown>,
+  opt: { isEncode?: boolean } = {},
+) {
+  const newObj = { ...searchToObj(url), ...params };
+  return objToSearch(newObj, { hasQuery: !!params, isEncode: opt?.isEncode });
+}

package/README.md

@@ -1,137 +0,0 @@
-# @hzab/utils
-
-组件模板
-
-- node@16.16.0
-
-- 注意：首次克隆先执行 npm run prepare 命令
-
-# 组件
-
-## ossUpload 示例
-
-```jsx
-import OssUpload from "@hzab/utils/src/ossUpload";
-
-/**
- * 批量文件上传
- * @param {Array} files
- * @param {Object} opt
- * @returns
- */
-export async function handleOssUpload(files, opt) {
-  const _files = files;
-  const { ossUrl, signatureParams, ossParams, axiosConf, useHashName } = opt || {};
-  const ossUpload = new OssUpload({
-    axios: opt.axios,
-    axiosConf: axiosConf,
-    serverUrl: ossUrl || "/api/v1/common/oss/getWebOssConfig",
-  });
-
-  const promise = [];
-  _files?.forEach((file) => {
-    if (!file) {
-      return;
-    }
-    // 数据已经是 url 的情况
-    if (typeof file === "string" || file.ossUrl || file.url) {
-      promise.push(Promise.resolve(file));
-    } else {
-      promise.push(
-        ossUpload
-          .upload(file, {
-            signatureParams: {
-              isPublic: 1,
-              ...(signatureParams || {}),
-            },
-            ossParams,
-            axiosConf,
-            useHashName,
-          })
-          .then((res) => {
-            return Promise.resolve(res?.data?.data?.fileUrl);
-          }),
-      );
-    }
-  });
-
-  return Promise.all(promise).then((filePromises) => {
-    filePromises?.forEach((fileUrl, idx) => {
-      if (typeof fileUrl === "string") {
-        _files[idx].ossUrl = fileUrl;
-        _files[idx].url = fileUrl;
-      } else if (_files[idx].url) {
-        _files[idx].ossUrl = _files[idx].url;
-      }
-    });
-    return Promise.resolve(_files);
-  });
-}
-```
-
-## API
-
-### InfoPanel Attributes
-
-| 参数   | 类型   | 必填 | 默认值 | 说明              |
-| ------ | ------ | ---- | ------ | ----------------- |
-| schema | Object | 是   | -      | 数据信息的 schema |
-
-# 组件开发流程
-
-- 在 config/webpack.config.js 中按需修改 library 配置的文件名
-- 在 config/webpack.config.js 中按需修改 alias 配置的包名，便于本地调试
-- 在 tsconfig.json 中按需修改 paths 配置的包名，解决 ts 报错问题
-- npm run dev
-
-## 文件目录
-
-- example 本地开发测试代码
-- src 组件源码
-
-## 命令
-
-- Mac 执行该命令，设置 pre-commit 为可执行文件
-
-  - npm run mac-chmod
-  - chmod +x .husky && chmod +x .husky/pre-commit
-
-- 生成文档：npm run docs
-- 本地运行：npm run dev
-
-## 发布
-
-- npm 源和云效源都需要发布
-
-- 命令：npm publish --access public
-- 发布目录：
-  - src
-
-### 迭代发布命令-版本自增
-
-- beta: 需要手动修改 package.json 中的 version，添加 -betaX 版本号。使用 npm publish --beta 发布
-- 0.0.x: npm run publish-patch
-- 0.x.0: npm run publish-minor
-- x.0.0: npm run publish-major
-
-### nrm
-
-- 安装
-  npm install -g nrm
-- 增加源
-  nrm add aliyun https://packages.aliyun.com/62046985b3ead41b374a17f7/npm/npm-registry/
-- 切换源
-  nrm use aliyun
-  nrm use npm
-- 登录（账号密码在 https://packages.aliyun.com/npm/npm-registry/guide 查看）
-  npm login --registry=https://packages.aliyun.com/62046985b3ead41b374a17f7/npm/npm-registry/
-
-## 配置
-
-### 配置文件
-
-- 本地配置文件：config/config.js
-
-### webpack 配置文件
-
-- config/webpack.config.js

package/changelog.md

@@ -1,56 +0,0 @@
-# @hzab/utils@1.1.6
-
-feat: 添加sizeAdapter.js适配文件
-
-# @hzab/utils@1.1.5
-
-fix: objToSearch encode; searchToObj decode
-
-# @hzab/utils@1.1.4
-
-fix: url replace hash 重复拼接问题
-feat: url addSearch 往 url search 添加参数，返回结果 search
-
-# @hzab/utils@1.1.3
-
-feat: 增强 mergePreviewConfig——仅在有有效前缀时拼接；支持 data/blob/协议相对地址；兼容 baseUrl 别名
-
-# @hzab/utils@1.1.2
-
-fix: opt?.params?.hasPrePath 支持关闭内部默认地址前缀
-
-# @hzab/utils@1.1.1
-
-fix: fileName 添加 hash 判断
-
-# @hzab/utils@1.1.0
-
-refactor: lodash 改为 lodash-es
-
-# @hzab/utils@1.0.19
-
-fix: 修复图片后缀名-判断优化
-
-# @hzab/utils@1.0.18
-
-fix: 修复图片后缀名
-
-# @hzab/utils@1.0.17
-
-fix: scan-qr 引用路径修复
-
-# @hzab/utils@1.0.16
-
-feat: 图片链接添加 query
-
-# @hzab/utils@1.0.15
-
-feat: 二维码，创建路径，区分前缀
-
-# @hzab/utils@1.0.14
-
-feat: 添加压缩图片函数
-
-# @hzab/utils@1.0.13
-
-feat: upload axios ts