an-function

一个包含 JavaScript 常用工具函数的库，提供日期处理、文件下载、WebSocket 连接等实用功能。

安装

npm install an-function

使用方法

// ES6 模块导入
import { getLengthArray, deepClone, chinaDate } from "an-function";

// CommonJS 导入
const { getLengthArray, deepClone, chinaDate } = require("an-function");

API 文档

getLengthArray

生成一个从 1 到指定数字的数组。

参数:

• number (number, 可选): 要生成的数组长度，默认为 0。

返回值:

• number[]: 一个从 1 到 number 的数组。

示例:

import { getLengthArray } from "an-function";

// 生成 [1, 2, 3, 4, 5]
const arr = getLengthArray(5);
console.log(arr); // [1, 2, 3, 4, 5]

deepClone

创建一个对象的深拷贝。

参数:

• obj (Object): 要拷贝的对象。
• hash (WeakMap, 可选): 用于处理循环引用的 WeakMap，默认为新的 WeakMap。
• copyContructor (boolean, 可选): 是否拷贝构造函数，默认为 false。

返回值:

• Object: 对象的深拷贝。

特性:

• 支持处理循环引用
• 支持基本类型、Date、RegExp 对象
• 如果浏览器支持 structuredClone，会优先使用它

示例:

import { deepClone } from "an-function";

const obj = {
  a: 1,
  b: { c: 2 },
  d: new Date(),
  e: /test/g,
};
const clonedObj = deepClone(obj);

chinaDate

将日期格式化为中国日期格式。

参数:

• times (string|Date|null|number, 可选): 要格式化的日期。如果为 null 或 undefined，则使用当前日期。
• fengefu (string, 可选): 用于格式化日期的分隔符，默认为 '-'。

返回值:

• Object: 一个包含各种日期格式和组件的对象：
  • fengefu: 分隔符
  • newDate: 日期对象
  • nian: 年份
  • yue: 月份（两位数）
  • ri: 日（两位数）
  • shi: 小时（两位数）
  • fen: 分钟（两位数）
  • miao: 秒（两位数）
  • date: 完整日期时间字符串 (YYYY-MM-DD HH:MM:SS)
  • date0: 当天 00:00:00 的日期时间字符串
  • date59: 当天 23:59:59 的日期时间字符串
  • nyr: 日期部分 (YYYY-MM-DD)
  • sfm: 时间部分 (HH:MM:SS)
  • number: 时间戳
  • get0: 当天 00:00:00 的时间戳
  • get59: 当天 23:59:59 的时间戳

示例:

import { chinaDate } from "an-function";

// 使用当前日期
const today = chinaDate();
console.log(today.nyr); // 例如 "2023-11-22"
console.log(today.sfm); // 例如 "14:30:45"

// 使用指定日期
const specificDate = chinaDate("2023/11/22");
console.log(specificDate.date); // "2023-11-22 00:00:00"

// 使用斜杠作为分隔符
const dateWithSlash = chinaDate(new Date(), "/");
console.log(dateWithSlash.nyr); // 例如 "2023/11/22"

getUrlParams

将 URL 参数解析为对象。

参数:

• url (string, 可选): URL 字符串。如果未提供，则使用当前页面的 URL。

返回值:

• Object: 一个包含解析后的 URL 参数的对象。

示例:

import { getUrlParams } from "an-function";

// 假设当前 URL 是 "https://example.com?name=John&age=30"
const params = getUrlParams();
console.log(params); // { name: "John", age: "30" }

// 解析指定 URL
const customParams = getUrlParams("https://example.com?product=phone&color=black");
console.log(customParams); // { product: "phone", color: "black" }

aDownLoad

通过创建一个锚点元素触发文件下载。

参数:

• href (string): 要下载的文件的 URL。
• fileName (string, 可选): 要下载的文件名，默认为空字符串。

示例:

import { aDownLoad } from "an-function";

// 下载一个文件
aDownLoad("https://example.com/file.pdf", "document.pdf");

aDownLoad2

从 Blob 响应中触发文件下载。

参数:

• response (Blob): 要下载的 Blob 响应。
• fileName (string, 可选): 要下载的文件名，默认为空字符串。

示例:

import { aDownLoad2 } from "an-function";

// 假设从 API 获取了一个 Blob 响应
fetch("https://example.com/api/download")
  .then((response) => response.blob())
  .then((blob) => {
    aDownLoad2(blob, "downloaded-file.pdf");
  });

objKeysHasValue

检查对象中的某些或所有指定键是否有值。

参数:

• obj (Object, 可选): 要检查的对象，默认为空对象。
• keys (string[], 可选): 要检查的键，默认为空数组。
• type (string, 可选): 检查类型，'some' 表示至少有一个键有值，'all' 表示所有键都有值，默认为 'some'。

返回值:

• boolean: 如果条件满足，返回 true，否则返回 false。

示例:

import { objKeysHasValue } from "an-function";

const user = {
  name: "John",
  age: 30,
  email: "",
};

// 检查是否至少有一个键有值
const hasSomeValues = objKeysHasValue(user, ["name", "email"], "some");
console.log(hasSomeValues); // true，因为 'name' 有值

// 检查是否所有键都有值
const hasAllValues = objKeysHasValue(user, ["name", "email"], "all");
console.log(hasAllValues); // false，因为 'email' 没有值

anWebSocket

WebSocket 连接管理类，提供自动重连、心跳检测等功能。

构造函数参数:

• options (Object): 配置选项对象
  • url (string, 必须): WebSocket 服务器 URL
  • sendMessage (any, 可选): 连接成功后要发送的消息
  • webSocketBack (Function, 可选): 接收消息的回调函数
  • pingTimeout (number, 可选): 发送心跳的间隔时间（毫秒），默认为 10000
  • pongTimeout (number, 可选): 等待心跳响应的超时时间（毫秒），默认为 8000
  • reconnectTimeout (number, 可选): 重连间隔时间（毫秒），默认为 4000
  • pingMsg (string, 可选): 心跳消息内容，默认为 'heartbeat'
  • repeatLimit (number, 可选): 最大重连次数，默认为 null（无限）
  • showLog (boolean, 可选): 是否显示日志，默认为 false

方法:

• send(msg): 发送消息
• close(permanently = false): 关闭连接，permanently 为 true 时永久关闭不再重连
• destroy(): 永久关闭连接
• setEventHandlers(handlers): 设置事件处理函数
• getState(): 获取当前连接状态
• isConnected(): 检查是否已连接
• getActiveConnections(): 获取当前活动连接数

示例:

import { anWebSocket } from "an-function";

const ws = new anWebSocket({
  url: "wss://example.com/socket",
  sendMessage: { type: "auth", token: "user-token" },
  webSocketBack: (event) => {
    console.log("收到消息:", event.data);
  },
  showLog: true,
});

// 发送消息
ws.send({ type: "message", content: "Hello!" });

// 设置事件处理函数
ws.setEventHandlers({
  onopen: () => console.log("连接已打开"),
  onclose: () => console.log("连接已关闭"),
});

// 关闭连接
ws.close();

// 永久关闭
ws.destroy();

fileToBase64

将文件转换为 base64 字符串。

参数:

• file (File): 要转换的文件对象。

返回值:

• Promise<string>: 解析为 base64 字符串的 Promise。

示例:

import { fileToBase64 } from "an-function";

// 假设有一个文件输入元素
const fileInput = document.getElementById("fileInput");
fileInput.addEventListener("change", async (e) => {
  const file = e.target.files[0];
  if (file) {
    try {
      const base64String = await fileToBase64(file);
      console.log(base64String);
      // 可以将 base64 字符串用于图片预览或上传
    } catch (error) {
      console.error("转换失败");
    }
  }
});

anInterval 函数用法说明代替 window.setInterval

anTimeout 函数用法说明代替 window.setTimeout（用法同 anInterval）

anInterval 是一个使用 Web Workers 实现的自定义间隔函数。它返回一个包含 on 和 off 方法的对象，用于设置和清除定时器。

方法

on(fn, time)

• 参数
  • fn (Function): 定时器触发时要执行的回调函数。
  • time (Number): 定时器的时间间隔，单位为毫秒。
• 返回值
  • (String): 定时器的唯一标识符，用于后续清除定时器。
• 用法
• on(fn, time) 检查 Worker 是否存在，如果不存在则创建 Worker。 生成一个唯一的定时器标识符。 将标识符和回调函数存储在 listeners Map 中。 向 Worker 发送消息，传递标识符和时间间隔。
• off(id) 检查 listeners Map 中是否存在该标识符。 如果存在，则删除该标识符及其对应的回调函数。 向 Worker 发送消息，指示清除定时器。

// 创建一个定时器，每隔1秒触发一次
const id = anInterval.on(() => {
  console.log("每秒触发一次");
}, 1000);

// 5秒后清除定时器
setTimeout(() => {
  anInterval.off(id);
  console.log("定时器已清除");
}, 5000);