---
name: "Canvas.createImage"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "Canvas.createImage - 创建图片对象"
---

## Canvas.createImage

> [VERSION] 基础库 >= 2.21.8

### 描述

创建一个图片对象，用于绘制到 Canvas 上

### 参数

无


### 返回值

类型: `HTMLImageElement`

Image 图片对象

### 示例代码

#### 创建图片并绘制到画布

```js
const canvas = await this.instance.getCanvasById('myCanvas');
const ctx = canvas.getContext('2d');
const image = canvas.createImage();
image.src = 'https://example.com/image.png';
image.onload = () => {
  ctx.drawImage(image, 0, 0);
};
```