常用JavaScript工具函数封装与优化

通用JavaScript方法封装

在现代Web开发中，许多应用程序都需要处理常见的操作，如日期格式化、表单重置、数据字典回显、树形结构数据构建等。为了提高开发效率并减少重复代码，我们可以将这些常用的操作封装成通用函数，以便在多个项目中复用。以下是一些常用的JavaScript方法封装，它们可以大大简化前端开发中的任务。

1. 日期格式化 parseTime

日期和时间的格式化是Web开发中经常遇到的需求，parseTime 方法能够将时间对象或时间戳格式化为指定格式的字符串。

javascript
复制代码
export function parseTime(time, pattern) {
  if (arguments.length === 0 || !time) {
    return null;
  }
  const format = pattern || '{y}-{m}-{d} {h}:{i}:{s}';
  let date;
  if (typeof time === 'object') {
    date = time;
  } else {
    if ((typeof time === 'string') && (/^[0-9]+$/.test(time))) {
      time = parseInt(time);
    } else if (typeof time === 'string') {
      time = time.replace(new RegExp(/-/gm), '/').replace('T', ' ').replace(new RegExp(/.[\d]{3}/gm), '');
    }
    if ((typeof time === 'number') && (time.toString().length === 10)) {
      time = time * 1000;
    }
    date = new Date(time);
  }
  const formatObj = {
    y: date.getFullYear(),
    m: date.getMonth() + 1,
    d: date.getDate(),
    h: date.getHours(),
    i: date.getMinutes(),
    s: date.getSeconds(),
    a: date.getDay()
  };
  const time_str = format.replace(/{(y|m|d|h|i|s|a)+}/g, (result, key) => {
    let value = formatObj[key];
    if (key === 'a') { return ['日', '一', '二', '三', '四', '五', '六'][value]; }
    if (result.length > 0 && value < 10) {
      value = '0' + value;
    }
    return value || 0;
  });
  return time_str;
}

2. 表单重置 resetForm

在开发中，表单重置是一个常见需求。resetForm 方法可以快速清空表单中的所有数据，重置表单字段。

javascript
复制代码
export function resetForm(refName) {
  if (this.$refs[refName]) {
    this.$refs[refName].resetFields();
  }
}

3. 添加日期范围 addDateRange

在某些情况下，我们需要将用户选择的日期范围添加到请求参数中。addDateRange 方法能够将日期范围自动添加到请求参数中。

javascript
复制代码
export function addDateRange(params, dateRange, propName) {
  let search = params;
  search.params = typeof (search.params) === 'object' && search.params !== null && !Array.isArray(search.params) ? search.params : {};
  dateRange = Array.isArray(dateRange) ? dateRange : [];
  if (typeof (propName) === 'undefined') {
    search.params['beginTime'] = dateRange[0];
    search.params['endTime'] = dateRange[1];
  } else {
    search.params['begin' + propName] = dateRange[0];
    search.params['end' + propName] = dateRange[1];
  }
  return search;
}

4. 数据字典回显 selectDictLabel 和 selectDictLabels

在前端开发中，我们经常需要将后端返回的数值字典转化为用户友好的标签。selectDictLabel 和 selectDictLabels 方法可以帮助你实现这一点。

javascript
复制代码
export function selectDictLabel(datas, value) {
  if (value === undefined) {
    return "";
  }
  var actions = [];
  Object.keys(datas).some((key) => {
    if (datas[key].value == ('' + value)) {
      actions.push(datas[key].label);
      return true;
    }
  })
  if (actions.length === 0) {
    actions.push(value);
  }
  return actions.join('');
}

export function selectDictLabels(datas, value, separator) {
  if (value === undefined || value.length === 0) {
    return "";
  }
  if (Array.isArray(value)) {
    value = value.join(",");
  }
  var actions = [];
  var currentSeparator = undefined === separator ? "," : separator;
  var temp = value.split(currentSeparator);
  Object.keys(value.split(currentSeparator)).some((val) => {
    var match = false;
    Object.keys(datas).some((key) => {
      if (datas[key].value == ('' + temp[val])) {
        actions.push(datas[key].label + currentSeparator);
        match = true;
      }
    })
    if (!match) {
      actions.push(temp[val] + currentSeparator);
    }
  })
  return actions.join('').substring(0, actions.join('').length - 1);
}

5. 字符串格式化 sprintf

字符串格式化是另一种常见需求，sprintf 方法可以将占位符 %s 替换为实际的参数。

javascript
复制代码
export function sprintf(str) {
  var args = arguments, flag = true, i = 1;
  str = str.replace(/%s/g, function () {
    var arg = args[i++];
    if (typeof arg === 'undefined') {
      flag = false;
      return '';
    }
    return arg;
  });
  return flag ? str : '';
}

6. 转换字符串为空 parseStrEmpty

在处理数据时，我们经常需要将 undefined 或 null 转换为空字符串。parseStrEmpty 方法可以帮助我们实现这一点。

javascript
复制代码
export function parseStrEmpty(str) {
  if (!str || str == "undefined" || str == "null") {
    return "";
  }
  return str;
}

7. 数据合并 mergeRecursive

mergeRecursive 方法可以将两个对象进行递归合并，合并过程中如果遇到对象类型的值会递归合并，非对象类型的值会覆盖源对象中的值。

javascript
复制代码
export function mergeRecursive(source, target) {
  for (var p in target) {
    try {
      if (target[p].constructor == Object) {
        source[p] = mergeRecursive(source[p], target[p]);
      } else {
        source[p] = target[p];
      }
    } catch (e) {
      source[p] = target[p];
    }
  }
  return source;
};

8. 构造树形结构数据 handleTree

构造树形结构数据在许多场景中都非常有用，特别是在处理菜单或组织结构数据时。handleTree 方法可以将扁平的数据转化为树形结构。

javascript
复制代码
export function handleTree(data, id, parentId, children) {
  let config = {
    id: id || 'id',
    parentId: parentId || 'parentId',
    childrenList: children || 'children'
  };

  var childrenListMap = {};
  var nodeIds = {};
  var tree = [];

  for (let d of data) {
    let parentId = d[config.parentId];
    if (childrenListMap[parentId] == null) {
      childrenListMap[parentId] = [];
    }
    nodeIds[d[config.id]] = d;
    childrenListMap[parentId].push(d);
  }

  for (let d of data) {
    let parentId = d[config.parentId];
    if (nodeIds[parentId] == null) {
      tree.push(d);
    }
  }

  for (let t of tree) {
    adaptToChildrenList(t);
  }

  function adaptToChildrenList(o) {
    if (childrenListMap[o[config.id]] !== null) {
      o[config.childrenList] = childrenListMap[o[config.id]];
    }
    if (o[config.childrenList]) {
      for (let c of o[config.childrenList]) {
        adaptToChildrenList(c);
      }
    }
  }
  return tree;
}

9. 参数处理 tansParams

有时我们需要将对象格式的参数转化为查询字符串格式，tansParams 方法可以将对象中的嵌套属性转换为URL参数格式。

javascript
复制代码
export function tansParams(params) {
  let result = '';
  for (const propName of Object.keys(params)) {
    const value = params[propName];
    var part = encodeURIComponent(propName) + "=";
    if (value !== null && value !== "" && typeof (value) !== "undefined") {
      if (typeof value === 'object') {
        for (const key of Object.keys(value)) {
          if (value[key] !== null && value[key] !== "" && typeof (value[key]) !== 'undefined') {
            let params = propName + '[' + key + ']';
            var subPart = encodeURIComponent(params) + "=";
            result += subPart + encodeURIComponent(value[key]) + "&";
          }
        }
      } else {
        result += part + encodeURIComponent(value) + "&";
      }
    }
  }
  return result;
}

10. 获取标准路径 getNormalPath

getNormalPath 方法能够修正路径格式，确保路径符合标准。

javascript
复制代码
export function getNormalPath(p) {
  if (p.length === 0 || !p || p == 'undefined') {
    return p;
  };
  let res = p.replace('//', '/');
  if (res[res.length - 1] === '/') {
    return res.slice(0, res.length - 1);
  }
  return res;
}

11. 验证Blob格式 blobValidate

blobValidate 方法可以判断文件是否为非JSON格式的Blob对象。

javascript
复制代码
export function blobValidate(data) {
  return data.type !== 'application/json';
}

---

通过将这些通用的方法封装成独立的函数，我们能够提高开发效率，并减少重复代码。这些函数能够帮助开发者轻松实现常见的需求，如日期格式化、表单操作、树形结构处理等，进而提升整个项目的可维护性和开发体验。

4o