fix: improve error handling and add JSDoc for navigateTo in Skyline mode

Author: Everestbs

packages/taro-platform-weapp/src/apis.ts

@@ -26,7 +26,12 @@ export function initNativeApi (taro) {
   // 保存原始的 navigateTo 方法
   const originalNavigateTo = taro.navigateTo
 
-  // 重写 navigateTo 以支持 Skyline 渲染模式
+  /**
+   * 重写 navigateTo 以支持 Skyline 渲染模式
+   * 在 Skyline 模式下使用 routeType 参数时，直接调用微信原生 API，避免 Taro 运行时的动画处理导致节点查找失败
+   * @param options - 导航参数对象
+   * @returns Promise<any>
+   */
   taro.navigateTo = function (options: Record<string, any>) {
     // 检查是否在 Skyline 模式下使用了特殊的 routeType
     if (options?.routeType && typeof wx !== 'undefined') {
@@ -42,13 +47,18 @@ export function initNativeApi (taro) {
             ...restOptions,
             success: (res) => {
               success?.(res)
+              complete?.(res)
               resolve(res)
             },
             fail: (err) => {
-              fail?.(err)
+              try {
+                fail?.(err)
+              } catch (e) {
+                // ignore
+              }
+              complete?.(err)
               reject(err)
-            },
-            complete
+            }
           })
         })
       }