一个好用的工具类
目前为
此脚本不应直接安装，它是一个供其他脚本使用的外部库。如果您需要使用该库，请在脚本元属性加入：// @require https://update.greasyfork.cloud/scripts/455186/1127574/WhiteSevsUtils.js
/*
* @overview 自己常用的工具类定义
* @copyright GPL-3.0-only
* @author WhiteSevs
* @version 0.1
*/
let Utils = {};
/*
* @param {string|function} func - 需要捕获错误的函数或函数格式的字符串
* @param {object} params - 该函数的参数和捕获到错误的函数的参数，类型为数组Array
* @param {string|function} errorFunc - 捕获到错误后执行的函数或函数格式的字符串
* @example Utils.tryCatch("(pam)=>{console.log('this is a function and params is' + pam[0])}",["参数1"],"()=>{console.log('对错误进行处理判断')}");
*/
Utils.tryCatch = function (func, params, errorFunc) {
/* 捕获错误 */
if (func == null) {
throw "警告: 参数 func 为不存在";
}
if (typeof func !== "function" && typeof func !== "string") {
throw "参数 func 类型必须为function类型或者string类型";
}
if (
params != null &&
typeof params !== "object" &&
typeof params !== "string"
) {
throw "参数 params 类型必须为object类型或者string类型";
}
if (
errorFunc != null &&
typeof errorFunc !== "object" &&
typeof errorFunc !== "string"
) {
throw "参数 errorFunc 类型必须为function类型或者string类型";
}
var result = null;
try {
result = typeof func === "string" ? window.eval(func) : func(params);
} catch (error) {
console.log(
"%c" + (func.name ? func.name : func + "出现错误"),
"color: #f20000"
);
console.log("%c" + ("错误原因：" + error), "color: #f20000");
console.trace(func);
result =
typeof func === "string" ? window.eval(errorFunc) : errorFunc(params);
} finally {
return result;
}
};
/*
* @description 格式化时间字符串
* @param {string} str - 字符串格式的时间，例如：2022-11-21 00:00:00，或者是 00:00:00
* @return {number} - 返回时间戳
* @example Utils.formatTextToTimeStamp("2022-11-21 00:00:00");
*/
Utils.formatTextToTimeStamp = function (text) {
/* 把字符串格式的时间（完整，包括日期和时间）格式化成时间戳 */
if (typeof text !== "string") {
throw "参数 text 必须为string类型";
}
if (text.length === 8) {
/* 参数只有时间 */
var today = new Date();
text =
today.getFullYear() +
"-" +
(today.getMonth() + 1) +
"-" +
today.getDate() +
" " +
text;
}
text = text.substring(0, 19);
text = text.replace(/-/g, "/");
var timestamp = new Date(text).getTime();
return timestamp;
};
/*
* @description 定位网页中字符串位置并标亮，注意，该字符串必须是能在网页中看得到的，隐藏的是无法定位的
* @param {string} str - 需要寻找的字符串
* @param {boolean} caseSensitive - 区分大小写
* @return {boolean} true/false - 找到为true，否则false
* @example Utils.findWindowPageString("xxxxx");
* @exampleResult true
*/
Utils.findWindowPageString = function (str, caseSensitive = false) {
var TRange = null;
var strFound;
if (window.find) {
// CODE FOR BROWSERS THAT SUPPORT window.find
strFound = self.find(str, caseSensitive, true, true, false);
if (strFound && self.getSelection && !self.getSelection().anchorNode) {
strFound = self.find(str, caseSensitive, true, true, false);
}
if (!strFound) {
strFound = self.find(str, 0, 1);
while (self.find(str, 0, 1)) continue;
}
} else if (navigator.appName.indexOf("Microsoft") != -1) {
// EXPLORER-SPECIFIC CODE
if (TRange != null) {
TRange.collapse(false);
strFound = TRange.findText(str);
if (strFound) TRange.select();
}
if (TRange == null || strFound == 0) {
TRange = self.document.body.createTextRange();
strFound = TRange.findText(str);
if (strFound) TRange.select();
}
} else if (navigator.appName == "Opera") {
alert("Opera browsers not supported, sorry...");
return;
}
return strFound ? true : false;
};
/*
* @description 格式化byte为KB、MB、GB、TB、PB、EB、ZB、YB、BB、NB、DB
* @param {number} bitSize - 字节
* @param {boolean} addType - 是否添加单位，默认添加
* @return {string|number} - 添加单位就是字符串，否则为float类型，保留两位
* @example Utils.formatByteToSize("812304");
* @exampleResult
*/
Utils.formatByteToSize = function (byteSize, addType = true) {
// B字节转KB、MB、GB
byteSize = parseInt(byteSize);
if (isNaN(byteSize)) {
throw "参数 byteSize 格式不正确";
}
var result = 0;
var resultType = "KB";
var sizeData = {};
sizeData.KB = 1024;
sizeData.MB = sizeData.KB * sizeData.KB;
sizeData.GB = sizeData.MB * sizeData.KB;
sizeData.TB = sizeData.GB * sizeData.KB;
sizeData.PB = sizeData.TB * sizeData.KB;
sizeData.EB = sizeData.PB * sizeData.KB;
sizeData.ZB = sizeData.EB * sizeData.KB;
sizeData.YB = sizeData.ZB * sizeData.KB;
sizeData.BB = sizeData.YB * sizeData.KB;
sizeData.NB = sizeData.BB * sizeData.KB;
sizeData.DB = sizeData.NB * sizeData.KB;
for (key in sizeData) {
result = byteSize / sizeData[key];
resultType = key;
if (sizeData.KB >= result) {
break;
}
}
result = result.toFixed(2);
result = addType ? result + resultType.toString() : parseFloat(result);
return result;
};
/*
* @description 数组按照内部某个值的大小比对排序，如[{"time":"2022-1-1"},{"time":"2022-2-2"}]
* @param {string} getPropertyValueFunc - 数组内部项的某个属性的值的方法，参数为这个项
* @param {boolean} sortByDesc - 排序方式为倒序，值为true或false，默认为true
* @return {object} - 返回比较排序完成的数组
* @example [{"time":"2022-1-1"},{"time":"2022-2-2"}].sort(Utils.sortListByProperty((item)=>{return item["time"]},true))
* @example [{"time":"2022-1-1"},{"time":"2022-2-2"}].sort(Utils.sortListByProperty((item)=>{return item["time"]},false))
*/
Utils.sortListByProperty = function (getPropertyValueFunc, sortByDesc = true) {
if (typeof sortByDesc !== "boolean") {
throw "参数 sortByDesc 必须为boolean类型";
}
if (getPropertyValueFunc == null) {
throw "获取前面的值或后面的值的方法不能为空";
}
return function (after_obj, before_obj) {
var beforeValue = getPropertyValueFunc(before_obj); /* 前 */
var afterValue = getPropertyValueFunc(after_obj); /* 后 */
if (sortByDesc) {
if (afterValue > beforeValue) {
return -1;
} else if (afterValue < beforeValue) {
return 1;
} else {
return 0;
}
} else {
if (afterValue < beforeValue) {
return -1;
} else if (afterValue > beforeValue) {
return 1;
} else {
return 0;
}
}
};
};
/*
* @description Array添加一个内部属性，数组根据相同的字段合并成字符串
* @example [{"name":"Array内部方法: "},{"name":"mergeToString"}].mergeToString("name");
*/
Utils.mergeArrayToString = function (list, propertyName) {
if (list == null) {
throw "参数 list 不能为空";
}
if (propertyName == null) {
throw "参数 propertyName 不能为null";
}
var content = "";
Array.from(list).forEach((item) => {
content = content + item[propertyName];
});
return content;
};
/*
* @description JSON内所有的值转为Array数组
* @param {object} _json_ - JSON数据
* @return {object} - 返回数组
* @example Utils.jsonAllValueToArray({"Utils":"jsonToArray","return","Array"});
* @exampleResult ['jsonToArray', 'Array']
*/
Utils.jsonAllValueToArray = function (_json_) {
if (typeof _json_ !== "object") {
throw "参数 _json_ 必须为object类型";
}
var retArray = [];
Object.keys(_json_).forEach(function (key) {
retArray = retArray.concat(_json_[key]);
});
return retArray;
};
/*
* @description JSON格式的字符串转为JSON对象
* @param {string} text - JSON格式的字符串
* @return {object} - 返回JSON对象
* @example Utils.jsonStrToObject('{"Utils":"jsonStrToObject","return","json"}');
* @exampleResult {"Utils":"jsonStrToObject","return","json"}
*/
Utils.jsonStrToObject = function (text) {
if (typeof text !== "string") {
throw "参数 text 类型必须为string类型";
}
return window.eval("(" + text + ")");
};
/*
* @description 获取数组的随机值
* @param {string} array - 数组数据
* @return {string} - 返回数组的随机值
* @example Utils.getArrayRandValue(["Utils","getArrayRandValue"]);
* @exampleResult getArrayRandValue
*/
Utils.getArrayRandValue = function (_array_) {
return _array_[Math.floor(Math.random() * _array_.length)];
};
/*
* @description 获取两个数字区间的随机值
* @param {number} number - 数字区间
* @param {number} number2 - 数字区间
* @return {number} - 返回两个数字区间的随机值
* @example Utils.getRandNumber(1,10);
* @exampleResult 5
* @example Utils.getRandNumber(10,1);
* @exampleResult 8
*/
Utils.getRandNumber = function (number, number2) {
if (typeof number !== "number") {
throw "参数 number 必须为number类型";
}
if (typeof number2 !== "number") {
throw "参数 number2 必须为number类型";
}
var leftNumber = number > number2 ? number2 : number;
var rightNumber = number > number2 ? number : number2;
return Math.round(Math.random() * (rightNumber - leftNumber)) + leftNumber;
};
/*
* @description 获取格式化后的Date类型时间
* @param {string} text - 需要格式化的字符串或者时间戳
* @param {string} types - 格式化成的显示类型
* yyyy 年
* MM 月
* dd 天
* HH 时 (24小时制)
* hh 时 (12小时制)
* mm 分
* ss 秒
* @return {string} - 返回格式化后的时间
* @example Utils.getFormatTime("HH:mm:ss","2022-08-21 23:59:00");
* @exampleResult 23:59:00
* @example Utils.getFormatTime("HH:mm:ss",1899187424988);
* @exampleResult 15:10:13
*/
(Utils.getFormatTime = function (types = "yyyy-MM-dd HH:mm:ss", text) {
if (typeof types !== "string") {
throw "参数 types 必须是string类型";
}
if (text != null && typeof text !== "string" && typeof text !== "number") {
throw "参数 text 必须是string类型或者number类型";
}
var time = text == null ? new Date() : new Date(text);
function _checkTime_(i) {
/* 校验时间补0 */
if (i < 10) return "0" + i;
return i;
}
function _timeSystemChange_(_hour_) {
/* 时间制修改 24小时制转12小时制 */
return _hour_ > 12 ? _hour_ - 12 : _hour_;
}
var timeRegexp = {
yyyy: time.getFullYear(),
/* 年 */
MM: _checkTime_(time.getMonth() + 1),
/* 月 */
dd: _checkTime_(time.getDate()),
/* 日 */
HH: _checkTime_(time.getHours()),
/* 时 (24小时制) */
hh: _checkTime_(_timeSystemChange_(time.getHours())),
/* 时 (12小时制) */
mm: _checkTime_(time.getMinutes()),
/* 分 */
ss: _checkTime_(time.getSeconds()),
/* 秒 */
};
Object.keys(timeRegexp).forEach(function (key) {
var replaecRegexp = new RegExp(key, "g");
types = types.replace(replaecRegexp, timeRegexp[key]);
});
return types;
}),
/*
* @description 【手机】检测点击的地方是否在该元素区域内
* @param {object} obj - 需要检测的DOM元素
* @return {boolean} - 返回true或false
* @example Utils.checkClickInDOM(document.querySelector(".xxx"));
* @exampleResult false
*/
(Utils.checkClickInDOM = function (checkDOM) {
if (!(checkDOM instanceof HTMLElement)) {
throw "参数 checkDOM 类型必须为DOM元素";
}
var mouseClickPosX = Number(window.event.clientX); /* 鼠标相对屏幕横坐标 */
var mouseClickPosY = Number(window.event.clientY); /* 鼠标相对屏幕纵坐标 */
var elementPosXLeft = Number(
checkDOM.getBoundingClientRect().left
); /* 要检测的元素的相对屏幕的横坐标最左边 */
var elementPosXRight = Number(
checkDOM.getBoundingClientRect().right
); /* 要检测的元素的相对屏幕的横坐标最右边 */
var elementPosYTop = Number(
checkDOM.getBoundingClientRect().top
); /* 要检测的元素的相对屏幕的纵坐标最上边 */
var elementPosYBottom = Number(
checkDOM.getBoundingClientRect().bottom
); /* 要检测的元素的相对屏幕的纵坐标最下边 */
if (
mouseClickPosX >= elementPosXLeft &&
mouseClickPosX <= elementPosXRight &&
mouseClickPosY >= elementPosYTop &&
mouseClickPosY <= elementPosYBottom
) {
return true;
} else if (
checkDOM.innerHTML.indexOf(window.event.target.innerHTML) !== -1
) {
/* 这种情况是应对在界面中隐藏的元素，getBoundingClientRect获取的都是0 */
return true;
} else {
return false;
}
});
/*
* @description 同步执行延时函数
* @param {object|string} fnStr - 需要延时的函数或字符串格式的函数
* @param {number} delayTime - 需要检测的DOM元素
* @return {All|无返回值} - 返回自定义类型数据或者无返回
* @example await Utils.asyncSetTimeOut(xxxFunction, 2500);
* @exampleResult xxx
* @example await Utils.asyncSetTimeOut("()=>{console.log(12345)}", 2500);
* @exampleResult 无返回值
*/
Utils.asyncSetTimeOut = function (fnStr, delayTime) {
var _this = this;
if (typeof fnStr !== "function" && typeof fnStr !== "string") {
throw "参数 fnStr 类型必须为function类型或者string类型";
}
if (typeof delayTime !== "number") {
throw "参数 delayTime 类型必须为number类型";
}
return new Promise((res) => {
setTimeout(() => {
res(_this.tryCatch(fnStr));
}, delayTime);
});
};
/*
* @description 同步执行foreach函数，遍历数组
* @param {object} arrayData - 需要遍历的数组
* @param {function} handleDataFunction - 对该数组进行操作的函数，该函数的参数为数组格式的参数,[数组下标，数组项]
* @return 无返回值
* @example await Utils.asyncArrayForEach([1,2,3],xxxFunction);
*/
Utils.asyncArrayForEach = function (arrayData, handleDataFunction) {
var _this = this;
if (typeof arrayData !== "object") {
throw "参数 arrayData 类型必须为object类型";
}
if (
typeof handleDataFunction !== "object" &&
typeof handleDataFunction !== "string"
) {
throw "参数 handleDataFunction 类型必须为object或者string类型";
}
return Promise.all(
Array.from(arrayData).map(async (item, index) => {
await _this.tryCatch(handleDataFunction, [index, item]);
})
);
};
/*
* @description 同步延迟xxx毫秒
* @param {number} delayTime - 需要遍历的数组
* @return {无返回值}
* @example await Utils.sleep(2500); - 同步延时2500毫秒
*/
Utils.sleep = function (delayTime) {
if (typeof delayTime !== "number") {
throw "参数 delayTime 类型必须为number类型";
}
return new Promise((res) => {
setTimeout(() => {
res();
}, delayTime);
});
};
/*
* @description 注册全局函数Cookies
* @function Cookies.get("key")
* @param {string|number} key - 需要获取的cookie的key
* @return {string} 获取到的cookie值或者为空
* @function Cookies.set("key","value",8400);
* @param {string|number} key - 需要设置的cookie的key
* @param {All} key - 需要设置的cookie的value
* @param {number} time - 需要设置的cookie的过期时间
* @return 无返回值
* @example Utils.registerWindowCookies();
* Cookies.get("xxxx");
*/
Utils.registerWindowCookies = function () {
/*! js-cookie v3.0.1 | MIT */
(function (global, factory) {
typeof exports === "object" && typeof module !== "undefined"
? (module.exports = factory())
: typeof define === "function" && define.amd
? define(factory)
: ((global = global || self),
(function () {
var current = global.Cookies;
var exports = (global.Cookies = factory());
exports.noConflict = function () {
global.Cookies = current;
return exports;
};
})());
})(this, function () {
"use strict";
/* eslint-disable no-var */
function assign(target) {
for (var i = 1; i < arguments.length; i++) {
var source = arguments[i];
for (var key in source) {
target[key] = source[key];
}
}
return target;
}
/* eslint-enable no-var */
/* eslint-disable no-var */
var defaultConverter = {
read: function (value) {
if (value[0] === '"') {
value = value.slice(1, -1);
}
return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent);
},
write: function (value) {
return encodeURIComponent(value).replace(
/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,
decodeURIComponent
);
},
};
/* eslint-enable no-var */
/* eslint-disable no-var */
function init(converter, defaultAttributes) {
function set(key, value, attributes) {
if (typeof document === "undefined") {
return;
}
attributes = assign({}, defaultAttributes, attributes);
if (typeof attributes.expires === "number") {
attributes.expires = new Date(
Date.now() + attributes.expires * 864e5
);
}
if (attributes.expires) {
attributes.expires = attributes.expires.toUTCString();
}
key = encodeURIComponent(key)
.replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent)
.replace(/[()]/g, escape);
var stringifiedAttributes = "";
for (var attributeName in attributes) {
if (!attributes[attributeName]) {
continue;
}
stringifiedAttributes += "; " + attributeName;
if (attributes[attributeName] === true) {
continue;
}
/* Considers RFC 6265 section 5.2:
...
3. If the remaining unparsed-attributes contains a %x3B (";")
character:
Consume the characters of the unparsed-attributes up to,
not including, the first %x3B (";") character.
... */
stringifiedAttributes +=
"=" + attributes[attributeName].split(";")[0];
}
return (document.cookie =
key + "=" + converter.write(value, key) + stringifiedAttributes);
}
function get(key) {
if (typeof document === "undefined" || (arguments.length && !key)) {
return;
}
/* To prevent the for loop in the first place assign an empty array
in case there are no cookies at all. */
var cookies = document.cookie ? document.cookie.split("; ") : [];
var jar = {};
for (var i = 0; i < cookies.length; i++) {
var parts = cookies[i].split("=");
var value = parts.slice(1).join("=");
try {
var foundKey = decodeURIComponent(parts[0]);
jar[foundKey] = converter.read(value, foundKey);
if (key === foundKey) {
break;
}
} catch (e) {}
}
return key ? jar[key] : jar;
}
return Object.create(
{
set: set,
get: get,
remove: function (key, attributes) {
set(
key,
"",
assign({}, attributes, {
expires: -1,
})
);
},
withAttributes: function (attributes) {
return init(
this.converter,
assign({}, this.attributes, attributes)
);
},
withConverter: function (converter) {
return init(assign({}, this.converter, converter), this.attributes);
},
},
{
attributes: {
value: Object.freeze(defaultAttributes),
},
converter: {
value: Object.freeze(converter),
},
}
);
}
var api = init(defaultConverter, {
path: "/",
});
/* eslint-enable no-var */
return api;
});
};
/*
* @description base64转blob
* @param {string} dataurl - base64的数据
* @return {string} blob的链接
* @example Utils.base64ToBlob("data:image/jpeg;base64,.....");
* @exampleResult blob://xxxxxxx
*/
Utils.base64ToBlob = function (dataurl) {
if (typeof dataurl !== "string") {
throw "参数 dataurl 类型必须为string类型";
}
var arr = dataurl.split(","),
mime = arr[0].match(/:(.*?);/)[1],
bstr = atob(arr[1]),
n = bstr.length,
u8arr = new Uint8Array(n);
while (n--) {
u8arr[n] = bstr.charCodeAt(n);
}
return new Blob([u8arr], {
type: mime,
});
};
/*
* @description base64转File对象
* @param {string} dataurl - base64的数据
* @return {string} blob的链接
* @example Utils.base64ToFile("data:image/jpeg;base64,.....");
* @exampleResult object
*/
Utils.base64ToFile = function (dataurl, fileName) {
if (typeof dataurl !== "string") {
throw "参数 dataurl 类型必须为string类型";
}
if (typeof fileName !== "string") {
throw "参数 fileName 类型必须为string类型";
}
var arr = dataurl.split(","),
mime = arr[0].match(/:(.*?);/)[1],
bstr = atob(arr[1]),
n = bstr.length,
u8arr = new Uint8Array(n);
while (n--) {
u8arr[n] = bstr.charCodeAt(n);
}
return new File([u8arr], fileName, {
type: mime,
});
};
/*
* @description blob转File对象
* @param {string} theBlob - 需要转换的blob的链接
* @param {string} fileName - 转换成的File对象的文件名称
* @return {object} File对象
* @example Utils.blobToFile("blob://xxxxx");
* @exampleResult object
*/
Utils.blobToFile = function (theBlob, fileName) {
if (typeof theBlob !== "string") {
throw "参数 theBlob 类型必须为string类型";
}
if (typeof fileName !== "string") {
throw "参数 fileName 类型必须为string类型";
}
theBlob.lastModifiedDate = new Date();
theBlob.name = fileName;
return theBlob;
};
/*
* @description 同步File对象转base64
* @param {object} file - 需要转换的File对象
* @return {string} base64格式的数据
* @example await Utils.asyncFileToBase64(object);
* @exampleResult data:image/jpeg:base64/,xxxxxx
*/
Utils.asyncFileToBase64 = function (file) {
var reader = new FileReader();
reader.readAsDataURL(file);
return new Promise((res) => {
reader.onload = function (e) {
res(e.target.result);
};
});
};
/*
* @description 下载base64格式的数据
* @param {string} base64Content - 需要转换的base64数据
* @param {string} fileName - 需要保存的文件名
* @example Utils.downloadBase64("data:image/jpeg:base64/,xxxxxx");
*/
Utils.downloadBase64 = function (base64Content, fileName) {
var aLink = document.createElement("a");
var blob = this.base64ToBlob(base64Content);
var evt = document.createEvent("HTMLEvents");
evt.initEvent("click", true, true); // initEvent 不加后两个参数在FF下会报错 事件类型，是否冒泡，是否阻止浏览器的默认行为
aLink.download = fileName;
aLink.href = URL.createObjectURL(blob);
aLink.click();
};
/*
* @description 判断是否是手机访问
* @return {boolean} - 返回如果是手机true，否则false
* @example Utils.isPhone();
* @exampleResult true
*/
Utils.isPhone = function () {
return Boolean(/(iPhone|iPad|iPod|iOS|Android)/i.test(navigator.userAgent));
};
/*
* @description 自定义字典，用于new
* @example new let dictionary = Utils.Dictionary();
* @example dictionary.set("xxx","xxx");
* @example dictionary.get("xxx");
* @example dictionary.has("xxx");
*/
Utils.Dictionary = function () {
this.items = {};
this.has = function (key) {
/* 检查是否有某一个键 */
return this.items.hasOwnProperty(key);
};
this.set = function (key, val = "") {
/* 为字典添加某一个值 */
if (key === undefined) {
throw "参数 key 不能为空";
}
this.items[key] = val;
};
this.delete = function (key) {
/* 删除某一个键 */
if (this.has(key)) {
delete this.items[key];
return true;
}
return false;
};
this.get = function (key) {
/* 查找某一特定项 */
return this.has(key) ? this.items[key] : undefined;
};
this.values = function () {
/* 返回字典中的所有值 */
var res = [];
for (var prop in this.items) {
if (this.has(prop)) {
res.push(this.items[prop]);
}
}
return res;
};
this.clear = function () {
/* 清空字典 */
this.items = {};
};
this.size = function () {
/* 获取字典的长度 */
return Object.keys(this.items).length;
};
this.keys = function () {
/* 获取字典所有的键 */
return Object.keys(this.items);
};
this.getItems = function () {
/* 返回字典本身 */
return this.items;
};
};
/*
* @description JSON数据从源端替换到目标端中，如果目标端存在该数据则替换，不添加，返回结果为目标端替换完毕的结果
* @param {object} target - 目标端
* @param {object} source - 源端
* @example Utils.assignJSON({"1":1,"2":{"3":3}},{"2":{"3":4}});
* @exampleResult {"1":1,"2":{"3":4}}
*/
Utils.assignJSON = function (target, source) {
for (var target_key in target) {
if (typeof source[target_key] !== "undefined") {
if (
typeof source[target_key] === "object" &&
!(source[target_key] instanceof HTMLElement)
) {
target[target_key] = this.assignJSON(
target[target_key],
source[target_key]
);
} else {
target[target_key] = source[target_key];
}
}
}
return target;
};
/*
* @description 判断对象或数据是否为空
* @param {all} object - 需要判断的变量
* @example Utils.isNull({});
* @exampleResult true
* @example Utils.isNull([]);
* @exampleResult true
*/
Utils.isNull = function (object) {
var result = false;
if (typeof object === "undefined") {
result = true;
} else if (typeof object === "object") {
if (Object.keys(object).length === 0) {
result = true;
}
} else if (typeof object === "number") {
result = object === 0 ? true : false;
}
return result;
};
/*
* @description 自动锁对象，用于循环判断运行的函数，在循环外new后使用，注意，如果函数内部存在异步操作，需要使用await
* @param {object} func - 需要执行的函数
* @param {object|undefined} funcArgs - 需要执行的函数的参数
* @example var lock = new Utils.lockFunction(xxxx)
* --- 此处是循环内 ---
* lock.run();
* --- 此处是循环内 ---
* @example var lock = new Utils.lockFunction(xxxx,true) -- 异步操作
* --- 此处是循环内 ---
* await lock.run();
* --- 此处是循环内 ---
*/
Utils.lockFunction = function (func) {
(this.flag = false),
(this.lock = function () {
this.flag = true;
});
this.unlock = function () {
this.flag = false;
};
this.run = async function () {
if (this.flag) {
return;
}
this.lock();
await func(arguments); /* arguments调用 */
this.unlock();
};
};
/*
* @description 等待某个对象出现，结果为异步，需要await或者then
* @param {object} target - 需要寻找的DOM，传入id或class或div等...
* @param {number} intervalNumMax - 循环次数
* @param {number} intervalTime - 每次的循环时间
* @return {dom|null} - 如果找到返回数组形式的dom对象，否则返回空数组
* @example await Utils.waitForDOM("div.xxx");
* @example Utils.waitForDOM("div#xxx").then((dom)=>{xxxx});
*/
Utils.waitForDOM = function (target, intervalNumMax = 90, intervalTime = 300) {
if (typeof target !== "string") {
throw "参数 target 必须为string类型";
}
intervalNumMax = parseInt(intervalNumMax);
intervalTime = parseInt(intervalTime);
var intervalNum = 0;
return new Promise((res) => {
var interval = setInterval(function () {
if (intervalNum > intervalNumMax) {
res([]);
clearInterval(interval);
return;
}
if (document.querySelectorAll(target).length !== 0) {
res(document.querySelectorAll(target));
clearInterval(interval);
return;
}
intervalNum++;
}, intervalTime);
});
};
/*
* @description 复制到剪贴板
* @param {string|number} text - 需要复制到剪贴板的文本
* @example Utils.setClip("xxxx");
*/
Utils.setClip = function (text) {
if (text == null) {
return;
}
var clipBoardDOM = document.createElement("input");
clipBoardDOM.type = "text";
clipBoardDOM.setAttribute("style", "opacity:0;position:absolute;");
clipBoardDOM.id = "whitesevClipBoardInput";
document.body.append(clipBoardDOM);
var clipBoardInputNode = document.querySelector("#whitesevClipBoardInput");
clipBoardInputNode.value = text;
clipBoardInputNode.removeAttribute("disabled");
clipBoardInputNode.select();
document.execCommand("copy");
clipBoardInputNode.remove();
};
/*
* @description 监听页面元素改变并处理
* @param {object} target - 需要监听的元素，如果不存在，可以等待它出现
* @param {object} observer_config - MutationObserver的配置
* @example Utils.mutationObserver("div.xxxx",{"fn":()=>{},"config":{childList:true,attributes:true}});
*/
Utils.mutationObserver = function (target, observer_config) {
if (typeof target !== "string") {
throw "参数 target 类型必须为string类型";
}
var default_obverser_config = {
/* 监听到元素有反馈，需执行的函数 */
fn: () => {},
config: {
/* 当为 true 时，将会监听以 target 为根节点的整个子树。包括子树中所有节点的属性，而不仅仅是针对 target。默认值为 false */
subtree: undefined,
/* 当为 true 时，监听 target 节点中发生的节点的新增与删除（同时，如果 subtree 为 true，会针对整个子树生效）。默认值为 false。 */
childList: undefined,
/* 当为 true 时观察所有监听的节点属性值的变化。默认值为 true，当声明了 attributeFilter 或 attributeOldValue，默认值则为 false */
attributes: undefined,
/* 一个用于声明哪些属性名会被监听的数组。如果不声明该属性，所有属性的变化都将触发通知 */
attributeFilter: undefined,
/* 当为 true 时，记录上一次被监听的节点的属性变化；可查阅 MutationObserver 中的 Monitoring attribute values 了解关于观察属性变化和属性值记录的详情。默认值为 false */
attributeOldValue: undefined,
/* 当为 true 时，监听声明的 target 节点上所有字符的变化。默认值为 true，如果声明了 characterDataOldValue，默认值则为 false */
characterData: undefined,
/* 当为 true 时，记录前一个被监听的节点中发生的文本变化。默认值为 false */
characterDataOldValue: undefined,
},
};
observer_config = this.assignJSON(default_obverser_config, observer_config);
var MutationObserver =
window.MutationObserver ||
window.webkitMutationObserver ||
window.MozMutationObserver;
var mutationObserver = new MutationObserver(function (mutations) {
observer_config.fn(mutations);
});
this.waitForDOM(target).then((dom) => {
if (dom.length) {
mutationObserver.observe(dom[dom.length - 1], observer_config.config);
}
});
};
/*
* @description 获取随机的安卓手机User-Agent（25）个
* @return {string} - User-Agent
* @example Utils.getRandomAndroidUA();
* @exampleResult Mozilla/5.0....
*/
Utils.getRandomAndroidUA = function () {
const ANDROID_UA = [
"Mozilla/5.0 (Linux; Android 12; LDN-LX3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.80 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 12; RNE-L03) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.80 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 12; ASUS_X00ID Build/NMF26F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3497.100 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 12; WAS-LX3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.80 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 12; PRA-LX3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.80 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 12; MYA-L03) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.64 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 12; PBEM00 Build/PKQ1.190519.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/89.3904.62 XWEB/2891 MMWEBSDK/200901 Mobile Safari/537.36 MMWEBID/4773 MicroMessenger/12.19.1760(0x28901335) Process/toolsmp WeChat/arm64 NetType/4G Language/zh_CN ABI/arm64",
"Mozilla/5.0 (Linux; Android 11; M2003J15SC Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/89.0.4389.72 MQQBrowser/6.2 TBS/046011 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 11; Moto G Play) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.64 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 11; Moto C Build/NRD90M.063) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3440.91 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 11; Redmi Note 4 Build/NRD90M) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3396.87 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 11; HUAWEI VNS-L21 Build/HUAWEIVNS-L21) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3359.158 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 10; VTR-L09) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.80 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 10; ANG-AN00 Build/HUAWEIANG-AN00; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/89.0.4389.72 MQQBrowser/6.2 TBS/046011 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 10; MI 5X Build/OPM1.171019.019; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/89.3904.62 XWEB/2891 MMWEBSDK/200801 Mobile Safari/537.36 MMWEBID/9633 MicroMessenger/12.18.1740(0x2890123B) Process/toolsmp WeChat/arm64 NetType/4G Language/zh_CN ABI/arm64",
"Mozilla/5.0 (Linux; Android 10; Moto C Plus Build/NRD90M.04.026) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3440.91 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 10; TRT-LX3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.64 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 9; Moto G (5) Build/NPPS25.137-93-14; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/89.0.3497.100 Mobile Safari/537.36 [FB_IAB/FB4A;FBAV/193.0.0.45.101;]",
"Mozilla/5.0 (Mobile; Windows Phone 8.1; Android 9.0; ARM; Trident/12; Touch; rv:11.0; IEMobile/11.0; HTC; Windows Phone 8X by HTC) like iPhone OS 7_0_3 Mac OS X AppleWebKit/537 (KHTML, like Gecko) Mobile Safari/537",
"Mozilla/5.0 (Linux; Android 9; Moto G Build/MOB30M; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/89.0.2403.119 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 8; MI 6 Build/OPR1.170623.027; wv) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.24 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 8; M2003J15SC Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.4960.1 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 8; M2003J15SC Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4873.1 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 8; M2003J15SC Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4749.1 Mobile Safari/537.36",
"Mozilla/5.0 (Linux; Android 8; M2003J15SC Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4600.1 Mobile Safari/537.36",
];
return ANDROID_UA[Math.floor(Math.random() * ANDROID_UA.length)];
};
/*
* @description 获取随机的电脑端User-Agent（25）个
* @return {string} - User-Agent
* @example Utils.getRandomPCUA();
* @exampleResult Mozilla/5.0....
*/
Utils.getRandomPCUA = function () {
const PC_UA = [
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.5304.107 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.5249.119 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.81 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.134 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5089.1 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.24 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.4960.1 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4873.1 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.94 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4749.1 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0.4687.2 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4658.2 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4635.4 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4600.1 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/93.0.4573.1 Safari/537.36 Edge/43.0.2442.991",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4510.2 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4461.1 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4412.5 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4388.4 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.2272.101 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.218 Safari/537.36 Edge/13.10586",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4279.4 Safari/537.36 Edge/13.10586",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.2228.0 Safari/537.36",
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.3538.67 Safari/537.36",
];
return PC_UA[Math.floor(Math.random() * PC_UA.length)];
};