@open-wxa/wxa-runner-core 0.10.0 → 0.10.1

package/dist/runtime/host.js

@@ -8,11 +8,15 @@
   var MINI_PROGRAM_ERROR = /^(\(in promise\) )?MiniProgramError\n/;
   var MODULE_URL = /\bhttps?:\/\/[^/\s]+\/__wxa__\/module\/([^?\s)]+?)(?:\?[^:\s)]*)?:(\d+):(\d+)/;
   var ConsoleForwarder = class {
-    /** @param pageOf 出错的页面路径，不知道时返回 undefined */
-    constructor(mode, send, pageOf) {
+    /**
+     * @param pageOf 出错的页面路径，不知道时返回 undefined
+     * @param hintsOf 附在报错后面的提示，帮开发者认出 wxa-runner 和真机不同造成的错误
+     */
+    constructor(mode, send, pageOf, hintsOf = () => []) {
       this.mode = mode;
       this.send = send;
       this.pageOf = pageOf;
+      this.hintsOf = hintsOf;
       this.recentErrors = /* @__PURE__ */ new Map();
     }
     /** 运行时错误：全局 error、未处理的 Promise 拒绝、基础库捕获的业务代码错误 */
@@ -20,8 +24,10 @@
       const frames = businessFrames(stack);
       if (!this.mode || this.isRepeated(`${kind}:${webviewId}:${message}
 ${frames}`)) return;
+      const hints = this.hintsOf(kind).map((hint) => `
+  \u63D0\u793A\uFF1A${hint}`).join("");
       this.post("error", `${this.origin(kind, webviewId)}\u62A5\u9519\uFF1A${message}${frames ? `
-${frames}` : ""}`);
+${frames}` : ""}${hints}`);
     }
     /** 运行时自己的提醒，如调用了未实现的 wx API */
     warn(text) {
@@ -2568,7 +2574,8 @@ html, body { margin: 0; height: 100%; background: radial-gradient(120% 80% at 50
       this.forwarder = new ConsoleForwarder(
         info.forwardConsole ?? false,
         sendReport,
-        (kind, webviewId) => kind === "service" ? this.currentPage()?.path : this.pages.get(webviewId)?.path
+        (kind, webviewId) => kind === "service" ? this.currentPage()?.path : this.pages.get(webviewId)?.path,
+        (kind) => this.launchHints(kind)
       );
       this.shell = new PhoneShell(root, info.device);
       this.tabPaths = new Set((info.wxConfig.tabBar?.list || []).map((item) => stripHtml(item.pagePath)));
@@ -2719,6 +2726,13 @@ html, body { margin: 0; height: 100%; background: radial-gradient(120% 80% at 50
       this.errors.push({ kind: "service", webviewId: 0, api, message });
       this.forwarder.warn(message);
     }
+    /**
+     * 逻辑层在首页创建前出错时的提示：onLaunch、启动阶段的接口回调里读 getCurrentPages()[0] 是常见原因，
+     * 而报错本身只说读不到某个属性。被拦截的请求立即返回，比真机更容易在首页创建前执行回调
+     */
+    launchHints(kind) {
+      return kind === "service" && !this.currentPage() ? ["\u51FA\u9519\u65F6\u9996\u9875\u8FD8\u6CA1\u521B\u5EFA\uFF0CgetCurrentPages() \u8FD4\u56DE\u7684\u662F\u7A7A\u6570\u7EC4"] : [];
+    }
     // ---------------------------------------------------------------------------
     // 路由
     // ---------------------------------------------------------------------------