@mt-kit/utils v1.0.1

micro-util

下载

npm i @mt-kit/utils

使用

See

API

animationFrameThrottle

使用 requestAnimationFrame 创建函数节流版本，限制函数在特定时间内的调用次数。

// 滚动事件处理
window.addEventListener('scroll', animationFrameThrottle(handleScroll));

// 窗口大小改变
window.addEventListener('resize', animationFrameThrottle(handleResize));

// 动画效果
const animatedFunction = animationFrameThrottle(updateAnimation);

imageBase64ToBlob

将 Base64 格式的图片转换为 Blob 对象。

const base64Data = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...';
const blob = imageBase64ToBlob(base64Data);

imageUrlToBase64

将图片 URL 转换为 Base64 格式。

imageUrlToBase64('https://example.com/image.png')
  .then(base64 => {
    console.log(base64); // data:image/png;base64,...
  });

downloadByUrl

根据文件地址进行下载。

downloadByUrl({
  url: 'https://example.com/document.pdf',
  target: '_blank',
  fileName: 'my-document.pdf'
});

downloadDataFile

根据文件数据进行下载。

const data = new Uint8Array([72, 101, 108, 108, 111]); // "Hello" 的 ASCII 码
downloadDataFile(data, 'hello.txt', 'text/plain');

downloadBase64File

根据 Base64 数据下载文件。

const base64Data = 'data:text/plain;base64,SGVsbG8gV29ybGQh'; // "Hello World!"
downloadBase64File(base64Data, 'hello.txt');

downloadUrlFile

根据在线图片的 URL 进行下载。

downloadUrlFile(
  'https://example.com/image.png',
  'my-image.png',
  'image/png'
);

copyText

复制文本到剪贴板。

copyText('Hello World!').then(() => {
  console.log('文本已复制到剪贴板');
});

queryStringToObject

将查询字符串转换为对象。

const query = queryStringToObject('?name=John&age=30');
console.log(query); // { name: 'John', age: '30' }

openWindow

打开新窗口。

openWindow('https://example.com', {
  target: '_blank',
  features: 'width=800,height=600'
});

cookieHelper

Cookie 操作助手。

方法：

• get(name) : 获取指定名称的 cookie
• set(name, value, options) : 设置 cookie
• remove(name) : 删除指定名称的 cookie

// 设置 cookie
cookieHelper.set('username', 'John', { expires: 7 }); // 7天过期

// 获取 cookie
const username = cookieHelper.get('username');

// 删除 cookie
cookieHelper.remove('username');

localStorageHelper

localStorage 操作助手。

方法：

• get(name) : 获取指定名称的本地存储
• set(name, value) : 设置本地存储
• remove(name) : 删除指定名称的本地存储
• clear() : 清空所有数据

// 设置数据
localStorageHelper.set('user', { name: 'John', age: 30 });

// 获取数据
const user = localStorageHelper.get('user');

// 删除数据
localStorageHelper.remove('user');

// 清空所有数据
localStorageHelper.clear();

isElement

判断是否为 DOM 元素。

const div = document.createElement('div');
console.log(isElement(div)); // true
console.log(isElement({})); // false

isFunction

判断是否为函数。

console.log(isFunction(() => {})); // true
console.log(isFunction({})); // false

isEqual

比较两个对象是否相等。

const objA = { a: 1, b: { c: 2 } };
const objB = { a: 1, b: { c: 2 } };
const objC = { a: 1, b: { c: 3 } };

console.log(isEqual(objA, objB)); // true
console.log(isEqual(objA, objC)); // false

isNull

判断是否为 null。

console.log(isNull(null)); // true
console.log(isNull(undefined)); // false
console.log(isNull(0)); // false

isObject

判断是否为对象类型。

console.log(isObject({})); // true
console.log(isObject([])); // true
console.log(isObject(null)); // false
console.log(isObject('string')); // false

isUndefined

判断是否为 undefined。

console.log(isUndefined(undefined)); // true
console.log(isUndefined(null)); // false
console.log(isUndefined(0)); // false

clone

浅拷贝对象。

const obj = { a: 1, b: { c: 2 } };
const cloned = clone(obj);

console.log(cloned); // { a: 1, b: { c: 2 } }
console.log(cloned.b === obj.b); // true，浅拷贝，引用相同

cloneDeep

深拷贝对象。

const obj = { a: 1, b: { c: 2 } };
const cloned = cloneDeep(obj);

console.log(cloned); // { a: 1, b: { c: 2 } }
console.log(cloned.b === obj.b); // false，深拷贝，引用不同

debounce

创建一个防抖函数，延迟调用函数直到上一次调用后的一段时间已经过去。

// 搜索输入防抖
const debouncedSearch = debounce((query) => {
  fetchSearchResults(query);
}, 300);

// 在输入框中使用
inputElement.addEventListener('input', (e) => {
  debouncedSearch(e.target.value);
});

throttle

创建一个节流函数，限制函数在一段时间内只能调用一次。

// 滚动事件节流
const throttledScroll = throttle(() => {
  updateScrollPosition();
}, 100);

// 在滚动事件中使用
window.addEventListener('scroll', throttledScroll);

omitBy

创建一个从对象中排除满足条件的属性的新对象。

const sampleObject = {
  a: 1,
  b: 2,
  c: 3,
  d: 4,
};

// 从对象中排除值大于 2 的属性
const result = omitBy(sampleObject, (value) => value > 2);
console.log(result); // { a: 1, b: 2 }

objectValueToString

将对象的值转换为字符串。

const obj = {
  id: 123,
  active: true,
  score: 98.5
};

const stringified = objectValueToString(obj);
console.log(stringified);
// 输出: { id: '123', active: 'true', score: '98.5' }