news 2026/6/23 19:13:13

uni-app x封装request,统一API接口请求

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
uni-app x封装request,统一API接口请求

config.baseURL = 'https://api.example.com' // api地址

config.timeout = 8000 // 单位毫秒,对应8秒

config.loadingText = '加载中...'

config.loading = true // 开启 loading 动画

return config

})

/* 2. 请求拦截 */

http.interceptors.request.use((config) => {

const token = uni.getStorageSync('token')

if (token) config.header.Authorization = `Bearer ${token}`

return config

})

/* 3. 响应拦截 */

http.interceptors.response.use(

(response) => response.data,

(err) => {

// 🔥 强制断言,让 UTS 闭嘴

(uni as any).$u.toast(err.message || '网络错误')

return Promise.reject(err)

}

)

export default http

复制代码

修改 main.uts,引入 request,并挂载为全局属性$http

复制代码

import App from './App.uvue'

import { createSSRApp } from 'vue'

import uviewPlus from 'uview-plus'

/* 1. 引入 request(里面已经初始化好 http) */

import http from '@/utils/request'

export function createApp() {

const app = createSSRApp(App)

/* 2. 挂到全局属性 */

app.config.globalProperties.$http = http

app.use(uviewPlus)

return {

app

}

}

复制代码

三、使用request

由于在main.uts挂载了全局属性,因此在pages里面的uvue文件,就可以直接调用了。比如:

get请求

const res = await this.$http.get('/test', {})

post请求

const res = await this.$http.post('/login', {

username: 'admin',

password: 123456

})

post请求,增加成功和失败处理

复制代码

async login() {

try {

/* === 成功分支 === */

const res = await this.$http.post('/login', {

username: 'admin',

password: '123456'

})

// 这里只写“成功后的业务”

uni.setStorageSync('token', res.token)

this.$u.toast('登录成功')

uni.switchTab({ url: '/pages/index/index' })

} catch (err: any) {

/* === 失败分支 === */

// 拦截器已弹通用提示,这里可做“额外”处理

console.error('登录失败', err)

if (err.statusCode === 401) {

this.$u.toast('账号或密码错误')

}

}

}

复制代码

post请求,局部请求不想显示 loading

await this.$http.post('/log', data, { loading: false })

uview-plus 的 http 模块已经内置了 “请求开始自动显示 loading,响应结束自动隐藏” 的机制,

你只需要 把 loading 开关打开 即可,成功/失败/超时都会 统一自动关闭,无需手动处理。

效果:

调用 this.$http.get/post 瞬间 → 出现 uview-plus 的 loading 遮罩

请求 成功/失败/超时 → 遮罩 自动消失(由 uview 内部 finally 关闭)

无需自己 uni.showLoading() / uni.hideLoading()

post请求,增加header

复制代码

await this.$http.post('/upload', body, {

header: {

'Content-Type': 'application/x-wwwz-form-urlencoded',

'X-Custom': 'abc123'

}

})

复制代码

put请求

const res = await this.$http.put('/test', {id:1})

delete请求

const res = await this.$http.delete('/test', {id:1})

四、登录页面

login.uvue

复制代码

<template>

<view class="">

<!-- 导航栏 -->

<u-navbar title="用户登录" />

<!-- 内容区 -->

<view class="content">

<!-- 头像 -->

<u-avatar :src="logo" size="80"></u-avatar>

<!-- 表单 -->

<u--form :model="form" labelPosition="left">

<u--input v-model="form.username" placeholder="请输入用户名" prefixIcon="account" />

<u--input v-model="form.password" placeholder="请输入密码" type="password" prefixIcon="lock" />

</u--form>

<!-- 按钮 -->

<u-button text="登录" type="primary" @click="login" />

<!-- 链接 -->

<view class="links">

<u-cell title="忘记密码?" isLink @click="gotoForget" />

<u-cell title="注册账号" isLink @click="gotoRegister" />

</view>

</view>

</view>

</template>

<script>

export default {

data() {

return {

title: 'Hello',

logo: '/static/logo.png',

form: {

username: '',

password: '',

}

}

},

onLoad() {

},

methods: {

async login() {

if (!this.form.username) {

uni.showToast({ title: '请输入用户名', icon: 'none' })

return

}

// 请求登录接口

try {

/* === 成功分支 === */

const res = await this.$http.post('/login', {

username: this.form.username,

password: this.form.password

})

// 这里只写“成功后的业务”

uni.setStorageSync('token', res.token)

this.$u.toast('登录成功')

uni.switchTab({ url: '/pages/index/index' })

} catch (err : any) {

/* === 失败分支 === */

// 拦截器已弹通用提示,这里可做“额外”处理

console.error('登录失败', err)

if (err.statusCode === 401) {

this.$u.toast('账号或密码错误')

}

this.$u.toast('网络请求异常')

}

},

gotoForget() {

uni.navigateTo({ url: '/pages/forget/index' })

},

gotoRegister() {

uni.navigateTo({ url: '/pages/register/index' })

}

}

}

</script>

<style scoped>

.content {

padding: 40rpx;

display: flex;

flex-direction: column;

align-items: center;

}

.links {

margin-top: 30rpx;

width: 100%;

}

</style>

复制代码

效果如下:

image

针对大型项目,可以在utils里面新建一个api.ts,用来编写一些公用业务函数,例如:

复制代码

import http from './request.js'

/* 登录 */

export const login = (username, pwd) =>

http.post('/login', { username, pwd })

/* 轮播图 */

export const getBanner = () =>

http.get('/banner')

/* 商品列表 */

export const getGoods = (params) =>

http.get('/goods', { params })

复制代码

然后在pages里面的页面,就可以调用了,无需重复写函数。

复制代码

<script>

import { getBanner } from '@/utils/api.ts'

export default {

data() {

return {

title: 'Hello',

bannerList: [],

}

},

onLoad() {

this.getbannerList()

},

methods: {

async getbannerList() {

/* 直接调用 */

this.bannerList = await getBanner()

},

}

}

</script>

复制代码

注意:直接调用,要用异步,函数名前面加async

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/23 19:10:19

4大维度解析DeepLX与官方API:技术实战与成本效益终极评测

4大维度解析DeepLX与官方API&#xff1a;技术实战与成本效益终极评测 【免费下载链接】DeepLX DeepL Free API (No TOKEN required) 项目地址: https://gitcode.com/gh_mirrors/de/DeepLX 在机器翻译领域&#xff0c;DeepL以其卓越的翻译质量广受好评&#xff0c;但其官…

作者头像 李华
网站建设 2026/6/23 21:00:51

本地 AI 服务难共享?TRAE SOLO+cpolar 轻松打破局域网枷锁

引言&#xff1a;AI时代&#xff0c;你还在为“内网”所困吗&#xff1f; TRAE SOLO 是一款集成 AI 能力的开发工具&#xff0c;能理解开发需求、拆解任务并调用工具完成编码、调试等工作&#xff0c;适合 AI 开发者、程序员等群体。其 SOLO 模式可自主推进开发流程&#xff0…

作者头像 李华
网站建设 2026/6/23 21:04:03

助力金融信创与云原生转型,DeepFlow 排障智能体和可观测性建设实践

摘要&#xff1a;本文介绍了某金融机构在信创改造与云原生演进过程中&#xff0c;面临全栈可观测性数据复杂、性能瓶颈定位困难、系统扩展性不足等挑战&#xff0c;通过引入 DeepFlow 可观测性分析平台&#xff0c;构建统一采集、全栈国产化适配、函数级性能剖析与智能分析于一…

作者头像 李华
网站建设 2026/6/23 17:49:09

靠谱的模板网站建设哪家好

靠谱的模板网站建设哪家好&#xff1f;深度解析与选择指南在数字化转型浪潮中&#xff0c;一个专业、可靠的网站是企业线上营销的基石。对于许多寻求快速上线、控制成本的生产型企业而言&#xff0c;选择一家提供靠谱模板网站建设的服务商&#xff0c;成为关键的第一步。然而&a…

作者头像 李华
网站建设 2026/6/23 18:53:16

PuLID技术深度解析:重新定义人物身份定制的新范式

PuLID技术深度解析&#xff1a;重新定义人物身份定制的新范式 【免费下载链接】PuLID Official code for PuLID: Pure and Lightning ID Customization via Contrastive Alignment 项目地址: https://gitcode.com/GitHub_Trending/pu/PuLID 在人工智能图像生成的浪潮中&…

作者头像 李华
网站建设 2026/6/22 22:02:02

SGLang结构化生成语言:重塑大模型工具调用的新范式

SGLang结构化生成语言&#xff1a;重塑大模型工具调用的新范式 【免费下载链接】sglang SGLang is a structured generation language designed for large language models (LLMs). It makes your interaction with models faster and more controllable. 项目地址: https://…

作者头像 李华