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

## Canvas.createPath2D

> [VERSION] 基础库 >= 2.21.8

### 描述

创建一个 Path2D 对象，用于声明路径

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `path` | `string \| Path2D` | 否 | 可选的初始路径，可传入已有 Path2D 对象或 SVG 路径字符串 |

### 返回值

类型: `Path2D`

Path2D 路径对象

### 示例代码

#### 使用 Path2D 绘制图形

```js
const canvas = await this.instance.getCanvasById('myCanvas');
const ctx = canvas.getContext('2d');
const path = canvas.createPath2D();
path.rect(10, 10, 100, 100);
ctx.fill(path);
```