---
name: "onPageNotFound"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.10.0" }
title: "ty.onPageNotFound"
---

## onPageNotFound

> [VERSION] 基础库 >= 2.10.0

### 描述

监听小程序要打开的页面不存在事件。该事件与 App.onPageNotFound 的回调时机一致。

### 参数

`(callback: Function)`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `callback` | `(res: OnPageNotFoundCallbackResult) => void` | 是 | 小程序要打开的页面不存在事件的回调函数 |

### 返回值

无


### 引用对象

##### `interface` OnPageNotFoundCallbackResult

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `url` | `string` | 不存在页面的路径（代码包路径） |
| `query` | `Record<string, string>` | 打开不存在页面的 query 参数 |


### 示例代码

#### 监听页面不存在事件

```js
// app.js
App({
  onLaunch() {
    ty.onPageNotFound((res) => {
      console.log('页面不存在', res.url);
      ty.redirectTo({ url: '/pages/home/index' });
    });
  },
});
```