From d1646d1ad07c914b2378813455ce42e84fa6c8f3 Mon Sep 17 00:00:00 2001
From: liujiayii <liujiayii@foxmail.com>
Date: Thu, 28 May 2026 15:23:23 +0800
Subject: [PATCH 1/2] =?UTF-8?q?feat(interceptor):=20=E5=AE=8C=E5=96=84?=
 =?UTF-8?q?=E6=8B=A6=E6=88=AA=E5=99=A8=E8=83=BD=E5=8A=9B=EF=BC=8C=E6=94=AF?=
 =?UTF-8?q?=E6=8C=81=E5=BC=82=E6=AD=A5=E6=8B=A6=E6=88=AA=E5=92=8C=E6=8B=A6?=
 =?UTF-8?q?=E6=88=AA=E9=98=BB=E6=96=AD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增了拦截器同步/异步返回false时阻断API调用的能力，同时支持异步拦截器修改传入参数
添加了完整的拦截器单元测试用例覆盖各类场景
重构了拦截器队列执行逻辑，统一同步异步处理流程
---
 .../__tests__/helpers/interceptor.spec.ts     | 65 +++++++++++++++++++
 packages/uni-api/src/helpers/interceptor.ts   | 28 ++++++--
 2 files changed, 86 insertions(+), 7 deletions(-)
 create mode 100644 packages/uni-api/__tests__/helpers/interceptor.spec.ts

diff --git a/packages/uni-api/__tests__/helpers/interceptor.spec.ts b/packages/uni-api/__tests__/helpers/interceptor.spec.ts
new file mode 100644
index 0000000000..c01d9b65c5
--- /dev/null
+++ b/packages/uni-api/__tests__/helpers/interceptor.spec.ts
@@ -0,0 +1,65 @@
+import {
+  globalInterceptors,
+  invokeApi,
+  scopedInterceptors,
+} from '../../src/helpers/interceptor'
+
+function resetInterceptors() {
+  Object.keys(globalInterceptors).forEach((key) => {
+    delete globalInterceptors[key as keyof typeof globalInterceptors]
+  })
+  Object.keys(scopedInterceptors).forEach((key) => {
+    delete scopedInterceptors[key]
+  })
+}
+
+describe('interceptor', () => {
+  afterEach(() => {
+    resetInterceptors()
+  })
+
+  test('blocks api invocation when invoke returns false synchronously', () => {
+    const api = jest.fn()
+    globalInterceptors.invoke = [
+      () => {
+        return false
+      },
+    ]
+
+    const res = invokeApi('test', api, {}, [])
+
+    expect(res).toBeUndefined()
+    expect(api).not.toHaveBeenCalled()
+  })
+
+  test('blocks api invocation when invoke resolves false asynchronously', async () => {
+    const api = jest.fn()
+    globalInterceptors.invoke = [
+      () => {
+        return Promise.resolve(false)
+      },
+    ]
+
+    invokeApi('test', api, {}, [])
+    await new Promise((resolve) => setTimeout(resolve, 0))
+
+    expect(api).not.toHaveBeenCalled()
+  })
+
+  test('passes resolved options to api invocation', async () => {
+    const api = jest.fn((options) => options)
+    const options = { url: '/old' }
+    const resolvedOptions = { url: '/new' }
+    globalInterceptors.invoke = [
+      () => {
+        return Promise.resolve(resolvedOptions)
+      },
+    ]
+
+    const res = await invokeApi('test', api, options, [])
+
+    expect(res).toBe(resolvedOptions)
+    expect(api).toHaveBeenCalledTimes(1)
+    expect(api).toHaveBeenCalledWith(resolvedOptions)
+  })
+})
diff --git a/packages/uni-api/src/helpers/interceptor.ts b/packages/uni-api/src/helpers/interceptor.ts
index d31543921a..3496c61360 100644
--- a/packages/uni-api/src/helpers/interceptor.ts
+++ b/packages/uni-api/src/helpers/interceptor.ts
@@ -20,9 +20,24 @@ export type Interceptors = { [P in HOOKS]?: Function[] }
 export const globalInterceptors: Interceptors = {}
 export const scopedInterceptors: { [key: string]: Interceptors } = {}
 
+const API_INVOKE_ABORT = {
+  then() {},
+  catch() {},
+} as Promise<undefined>
+
+function resolveHookResult(res: unknown, data?: unknown) {
+  return res === false ? API_INVOKE_ABORT : res || data
+}
+
 function wrapperHook(hook: Function, params?: Record<string, any>) {
   return function (data: unknown) {
-    return hook(data, params) || data
+    const res = hook(data, params)
+    if (isPromise(res)) {
+      return Promise.resolve(res).then((res) => {
+        return resolveHookResult(res, data)
+      })
+    }
+    return resolveHookResult(res, data)
   }
 }
 
@@ -35,17 +50,16 @@ function queue(
   for (let i = 0; i < hooks.length; i++) {
     const hook = hooks[i]
     if (promise) {
-      promise = Promise.resolve(wrapperHook(hook, params))
+      promise = promise.then(wrapperHook(hook, params))
     } else {
       const res = hook(data, params)
       if (isPromise(res)) {
-        promise = Promise.resolve(res)
+        promise = Promise.resolve(res).then((res) => {
+          return resolveHookResult(res)
+        })
       }
       if (res === false) {
-        return {
-          then() {},
-          catch() {},
-        } as Promise<undefined>
+        return API_INVOKE_ABORT
       }
     }
   }

From 997c646efaa3358de261247338f845b9873d0d47 Mon Sep 17 00:00:00 2001
From: liujiayii <liujiayii@foxmail.com>
Date: Thu, 28 May 2026 16:47:52 +0800
Subject: [PATCH 2/2] =?UTF-8?q?feat(playground):=20=E6=96=B0=E5=A2=9E?=
 =?UTF-8?q?=E6=8B=A6=E6=88=AA=E5=99=A8=E7=A4=BA=E4=BE=8B=E9=A1=B5=E9=9D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/playground/assets/src/pages.json     |   3 +
 .../assets/src/pages/index/index.vue          |   1 +
 .../src/pages/interceptor/interceptor.vue     | 237 ++++++++++++++++++
 3 files changed, 241 insertions(+)
 create mode 100644 packages/playground/assets/src/pages/interceptor/interceptor.vue

diff --git a/packages/playground/assets/src/pages.json b/packages/playground/assets/src/pages.json
index 55d2e21fc9..1fc69eddbf 100644
--- a/packages/playground/assets/src/pages.json
+++ b/packages/playground/assets/src/pages.json
@@ -2,6 +2,9 @@
   "pages": [
     {
       "path": "pages/index/index"
+    },
+    {
+      "path": "pages/interceptor/interceptor"
     }
   ],
   "subPackages": [
diff --git a/packages/playground/assets/src/pages/index/index.vue b/packages/playground/assets/src/pages/index/index.vue
index 19fe87ba48..aeaae7c802 100644
--- a/packages/playground/assets/src/pages/index/index.vue
+++ b/packages/playground/assets/src/pages/index/index.vue
@@ -1,6 +1,7 @@
 <template>
     <scroll-view>
         <navigator url="/pages/sub/test/test">test</navigator>
+        <navigator url="/pages/interceptor/interceptor">拦截器示例</navigator>
         <test-com></test-com>
         <view>
             <view>3:{{ invalidStatic }}</view>
diff --git a/packages/playground/assets/src/pages/interceptor/interceptor.vue b/packages/playground/assets/src/pages/interceptor/interceptor.vue
new file mode 100644
index 0000000000..6cf47ef7f2
--- /dev/null
+++ b/packages/playground/assets/src/pages/interceptor/interceptor.vue
@@ -0,0 +1,237 @@
+<script setup>
+import { delay } from "es-toolkit";
+import { ref } from "vue";
+
+const navigateActive = ref(false);
+
+// 添加日志
+function addLog(msg) {
+  const time = new Date().toLocaleTimeString();
+  console.log(`[${time}] ${msg}`);
+}
+// 添加 navigateTo 拦截器
+function addNavigateInterceptor() {
+  if (navigateActive.value) {
+    addLog("navigateTo 拦截器已存在，无需重复添加");
+    return;
+  }
+  uni.addInterceptor("navigateTo", {
+    invoke: (args) => {
+      addLog(`🚀 [navigateTo-invoke] 目标页面：${args.url || "未知"}`);
+      return false;
+    },
+    success: () => {
+      addLog("🚀 [navigateTo-success] 跳转成功");
+    },
+    fail: (err) => {
+      addLog(`🚀 [navigateTo-fail] 跳转失败：${err.errMsg || "未知错误"}`);
+    },
+    complete: () => {
+      addLog("🚀 [navigateTo-complete] 跳转操作完成");
+    },
+  });
+  navigateActive.value = true;
+  addLog("✅ navigateTo 拦截器已添加");
+}
+// 添加异步 navigateTo 拦截器
+function addAsyncNavigateInterceptor() {
+  if (navigateActive.value) {
+    addLog("navigateTo 拦截器已存在，无需重复添加");
+    return;
+  }
+  uni.addInterceptor("navigateTo", {
+    invoke: async (args) => {
+      addLog(`🚀 [navigateTo-invoke] 目标页面：${args.url || "未知"}`);
+      await delay(1000);
+      return false;
+    },
+    success: () => {
+      addLog("🚀 [navigateTo-success] 跳转成功");
+    },
+    fail: (err) => {
+      addLog(`🚀 [navigateTo-fail] 跳转失败：${err.errMsg || "未知错误"}`);
+    },
+    complete: () => {
+      addLog("🚀 [navigateTo-complete] 跳转操作完成");
+    },
+  });
+  navigateActive.value = true;
+  addLog("✅ navigateTo 拦截器已添加");
+}
+// 添加多个异步 navigateTo 拦截器
+function addMultiAsyncNavigateInterceptor() {
+  if (navigateActive.value) {
+    addLog("navigateTo 拦截器已存在，无需重复添加");
+    return;
+  }
+  uni.addInterceptor("navigateTo", {
+    invoke: async (args) => {
+      addLog(`🚀 [navigateTo-invoke] 目标页面：${args.url || "未知"}`);
+      return new Promise((resolve) => {
+        setTimeout(() => {
+          addLog("s1-invoke");
+          resolve(args);
+        }, 2000);
+      });
+    },
+    success: () => {
+      addLog("🚀 [navigateTo-success] 跳转成功");
+    },
+    fail: (err) => {
+      addLog(`🚀 [navigateTo-fail] 跳转失败：${err.errMsg || "未知错误"}`);
+    },
+    complete: () => {
+      addLog("🚀 [navigateTo-complete] 跳转操作完成");
+    },
+  });
+  uni.addInterceptor("navigateTo", {
+    invoke: async (args) => {
+      addLog(`🚀 [navigateTo-invoke] 目标页面：${args.url || "未知"}`);
+      return new Promise((resolve) => {
+        setTimeout(() => {
+          addLog("s2-invoke");
+          resolve(args);
+        }, 4000);
+      });
+    },
+    success: () => {
+      addLog("🚀 [navigateTo-success] 跳转成功");
+    },
+    fail: (err) => {
+      addLog(`🚀 [navigateTo-fail] 跳转失败：${err.errMsg || "未知错误"}`);
+    },
+    complete: () => {
+      addLog("🚀 [navigateTo-complete] 跳转操作完成");
+    },
+  });
+  navigateActive.value = true;
+  addLog("✅ navigateTo 拦截器已添加");
+}
+
+// 移除 navigateTo 拦截器
+function removeNavigateInterceptor() {
+  if (!navigateActive.value) {
+    addLog("navigateTo 拦截器未启用，无需移除");
+    return;
+  }
+  uni.removeInterceptor("navigateTo");
+  navigateActive.value = false;
+  addLog("🗑️ navigateTo 拦截器已移除");
+}
+// 触发跳转
+function triggerNavigate() {
+  addLog("--- 手动触发 uni.navigateTo ---");
+  uni.navigateTo({
+    url: "/pages/index/index",
+    success: () => {
+      addLog("📋 跳转成功回调");
+    },
+    fail: (err) => {
+      addLog(`📋 跳转失败回调：${err.errMsg || "未知"}`);
+    },
+  });
+}
+</script>
+
+<template>
+  <view class="container">
+    <text class="title">
+      拦截器示例
+    </text>
+
+    <!-- navigateTo 拦截器 -->
+    <view class="section">
+      <text class="section-title">
+        navigateTo 拦截器
+      </text>
+      <view class="btn-group">
+        <button class="btn add" @click="addNavigateInterceptor">
+          添加 navigateTo 拦截器
+        </button>
+        <button class="btn add" @click="addAsyncNavigateInterceptor">
+          添加异步 navigateTo 拦截器
+        </button>
+        <button class="btn add" @click="addMultiAsyncNavigateInterceptor">
+          添加多个异步 navigateTo 拦截器
+        </button>
+        <button class="btn remove" @click="removeNavigateInterceptor">
+          移除 navigateTo 拦截器
+        </button>
+      </view>
+      <text class="status">
+        状态：{{ navigateActive ? '✅ 已启用' : '❌ 未启用' }}
+      </text>
+    </view>
+
+    <!-- 触发操作 -->
+    <view class="section">
+      <text class="section-title">
+        触发操作
+      </text>
+      <view class="btn-group">
+        <button class="btn action" @click="triggerNavigate">
+          跳转页面
+        </button>
+      </view>
+    </view>
+  </view>
+</template>
+
+<style scoped lang="css">
+.container {
+  padding: 20rpx;
+}
+
+.title {
+  font-size: 40rpx;
+  font-weight: bold;
+  text-align: center;
+  margin-bottom: 30rpx;
+}
+
+.section {
+  margin-bottom: 30rpx;
+  padding: 20rpx;
+  background-color: #f8f8f8;
+  border-radius: 16rpx;
+}
+
+.section-title {
+  font-size: 30rpx;
+  font-weight: bold;
+  margin-bottom: 16rpx;
+}
+
+.btn-group {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 16rpx;
+  margin-bottom: 12rpx;
+}
+
+.btn {
+  font-size: 24rpx;
+  padding: 12rpx 20rpx;
+  border-radius: 8rpx;
+}
+
+.btn.add {
+  background-color: #007aff;
+  color: #ffffff;
+}
+
+.btn.remove {
+  background-color: #ff3b30;
+  color: #ffffff;
+}
+
+.btn.action {
+  background-color: #34c759;
+  color: #ffffff;
+}
+
+.status {
+  font-size: 24rpx;
+  color: #666666;
+}
+</style>