# wx.onPageNotFound(function listener)

基础库 2.1.2 开始支持,低版本需做兼容处理

小程序插件:不支持

微信 HarmonyOS 版:支持

# 功能描述

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

# 参数

# function listener

小程序要打开的页面不存在事件的监听函数

# 参数

# Object res
属性 类型 说明
path string 不存在页面的路径 (代码包路径)
query Record.<string, string> 打开不存在页面的 query 参数
isEntryPage boolean 是否本次启动的首个页面(例如从分享等入口进来,首个页面是开发者配置的分享页面)

# 注意

  • 开发者可以在回调中进行页面重定向,但必须在回调中同步处理,异步处理(例如 setTimeout 异步执行)无效。
  • 若开发者没有调用 wx.onPageNotFound 绑定监听,也没有声明 App.onPageNotFound,当跳转页面不存在时,将推入微信客户端原生的页面不存在提示页面。
  • 如果回调中又重定向到另一个不存在的页面,将推入微信客户端原生的页面不存在提示页面,并且不再第二次回调。