使用 promise 处理图片加载错误,核心做法是将原生 dom 的 image 对象封装为 new promise,在 onload 中 resolve 图片实例,在 onerror 中 reject 错误信息。这样可以将基于事件的异步操作转换为基于 promise 的链式调用,利用 .catch() 统一捕获并处理加载失败的情况。

new Promise 如何包装 Image 对象
通过构造函数创建 Promise 时,传入一个执行函数,该函数接收 resolve 和 reject 两个参数。在函数内部实例化 Image,分别绑定 onload 和 onerror 事件。当图片成功加载时调用 resolve(img),将图片对象传递给后续处理器;当加载失败或发生网络错误时调用 reject(error),触发异常流。

function loadImage(src) {
return new Promise((resolve, reject) => {
const img = new Image();
img.onload = () => resolve(img);
img.onerror = (err) => reject(new Error('Failed to load image: ' + src));
img.src = src;
});
}
上述代码定义了一个通用的 loadImage 函数。调用时传入图片 URL,返回一个 Promise 对象。如果图片存在且可访问,onload 触发,Promise 变为 fulfilled 状态;如果路径错误或服务器无响应,onerror 触发,Promise 变为 rejected 状态。
如何使用 .catch() 处理加载失败
在获取到 loadImage 返回的 Promise 后,可以使用 .then() 处理成功情况,并使用 .catch() 处理失败情况。.catch() 接收一个回调函数,参数为拒绝原因(即 reject 抛出的错误对象)。在回调中可以执行降级逻辑,如显示默认占位图、记录日志或重试。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

loadImage('/path/to/image.png')
.then(img => {
document.body.appendChild(img);
})
.catch(err => {
console.error(err.message);
// 显示默认图片
const fallback = new Image();
fallback.src = '/path/to/fallback.png';
document.body.appendChild(fallback);
});
这段代码展示了完整的调用流程。如果 /path/to/image.png 加载失败,.catch() 中的逻辑会被执行,控制台输出错误信息,并插入一张备用图片。这种结构避免了嵌套回调,使错误处理逻辑扁平化。
如何处理并发多张图片加载中的单个错误
当需要同时加载多张图片时,可以使用 Promise.allSettled()。它等待所有 Promise 完成,无论成功或失败,都会返回一个结果数组。每个结果对象包含 status 属性,值为 'fulfilled' 或 'rejected',以及对应的 value 或 reason。这允许程序区分哪些图片加载成功,哪些失败,从而进行差异化处理,而不会因为单张失败导致整体流程中断。
const urls = ['/img1.png', '/img2.png', '/img3.png'];
Promise.allSettled(urls.map(loadImage))
.then(results => {
results.forEach((result, index) => {
if (result.status === 'fulfilled') {
document.body.appendChild(result.value);
} else {
console.warn(`Image ${index} failed:`, result.reason);
}
});
});
此示例遍历图片 URL 列表,对每个 URL 调用 loadImage。Promise.allSettled 确保即使某张图片加载失败,其他图片的处理逻辑仍能继续执行。通过检查 result.status,可以精确控制成功和失败分支的行为。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










