  管理后台基于[Ant Design Pro](https://pro.ant.design/zh-CN/)搭建，组件库是[Ant Design 5.20](https://ant-design.antgroup.com/components/overview-cn)，本文会对糟糕的性能和用户体验进行多轮优化。
## 一、存在的问题
  核心就是上传的图像数量庞大，公司的网络速度慢，被全国94%的网络用户超越。
:-: 
**1）预览图显示慢**
:-: 
:-: 
**2）图像请求失败**
  上传组件预览图请求失败图裂。
:-: 
点击上传组件中的预览按钮，在大图预览时的可拖动区域的小图，也会请求失败图裂
:-: 
**3）上传时间长**
  上传时间长，页面意外关闭需重新上传。
:-: 
  接下来会记录优化的整个过程，其中不乏一些失败的优化手段，我都做了一一记录。
  性能优化的核心是降低图像尺寸，分批次请求等，体验优化的核心是增加反馈交互，续传文件等。
## 二、预览小图优化
  首先让运营做了一个人工的前置优化。
  原始图先让摄影师自行压缩一遍，从 4.5M 压缩到 1.5M，总容量从 2.19G 缩小到 466M。
**1）质量变换**
  为预览小图增加[质量变换](https://developer.qiniu.com/dora/8259/the-quality-of-transformation)（公司购买了七牛云的服务），经过调试，选择 3p 的图片质量。
~~~
https://static.xxx.com/activity/review/1746525272362kzrjtd.jpg
~~~
:-: 
~~~
https://static.xxx.com/activity/review/1746525272362kzrjtd.jpg?imageMogr2/thumbnail/!5p
~~~
:-: 
~~~
https://static.xxx.com/activity/review/1746525272362kzrjtd.jpg?imageMogr2/thumbnail/!3p
~~~
:-: 
  三次请求的图像尺寸缩小了 538 倍，请求效率提升了不少。
:-: 
**2）批量预请求**
  另一个优化举措是在上传之前先用脚本批量（10个一组）去请求压缩裁剪后的图。
  在全部请求完成后才呈现上传区域。
~~~
useEffect(() => {
// 预加载图像
const imageLoader = new BatchImageLoader({ batchSize: 10 });
const imageUrls = current.reviews ? current.reviews.map(url => scaleImg(url)) : [];
// 批量加载
imageUrls.length > 0 && imageLoader.loadImagesBatch(imageUrls)
.then((results: ImageLoadResult[]) => {
setImgLoading(false); // 关闭加载中的状态
})
.catch((error: Error) => {
console.error('批量加载失败:', error);
});
return () => {
imageLoader.clearPendingRequests(); //销毁请求
setImgLoading(true); // 开启加载中的状态
}
}, [current])
~~~
:-: 
**3）骨架屏**
  还给 Modal 组件赋值 loading 属性（5.18.0新增），出现骨架屏效果。
:-: 
  不过，在骨架屏消失后，本来以为预请求了一次，不会再访问出错，结果还是会有一定概率出错。
  公司网络比较慢，很容易复现此类问题。
:-: 
**4）3次重复请求**
  并且从上传区域的预加载，到加载组件内的预览图，再到拖动区域的小图，总共进行了 3 次请求，太冗余。
:-: 
  上述优化，除了质量参数达到了优化的效果，其余没有达到预期，遂放弃。
## 三、自定义上传列表项
**1）懒加载**
  Upload 组件的默认行为，是会加载组件内的所有预览图，所以需要自定义上传列表项（itemRender），做懒加载优化。
~~~
const itemRender = (originNode: React.ReactElement, file: UploadFile, fileList:UploadFile[], actions: {
download: () => void;
preview: () => void;
remove: () => void;
}) => {
return (
<div className="ant-upload-list-item-container">
<div className="ant-upload-list-item ant-upload-list-item-done">
{file.status === 'uploading' ? (
<div style={{width: '100%', textAlign:'center'}}>
文件上传中<Progress percent={file.percent} showInfo={false} size="small" strokeWidth={2}/>
</div>
) :
<span className="ant-upload-list-item-thumbnail">
<img
src={file.thumbUrl}
alt={file.name}
className="ant-upload-list-item-image"
loading='lazy'
onError={e => onImgError(e, file.thumbUrl)}
/>
</span>
}
<div className="ant-upload-list-item-actions">
{/* 预览按钮 */}
<a onClick={actions.preview}>
<EyeOutlined />
</a>
{/* 删除按钮 */}
<a onClick={actions.remove}>
<DeleteOutlined />
</a>
</div>
</div>
</div>
);
}
~~~
  自定义的列表项与默认的列表项在行为和样式上保持了高度的一致。
  但是为 img 增加了 loading 懒加载属性。
* loading="lazy" 告诉浏览器，在用户滚动至图片附近时才开始加载图片。
* loading="eager"（这是默认值）则指示浏览器在页面加载时立即加载所有图片。
  经过调试发现，300个图像请求，默认会先请求100个左右。
:-: 
  尽管如此，还是会有小概率的情况出现图裂。
**2）重加载一次**
  为此，在图像请求错误时，增加一次重新加载的机制，而可拖动区域的小图也要加上此机制。
~~~
// 预览图像发生错误时的事件 data-retried
const onImgError = (e:SyntheticEvent, src:string|undefined) => {
const img = e.target as HTMLImageElement;
// 只重新加载一次
if (!img.dataset.retried) {
img.dataset.retried = 'true';
src && (img.src = src);
console.error('重新加载', src);
}
}
~~~
## 四、可拖动区域
:-: 
**1）网络错误**
  拖动区域的小图裂掉主要是因为上传区域的图裂了导致，两者的地址是相同的。
  得到了图裂时候的错误信息。
~~~
https://static.xxx.com/activity/review/1757929803424ukyomp.jpg?imageMogr2/thumbnail/!3p net::ERR_HTTP2_PROTOCOL_ERROR 200 (OK)
~~~
  在客户端（你的浏览器）和服务器之间的 HTTP/2 通信过程中，发生了某种违反协议规则的事情，导致连接被中止。
  查看 Chrome Net Logs （网络日志），它可以记录所有网络活动。
1. 在 Chrome 地址栏输入 chrome://net-export/。
2. 点击 "Start Logging to Disk" 并保存一个文件。
3. 在浏览器中复现这个错误。
4. 返回 chrome://net-export/ 点击 "Stop Logging"。
5. 将日志文件上传到 https://netlog-viewer.appspot.com 进行分析。搜索 ERR\_HTTP2\_PROTOCOL\_ERROR，可以看到更详细的错误上下文。
  上述操作完成后，并没有得到具体的错误信息，可能是日志文件还没有全部导出。
**2）懒加载**
  但是在拖动区域，也增加了 loading 属性，有时候即使组件内的预览图没有显示，此处也能正确显示。
~~~html
<img src={item.thumbUrl} loading='lazy' />
~~~
:-: 
**3）选中效果**
  还增加了一处体验优化，即为当前预览小图增加选中效果，就是增加个 2px 的边框。
  宽高也设置了一下，还用到了CSS中的[object-fit](https://developer.mozilla.org/zh-CN/docs/Web/CSS/object-fit)属性。
* cover：用于被替换的内容在保持其宽高比的同时，填充元素的整个内容框。
* contain：用于被替换的内容将被缩放，以在填充元素的内容框时保持其宽高比。
  选取关键字 cover，将图像能够等比缩放的填充满整个内容区域。
~~~css
{
width:'100%';
height: 45;
object-fit: 'cover';
border: 2px solid #a0d911;
}
~~~
:-: 
## 五、预览大图
**1）禁止打开预览弹框**
  预览弹框有一处体验优化，就是当上传组件还有文件在上传中时，禁止打开预览弹框。
  避免在弹框的拖动区域，修改图像顺序时发生异常
:-: 
在预览弹框中，调节大图尺寸，并且为其配置 objectFit 属性，将图像能够等比缩放的填充到内容区域。
~~~html
<img
style={{ width: '100%', height: '60vh', marginTop: 5, objectFit: 'contain' }}
src='https://static.allreaday.com/xxx.jpg'
alt="预览图"
/>
~~~
:-: 
**2）loading切换**
  由于在切换预览时的加载时间较长（公司网络较差），于是增加了 loading 加载的过渡动画。
:-: 
  后续，也为大图增加了质量变换，值为 50p，确保肉眼看的时候能保持清晰度和色彩度。
~~~
https://static.xxx.com/xxx.jpg?imageMogr2/thumbnail/!50p
~~~
## 六、缓存上传文件
**1）localStorage**
  在上传按钮旁增加恢复最近数据的按钮，每次上传时会将文件列表缓存到 localStorage 中
:-: 
  在 Upload 组件的 onChange 事件中，增加缓存的配置，并且为上传组件增加 isCache 属性控制是否开启缓存。
~~~
const onChange = (data: UploadChangeParam) => {
const { fileList } = data;
// ...
isCache && setUploadImageCache(fileList);
// ...
}
/**
* 缓存上传文件
*/
export function setUploadImageCache(data:UploadFile[]) {
localStorage.setItem('upload_image', JSON.stringify(data));
}
~~~
**2）续传失败**
  本来将 uploading 也存储到了缓存中，并且在更新状态时，组件也显示了上传中的样式，但是无法续传。
  可能是没有 file 对象，即没有文件信息导致无法上传。
  目前就暂时无法给上传中的文件实现断点续传，所以只能先把文件名给列出来。
:-: 
  在警告框中提供了复制按钮（用OR分隔的名称），点击复制后，找到对应的文件夹（macOS），选中搜索。
:-: 
  将得到的查询条件复制到搜索框中，就能得到还未上传的图像。
:-: 
**3）存储溢出**
  当上传300多张图像时，页面报错了。意思就是存储超过最大阈值，localStorage 最大是 5M~10M。
~~~
QuotaExceededError: Failed to execute 'setItem' on 'Storage': Setting the value of 'upload_image' exceeded the quota.
~~~
  尝试采用数据压缩，但仍然会报错，只能另辟蹊径。
~~~
/**
* 缓存上传文件
*/
export function setUploadImageCache(data:UploadFile[]) {
// 压缩数据
const compress = btoa(encodeURIComponent(JSON.stringify(data)));
localStorage.setItem('upload_image', compress);
}
/**
* 读取上传文件的缓存
*/
export function getUploadImageCache() {
const files = localStorage.getItem('upload_image');
if(!files) return [];
// 解压数据
const uncompress = decodeURIComponent(atob(files));
return JSON.parse(uncompress);
}
~~~
**4）IndexedDB**
  将数据缓存到 IndexedDB 中，理论上它可以占用 50% 的磁盘空间，所以不存在溢出的问题。
~~~
/**
* 存储数据（支持大型数据）
* @param key 键名
* @param value 要存储的值（可为任意类型）
*/
async setItem(key: string, value: any): Promise<void> {
if (!this.db) await this.init();
return new Promise<void>((resolve, reject) => {
const transaction = this.db!.transaction(['largeData'], 'readwrite');
const store = transaction.objectStore('largeData');
const item: StoredItem = { key, value, timestamp: Date.now() };
const request: IDBRequest = store.put(item);
request.onsuccess = () => resolve();
request.onerror = () => {
console.error('存储数据失败:', request.error);
reject(request.error);
};
});
}
/**
* 获取存储的数据
* @param key 键名
* @returns 存储的值，若不存在则返回 null
*/
async getItem(key: string): Promise<any> {
if (!this.db) await this.init();
return new Promise<any>((resolve, reject) => {
const transaction = this.db!.transaction(['largeData'], 'readonly');
const store = transaction.objectStore('largeData');
const request: IDBRequest = store.get(key);
request.onsuccess = () => {
const result = request.result as StoredItem | undefined;
resolve(result ? result.value : null);
};
request.onerror = () => {
console.error('获取数据失败:', request.error);
reject(request.error);
};
});
}
~~~
  为了能自动清理 IndexedDB 的数据，在组件中上传文件时，触发清理的操作，下面查看占用空间的代码。
~~~
const quota = await navigator.storage.estimate();
console.log(`已用空间: ${quota.usage} 字节`);
console.log(`总配额: ${quota.quota} 字节`);
const percentageUsed = (quota.usage / quota.quota) * 100;
console.log(`已使用可用存储的 ${percentageUsed}%`);
~~~
  现在即使缓存了 300 多张图像，也能实现恢复。
## 七、上传反馈
**1）不友好的等待**
  当需要上传几百张图时，在选好图像后，组件就会有比较长的时间没有状态变化。
:-: 
  不给用户反馈，体验很不友好。需要在合适的时机更新上传区域的 loading 状态。
:-: 
**2）自定义上传按钮**
  没有找到合适的事件，就想自定义上传按钮，然后控制按钮的点击事件，以此来更新状态。
  Upload 组件只要在子元素位置增加按钮元素就能替换默认的上传按钮。
~~~html
<Upload {...props}>
<Button icon={<UploadOutlined />}>Click to Upload</Button>
</Upload>
~~~
  但是在 Ant Design Pro 中的 ProFormUploadButton 组件内，并不能覆盖上传按钮。
  除非自定义 ProFormUploadButton 组件的逻辑，但开发成本较高。
**3）点击事件**
  首先想到的是在 ProFormUploadButton 外增加个容器元素，注册点击事件，通过冒泡的方式触发。
~~~html
<div onClick={}>
<ProFormUploadButton />
</div>
~~~
  但这样的话，点击范围会比较大，并不局限于上传按钮，而是整个区域都会冒泡触发。
  然后想到的是直接给生成的 input\[type=file\] 控件注册点击事件。
~~~
document.getElementById(name)?.addEventListener('click', () => {
setUploadAreaLoading(true);
});
~~~
  组件的属性 name 会渲染成 input 按钮的 id 属性。
  在 onChange 事件中调用 setUploadAreaLoading(false) 取消 loading 状态。
**4）取消文件选择**
  但会有一个问题，就是在弹出的选择文件框中，不选择文件，点击取消，那么就不能触发 onChange 事件。
  针对取消按钮，浏览器也没有提供专门的事件。
:-: 
  虽然为 window 注册 focus 事件，能够实现在点击取消时触发事件。
~~~
window.addEventListener('focus', function() {
const fileInput = document.getElementById(name) as HTMLInputElement;
console.log(fileInput && fileInput.files)
});
~~~
  但是无法准确读取 fileList 列表，当文件少的时候，fileList 会马上更新。
  但是当文件几百个时，在触发 focus 事件时，fileList 仍然是空的。
  而我优化的目的就是要在加载这些文件的过程中，出现 loading 过渡动画，如此就无法判断了。
  为 file 控件注册 change 事件的确能马上拿到 files 列表。
~~~
document.getElementById(name)?.addEventListener('change', (e) => {
const fileInput = e.target as HTMLInputElement;
if(!fileInput) return;
const files = fileInput.files;
console.log('change', files);
if(files && files.length > 0) {
setUploadAreaLoading(true);
}
// fileInput.value = ''; //清空已选文件
});
~~~
  但是在 Upload 组件中，再次上传时，却无法触发 file 控件 change 事件。
  即使在 Upload 组件内清空文件的值，也无法再次触发事件，很奇怪。
  后面发现原来上传控件（input\[type=file\]）在上传完成后会被删除，之前注册的事件就没有了。
~~~html
<span class="ant-upload">
<input id="reviews" type="file" accept="image/*" multiple="" style="display: none;">
</span>
~~~
~~  需要自定义 Upload 组件的上传区域，暂时不修改。~~
~~  先与业务方同步，告知他们开启缓存的上传组件会有取消弹框无法自动移除 loading 的问题。~~
**5）事件委托**
  既然不能指定控件绑定事件，那么可以借用委托，给容器元素注册事件。
  如果用 DOM 的方式查找容器，像下面这样，那么当页面中有多个上传组件时，就会给所有的容器都注册事件。
~~~
document.getElementsByClassName('ant-upload-select')
~~~
  而 Upload 提供了 ref，可以通过该属性注册特定组件内的容器。
~~~
const fileContainer = uploadRef.current?.nativeElement;
const onClick = (e:Event) => {
const fileInput = e.target as HTMLInputElement;
// 拦截非上传控件的点击事件
if(!fileInput || fileInput.id !== name) {
return;
}
/**
* 在上传区域开启加载状态
* 因为当上传几百张图时，整个界面就会卡住，不给用户反馈
*/
setUploadAreaLoading(true);
};
fileContainer?.addEventListener('click', onClick, false);
~~~
  同样用委托的方式为 file 控件增加 change 事件，当有文件时，更新 loading 状态。
~~~
const onChange = (e:Event) => {
const fileInput = e.target as HTMLInputElement;
// 拦截非上传控件的点击事件
if(!fileInput || fileInput.id !== name) {
return;
}
const files = fileInput.files;
if(files && files.length > 0) {
setUploadAreaLoading(true);
}
};
fileContainer?.addEventListener('change', onChange, false);
~~~
  这样就能实现在选中文件后，组件显示 loading 等待状态，取消选择框，也能关闭等待状态。
*****
> 原文出处：
[博客园-Web优化躬行记](https://www.cnblogs.com/strick/category/1795726.html)
[知乎专栏-Web优化躬行记](https://zhuanlan.zhihu.com/c_1260996761008627712)
已建立一个微信前端交流群，如要进群，请先加微信号freedom20180706或扫描下面的二维码，请求中需注明“看云加群”，在通过请求后就会把你拉进来。还搜集整理了一套[面试资料](https://github.com/pwstrick/daily)，欢迎阅读。
推荐一款前端监控脚本：[shin-monitor](https://github.com/pwstrick/shin-monitor)，不仅能监控前端的错误、通信、打印等行为，还能计算各类性能参数，包括 FMP、LCP、FP 等。
- ES6
- 1、let和const
- 2、扩展运算符和剩余参数
- 3、解构
- 4、模板字面量
- 5、对象字面量的扩展
- 6、Symbol
- 7、代码模块化
- 8、数字
- 9、字符串
- 10、正则表达式
- 11、对象
- 12、数组
- 13、类型化数组
- 14、函数
- 15、箭头函数和尾调用优化
- 16、Set
- 17、Map
- 18、迭代器
- 19、生成器
- 20、类
- 21、类的继承
- 22、Promise
- 23、Promise的静态方法和应用
- 24、代理和反射
- HTML
- 1、SVG
- 2、WebRTC基础实践
- 3、WebRTC视频通话
- 4、Web音视频基础
- CSS进阶
- 1、CSS基础拾遗
- 2、伪类和伪元素
- 3、CSS属性拾遗
- 4、浮动形状
- 5、渐变
- 6、滤镜
- 7、合成
- 8、裁剪和遮罩
- 9、网格布局
- 10、CSS方法论
- 11、管理后台响应式改造
- React
- 1、函数式编程
- 2、JSX
- 3、组件
- 4、生命周期
- 5、React和DOM
- 6、事件
- 7、表单
- 8、样式
- 9、组件通信
- 10、高阶组件
- 11、Redux基础
- 12、Redux中间件
- 13、React Router
- 14、测试框架
- 15、React Hooks
- 16、React源码分析
- 利器
- 1、npm
- 2、Babel
- 3、webpack基础
- 4、webpack进阶
- 5、Git
- 6、Fiddler
- 7、自制脚手架
- 8、VSCode插件研发
- 9、WebView中的页面调试方法
- Vue.js
- 1、数据绑定
- 2、指令
- 3、样式和表单
- 4、组件
- 5、组件通信
- 6、内容分发
- 7、渲染函数和JSX
- 8、Vue Router
- 9、Vuex
- TypeScript
- 1、数据类型
- 2、接口
- 3、类
- 4、泛型
- 5、类型兼容性
- 6、高级类型
- 7、命名空间
- 8、装饰器
- Node.js
- 1、Buffer、流和EventEmitter
- 2、文件系统和网络
- 3、命令行工具
- 4、自建前端监控系统
- 5、定时任务的调试
- 6、自制短链系统
- 7、定时任务的进化史
- 8、通用接口
- 9、微前端实践
- 10、接口日志查询
- 11、E2E测试
- 12、BFF
- 13、MySQL归档
- 14、压力测试
- 15、活动规则引擎
- 16、活动配置化
- 17、UmiJS版本升级
- 18、半吊子的可视化搭建系统
- 19、KOA源码分析（上）
- 20、KOA源码分析（下）
- 21、花10分钟入门Node.js
- 22、Node环境升级日志
- 23、Worker threads
- 24、低代码
- 25、Web自动化测试
- 26、接口拦截和页面回放实验
- 27、接口管理
- 28、Cypress自动化测试实践
- 29、基于Electron的开播助手
- 30、SkyWalking使用和排查分析
- 31、IP白名单变迁史
- Node.js精进
- 1、模块化
- 2、异步编程
- 3、流
- 4、事件触发器
- 5、HTTP
- 6、文件
- 7、日志
- 8、错误处理
- 9、性能监控（上）
- 10、性能监控（下）
- 11、Socket.IO
- 12、ElasticSearch
- 监控系统
- 1、SDK
- 2、存储和分析
- 3、性能监控
- 4、内存泄漏
- 5、小程序
- 6、较长的白屏时间
- 7、页面奔溃
- 8、shin-monitor源码分析
- 前端性能精进
- 1、优化方法论之测量
- 2、优化方法论之分析
- 3、浏览器之图像
- 4、浏览器之呈现
- 5、浏览器之JavaScript
- 6、网络
- 7、构建
- 前端体验优化
- 1、概述
- 2、基建
- 3、后端
- 4、数据
- 5、后台
- Web优化
- 1、CSS优化
- 2、JavaScript优化
- 3、图像和网络
- 4、用户体验和工具
- 5、网站优化
- 6、优化闭环实践
- 7、后台上传大批量图优化
- 数据结构与算法
- 1、链表
- 2、栈、队列、散列表和位运算
- 3、二叉树
- 4、二分查找
- 5、回溯算法
- 6、贪心算法
- 7、分治算法
- 8、动态规划
- 程序员之路
- 大学
- 2011年
- 2012年
- 2013年
- 2014年
- 项目反思
- 前端基础学习分享
- 2015年
- 再一次项目反思
- 然并卵
- PC网站CSS分享
- 2016年
- 制造自己的榫卯
- PrimusUI
- 2017年
- 工匠精神
- 2018年
- 2019年
- 前端学习之路分享
- 2020年
- 2021年
- 2022年
- 2023年
- 2024年
- 日志
- 2020