# uni.startPullDownRefresh(options?)

开始下拉刷新

# startPullDownRefresh 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
4.0	4.41	3.91	4.11	4.61

# 参数

名称	类型	必填	默认值	兼容性	描述
options	StartPullDownRefreshOptions	否	-	-
名称 类型 必备 默认值 兼容性 描述 success (result: AsyncApiSuccessResult) => void 否 - 接口调用成功的回调函数 fail (result: StartPullDownRefreshFail) => void 否 - 接口调用失败的回调函数 complete (result: AsyncApiResult) => void 否 - 接口调用结束的回调函数（调用成功、失败都会执行）

# StartPullDownRefreshFail 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	下拉刷新错误码 - 4: 框架内部异常
errSubject	string	是	-	-	统一错误主题（模块）名称
data	any	否	-	-	错误信息中包含的数据
cause	Error	否	-	-	源错误信息，可以包含多个错误，详见SourceError
errMsg	string	是	-	-	-

# AsyncApiResult 的属性值

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	-	-

# 返回值

类型	必备
Promise<AsyncApiSuccessResult>	否
名称 类型 必备 默认值 兼容性 描述 errMsg string 是 - - -

# 参见

• 相关 Bug
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

# uni.stopPullDownRefresh()

停止当前页面下拉刷新

# stopPullDownRefresh 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
4.0	4.41	3.91	4.11	4.61

使用：

1. 首先pages.json里配置了页面可下拉刷新"enablePullDownRefresh": true
2. 当用户下拉页面时触发页面生命周期onPullDownRefresh，iOS平台触发时机：当下拉到一定阀值就会触发onPullDownRefresh，并不是当手势拖拽结束时触发
3. 在合适的时机（如联网刷新数据结束），调用本APIuni.stopPullDownRefresh()，结束下拉刷新状态

本API仅负责页面下拉刷新。如使用组件下拉刷新，另见scroll-view、list-view等组件的文档。

# 参见

• 相关 Bug
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

# 通用类型

# GeneralCallbackResult

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-		错误信息