uni.navigateBack参数
时间: 2025-04-23 17:06:52 浏览: 26
### uni.navigateBack 方法参数说明
`uni.navigateBack` 是 UniApp 中用于关闭当前页面并返回上一页面的方法。此方法支持通过对象形式传递配置项来控制返回行为。
#### 参数详情
- `delta`: (Number 类型,默认值为 1) 表示要回退的页面数量,即可以指定向上几层的历史记录进行跳转[^1]。
```javascript
// 返回上一页
uni.navigateBack({
delta: 1,
});
```
- `success`: (Function 类型) 接口调用成功的回调函数,在成功执行导航操作之后触发。可以在该回调里处理一些逻辑,比如向其他页面发送事件通知等[^2]。
```javascript
uni.navigateBack({
delta: 1,
success() {
console.log('navigate back successfully');
// 发送自定义消息给监听者
uni.$emit('update', { msg: '页面更新' });
}
});
```
- `fail`: (Function 类型) 当接口调用失败时会触发这个回调函数,可用于捕获异常情况下的错误信息[^3]。
```javascript
uni.navigateBack({
delta: 1,
fail(err) {
console.error('navigation failed:', err);
}
});
```
- `complete`: (Function 类型) 不论成功与否都会被调用的回调函数,通常用来清理资源或重置状态。
```javascript
uni.navigateBack({
delta: 1,
complete() {
console.log('navigation completed');
}
});
```
除了上述基本功能外,还可以利用 `getCurrentPages()` 来获取当前页面栈的信息,并据此实现更复杂的交互模式,例如直接访问特定层次之前的页面实例并向其传递数据。
```javascript
let pages = getCurrentPages();
let prevPage = pages[pages.length - 2]; // 获取上一个页面实例
prevPage.$vm.getValue(someData); // 向上个页面传参
```
阅读全文
相关推荐


















