私藏的这些高级工具函数，你拥有几个?
↓推荐关注↓
前言
很多功能，其实内置的Web API已支持，
比如基于 URLSearchParams或者URL的queryString获取和生成比如基于 btoa,atob的base64的编码和解码比如基于 sendBeacon的数据上报比如基于 Array.from的序列生成比如基于 canvas的视频截图比如基于 URL的UUID生成
我们用精简的代码来实现相对复杂的功能，没有第三方库，你也能秀得飞起。
目录(方便移动端阅读)
localStorage的已使用空间 带图带事件的桌面通知 原生30行代码实现视频截图 基于 URLSearchParams获取queryString的值基于 atob和btoa的base64编码和解码非正则替换html代码encode和decode 相对地址转换为绝对地址 基于 URL或者Crypto.getRandomValues生成UUID基于 Array.from的序列生成器基于 sendBeacon的安全的数据上报基于 toLocaleString千分位Promise顺序执行 延时执行delay 进度值映射 滑滚动页面到顶部 禁止选择和复制 禁止图片拖拽 自增长ID
localStorage的已使用空间
在较新的chrome上测试，localStorage的存储是按照字符个数来算的。包含键和值的。
所以在测试代码中，你把a修改啊，不会影响存储的数量。但是键的长度，会影响存储的数量。
代码
function getLSUsedSpace() {
return Object.keys(localStorage).reduce((total, curKey) => {
if (!localStorage.hasOwnProperty(curKey)) {
return total;
}
total += localStorage[curKey].length + curKey.length;
return total;
}, 0)
}
示例
localStorage.clear();
localStorage.a = "啊";
console.log(getLSUsedSpace()); // 2
溢出测试：
key的值为长度为10的 kkkkkkkkkk:
输出结果：Max: 5242880 value Length: 5242870
当你把key修改长度为1的k:
输出结果：Max: 5242880 value Length: 5242879
localStorage.clear();
let valLength = 0
try {
let str = Array.from({ length: 5242800 }, () => "啊").join("");
valLength = str.length;
for (let i = 0; i < 10000000000000; i++) {
str += "a"
valLength += 1;
localStorage.setItem(`kkkkkkkkkk`, str);
}
} catch (err) {
console.error("存储失败", err);
console.log("Max:", getLSUsedSpace(), " value Length:", valLength)
}
注意
超过存储上线是会报错的：
如何捕获错误,可以参考 MDN testing\_for\_availability[1]
大致是对Error的错误码和name进行判断
e instanceof DOMException && (
// everything except Firefox
e.code === 22 ||
// Firefox
e.code === 1014 ||
// test name field too, because code might not be present
// everything except Firefox
e.name === 'QuotaExceededError' ||
// Firefox
e.name === 'NS_ERROR_DOM_QUOTA_REACHED') &&
// acknowledge QuotaExceededError only if there's something already stored
(storage && storage.length !== 0);
参考引用
calculating-usage-of-localstorage-space[2]
what-is-the-max-size-of-localstorage-values[3]
Test of localStorage limits/quota[4]
带图带事件的桌面通知
网页也可以以桌面弹框的形式进行通知，先看个效果图：
有头像，有标题，有文本，点击消息通知还能让窗体聚焦，真帅。
代码
function doNotify(title, options = {}, events = {}) {
const notification = new Notification(title, options);
for (let event in events) {
notification[event] = events[event];
}
}
function notify(title, options = {}, events = {}) {
if (!("Notification" in window)) {
return console.error("This browser does not support desktop notification");
}
else if (Notification.permission === "granted") {
doNotify(title, options, events);
} else if (Notification.permission !== "denied") {
Notification.requestPermission().then(function (permission) {
if (permission === "granted") {
doNotify(title, options, events);
}
});
}
}
示例
tag还可以用去重消息。
notify("中奖提示", {
icon: "https://sf1-ttcdn-tos.pstatp.com/img/user-avatar/f1a9f122e925aeef5e4534ff7f706729~300x300.image",
body: "恭喜你，掘金签到一等奖",
tag: "prize"
}, {
onclick(ev) {
console.log(ev);
ev.target.close();
window.focus();
}
})
参考引用
notification[5]
使用 Web Notifications[6]
原生30行代码实现视频截图
基本原理就是把视频画到Canvas里面，然后调用toDataURL或者toBlob，再利用a标签模拟点击，download属性指定名字。
看一下效果：
function captureVideo(videoEl) {
let canvasEl;
let dataUrl;
try {
const cps = window.getComputedStyle(videoEl);
const width = +cps.getPropertyValue("width").replace("px", "");
const height = +cps.getPropertyValue("height").replace("px", "");
canvasEl = document.createElement("canvas");
canvasEl.style.cssText = `position:fixed;left:-9999px`;
canvasEl.height = height;
canvasEl.width = width;
document.body.appendChild(canvasEl);
const ctx = canvasEl.getContext("2d");
ctx.drawImage(videoEl, 0, 0, width, height);
// const image = canvas.toDataURL("image/png");
dataUrl = canvasEl.toDataURL();
document.body.removeChild(canvasEl);
canvasEl = null;
return dataUrl;
} finally {
if (canvasEl) {
document.body.removeChild(canvasEl);
}
if (dataUrl) {
return dataUrl;
}
}
}
示例
注意添加crossorigin="anonymous"，不然转为图片会失败。
<video id="videoEL" controls autoplay crossorigin="anonymous"
src="https://api.dogecloud.com/player/get.mp4?vcode=5ac682e6f8231991&userId=17&ext=.mp4" width="500"></video>
function download(url) {
const aEl = document.createElement("a");
aEl.href = url;
aEl.download = "视频.png";
aEl.click();
}
function doCaptureVideo() {
const url = captureVideo(videoEL);
download(url);
}
doCaptureVideo()
基于URLSearchParams或URL获取queryString的值
常用的方式是使用正则或者split方法，其实不然，URLSearchParams和URL都能很好的实现功能。
代码
const urlSP = new URLSearchParams(location.search);
function getQueryString(key){
return urlSP.get(key)
}
const urlObj = new URL(location.href);
function getQueryString(key){
return urlObj.searchParams.get(key)
}
示例
测试地址： /index.html?pid=10
const log = console.log;
getQueryString
log("pid", getQueryString("pid")); // pid 10
log("cid", getQueryString("cid")); // cid null
参考引用
MDN文献：URLSearchParams-MDN[7]
CanIUse兼容性: URLSearchParams: 95.63\%[8]
Polyfill: url-search-params-polyfill[9]
基于atob和btoa的base64编码和解码
浏览器内置了base64编码和解码的能力，第三方库，不需要的。
代码
function utf8_to_b64( str ) {
return window.btoa(unescape(encodeURIComponent( str )));
}
function b64_to_utf8( str ) {
return decodeURIComponent(escape(window.atob( str )));
}
示例
utf8_to_b64('✓ à la mode'); // "4pyTIMOgIGxhIG1vZGU="
b64_to_utf8('4pyTIMOgIGxhIG1vZGU='); // "✓ à la mode"
参考引用
MDN文献：atob[10], btoa[11]
CanIUse兼容性: btoa 99.68\%[12]
Polyfill: MDN Polyfill[13]
Base64[14]
非正则替换的html代码encode和decode
常规的方式是使用正则替换，这里是另外一种思路。
代码
function htmlencode(s){
var div = document.createElement('div');
div.appendChild(document.createTextNode(s));
var result = div.innerHTML;
div = null;
return result;
}
function htmldecode(s){
var div = document.createElement('div');
div.innerHTML = s;
var result = div.innerText || div.textContent;
div = null;
return result;
}
示例
htmlencode("<div>3>5 & 666</div>"); // <div>3>5 & 666</div>
htmldecode("<div>3>5 & 666</div>") // <div>3>5 & 666</div>
相对地址转换为绝对地址
基于当前页面的相对地址转换为绝对地址。
代码
function realativeToAbs(href) {
let aEl = document.createElement("a");
aEl.href = href;
const result = aEl.href;
aEl = null;
return result;
}
示例
console.log("realativeToAbs", realativeToAbs("../a/b/b/index.html"));
// realativeToAbs http://127.0.0.1:5500/a/b/b/index.html
基于URL或者Crypto.getRandomValues生成UUID
基于URL.createObjectURL[15]或者Crypto.getRandomValues[16]
URL.createObjectURL 产生的地址为 blob:https://developer.mozilla.org/cb48b940-c625-400a-a393-176c3635020b, 其后部分就是一个UUID
代码
方式一：
function genUUID() {
const url = URL.createObjectURL(new Blob([]));
// const uuid = url.split("/").pop();
const uuid = url.substring(url.lastIndexOf('/')+ 1);
URL.revokeObjectURL(url);
return uuid;
}
genUUID() // cd205467-0120-47b0-9444-894736d873c7
方式二：
function uuidv4() {
return ([1e7]+-1e3+-4e3+-8e3+-1e11).replace(/[018]/g, c =>
(c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> c / 4).toString(16)
}
uuidv4() // 38aa1602-ba78-4368-9235-d8703cdb6037
参考引用
generating-uuids-at-scale-on-the-web-2877f529d2a2[17]
collisions-when-generating-uuids-in-javascript[18]
基于Array.from的序列生成器
造有序数据，无序数据，等等。
代码
const range = (start, stop, step) => Array.from(
{ length: (stop - start) / step + 1},
(_, i) => start + (i * step)
);
示例
range(0, 4, 1); // [0, 1, 2, 3, 4]
range(0, 9, 3); // [0, 3, 6, 9]
range(0, 8, 2.5) // [0, 2.5, 5, 7.5]
基于sendBeacon的安全的数据上报
sendBeacon[19] 异步地向服务器发送数据，同时不会延迟页面的卸载或影响下一导航的载入性能。
function report(url, data) {
if (typeof navigator.sendBeacon !== "function") {
return console.error("sendBeacon不被支持");
}
navigator.sendBeacon(url, data);
}
示例
window.addEventListener('unload', logData, false);
function logData() {
report("/log", "被卸载了");
}
基于toLocaleString千分位
正则？遍历？不需要的。内置函数就解决。
当然，如果是超大的数，可能是会有问题的。
代码
function formatMoney(num){
return (+num).toLocaleString("en-US");
}
示例
console.log(formatMoney(123456789)); // 123,456,789
console.log(formatMoney(6781)) // 6,781
console.log(formatMoney(5)) // 5
超大的数
formatMoney(19999999933333333333333) // 19,999,999,933,333,333,000,000
Promise顺序执行
让Promise顺序的执行，并支持初始化参数和结果作为参数传递。
代码
function runPromises(promiseCreators, initData) {
return promiseCreators
.reduce((promise, next) => promise
.then((data) => next(data))
, Promise.resolve(initData));
}
示例
var promise1 = function (data = 0) {
return new Promise(resolve => {
resolve(data + 1000);
});
}
var promise2 = function (data) {
return new Promise(resolve => {
resolve(data -500);
});
}
runPromises([promise1, promise2], 1).then(res=>console.log(res));
延时执行delay
延时执行某函数，且只会执行一次。
代码
function delay(fn = () => { }, delay = 5000, context = null) {
let ticket = null;
let runned = false;
return {
run(...args) {
return new Promise((resolve, reject) => {
if (runned === true) {
return;
}
runned = true;
ticket = setTimeout(async () => {
try {
const res = await fn.apply(context, args);
resolve(res);
} catch (err) {
reject(err)
}
}, delay)
})
},
cancel: () => {
clearTimeout(ticket);
}
}
}
示例
delay(function () {
console.log("你们好");
}).run();
const { run, cancel } = delay(function (name) {
console.log("你好：", name);
});
run("吉他");
run("吉他");
// 你们好
// 你好： 吉他
进度值映射
进度映射，比较只有 10%的进度，确要显示50%的进度的场景。
代码
function adjustProgress(progress: number, mapping: { real: number; target: number }[] = []) {
if (progress <= 0) {
return 0;
}
if (!mapping || mapping.length <= 0) {
return progress;
}
// 第一个
const f = mapping[0];
if (progress <= f.real) {
return progress * (f.target / f.real);
}
// 最后一个
const l = mapping[mapping.length - 1];
if (progress >= l.target) {
return l.target;
}
const curIndex = mapping.findIndex(m => m.real >= progress);
if (!curIndex) {
return progress;
}
const cur = mapping[curIndex];
const pre = mapping[curIndex - 1];
// 原基数 + 实际进度/最大实际进度 * 期望间距
return pre.target + (progress - pre.real) / (cur.real - pre.real) * (cur.target - pre.target);
}
示例
const mapping = [{
real: 0,
target: 0,
}, {
real: 30,
target: 50
}, {
real: 60,
target: 80
}, {
real: 100,
target: 100
}];
console.log("15", adjustProgress(15, mapping)); // 15 25
console.log("25", adjustProgress(25, mapping)); // 25 41.66666666666667
console.log("50", adjustProgress(50, mapping)); // 50 70
console.log("60", adjustProgress(60, mapping)); // 60 80
console.log("100", adjustProgress(100, mapping)); // 100 100
滑滚动页面到顶部
代码
PC端滚动的根元素是document.documentElement,
移动端滚动的的根元素是document.body,
有一个更好的属性document.scrollingElement能自己识别文档的滚动元素， 其在PC端等于document.documentElement, 其在移动端等于document.body
// smooth 选项在Safari上支持不好
function scrollToTop(){
window.scrollTo({
left: 0,
top: 0,
behavior: 'smooth
})
}
function scrollToTop() {
let scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
if (scrollTop > 0) {
window.requestAnimationFrame(scrollToTop);
window.scrollTo(0, scrollTop - scrollTop / 8);
}
};
禁止选择和复制
代码
['contextmenu', 'selectstart', 'copy'].forEach(function(ev){
document.addEventListener(ev, function(ev){
ev.preventDefault();
ev.returnValue = false;
})
});
当然也有CSS方案
body {
-moz-user-select: none;
-webkit-user-select: none;
-ms-user-select: none;
-khtml-user-select: none;
user-select: none;
}
禁止图片拖拽
代码
['dragstart'].forEach(function(ev){
document.addEventListener(ev, function(ev){
ev.preventDefault();
ev.returnValue = false;
})
});
自增长ID
自己生产自增长的ID值，当然可以更复杂一些。
代码
let id = 0;
function getId() {
return id++;
}
示例
console.log(getId()); // 1
console.log(getId()); // 2
参考资料
https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API#testing_for_availability
[2]https://stackoverflow.com/questions/3027142/calculating-usage-of-localstorage-space
[3]https://stackoverflow.com/questions/2989284/what-is-the-max-size-of-localstorage-values/25812530#25812530
[4]https://arty.name/localstorage.html
[5]https://developer.mozilla.org/zh-CN/docs/Web/API/notification
[6]https://developer.mozilla.org/zh-CN/docs/Web/API/Notifications_API/Using_the_Notifications_API
[7]https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams
[8]https://caniuse.com/?search=URLSearchParams
[9]https://github.com/jerrybendy/url-search-params-polyfill
[10]https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/atob
[11]https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/btoa
[12]https://caniuse.com/?search=btoa
[13]https://developer.mozilla.org/zh-CN/docs/Web/API/WindowOrWorkerGlobalScope/btoa#polyfill
[14]https://developer.mozilla.org/en-US/docs/Glossary/Base64
[15]https://developer.mozilla.org/zh-CN/docs/Web/API/URL/createObjectURL
[16]https://developer.mozilla.org/en-US/docs/Web/API/Crypto/getRandomValues
[17]https://medium.com/teads-engineering/generating-uuids-at-scale-on-the-web-2877f529d2a2
[18]https://stackoverflow.com/questions/6906916/collisions-when-generating-uuids-in-javascript
[19]https://developer.mozilla.org/zh-CN/docs/Web/API/Navigator/sendBeacon
作者：云的世界
https://juejin.cn/post/6987166546502090788
- EOF -
觉得本文对你有帮助？请分享给更多人
推荐关注「前端大全」，提升前端技能
点赞和在看就是最大的支持❤️