new Image

基础信息说明

功能概述：创建图片对象并加载图片资源，获取尺寸与加载结果

参数说明

image = new Image()

构造函数无参数，调用后同步返回图片对象。

返回值说明

new Image() 为同步构造，立即返回图片对象；设置 image.src 后的资源加载过程由异步事件驱动（onload/onerror）。

创建后返回 image 对象，常用属性与事件如下：

回调结果说明

• 触发时机：
• onload：图片资源成功加载后触发。
• onerror：加载过程中发生错误时触发。

回调成功
onload 成功形态

回调失败
onerror 失败形态

示例代码

// 创建并加载图片
const image = new Image()

image.onload = function () {
  console.log('图片加载完成', image.width, image.height)
}

image.onerror = function (err) {
  console.error('图片加载失败', err)
}

image.src = 'https://example.com/sprite.png'

注意事项

• 建议先设置 onload/onerror 回调，再设置 src，避免错过事件。
• width/height 在图片加载完成后才可靠，加载前值可能为 0。
• 当重复设置不同的 src 时，会触发新的加载流程与事件。
• 网络或跨域异常会导致 onerror 触发，请检查资源可用性与域名配置。