---
name: "Canvas.cancelAnimationFrame"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "Canvas.cancelAnimationFrame - 取消动画帧请求"
---

## Canvas.cancelAnimationFrame

> [VERSION] 基础库 >= 2.21.8

### 描述

取消由 requestAnimationFrame 添加到计划中的动画帧请求

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `requestId` | `number` | 是 | requestAnimationFrame 返回的请求 ID |

### 返回值

无


### 示例代码

#### 取消动画帧请求

```js
const canvas = await this.instance.getCanvasById('myCanvas');
const frameId = canvas.requestAnimationFrame(render);
// 停止动画
canvas.cancelAnimationFrame(frameId);
```
