@open-wxa/wxa-runner-core 0.11.0 → 0.12.0

package/dist/{setup-DhDDVlit.d.mts → setup-D0ubZt2C.d.mts}

@@ -40,6 +40,8 @@ interface AppInfo {
     };
     /** 没有时不转发 */
     forwardConsole?: ForwardConsole;
+    /** web-view 的网页在新窗口打开，见 api/webView.ts 的 WebViewWindows */
+    webViewWindow?: boolean;
 }
 
 /**

package/dist/{setup-DhDDVlit.d.ts → setup-D0ubZt2C.d.ts}

@@ -40,6 +40,8 @@ interface AppInfo {
     };
     /** 没有时不转发 */
     forwardConsole?: ForwardConsole;
+    /** web-view 的网页在新窗口打开，见 api/webView.ts 的 WebViewWindows */
+    webViewWindow?: boolean;
 }
 
 /**

package/dist/setup.d.mts

@@ -1 +1 @@
-export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, k as SetupEnv, U as UserInfo, l as defineSetup } from './setup-DhDDVlit.mjs';
+export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, k as SetupEnv, U as UserInfo, l as defineSetup } from './setup-D0ubZt2C.mjs';

package/dist/setup.d.ts

@@ -1 +1 @@
-export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, k as SetupEnv, U as UserInfo, l as defineSetup } from './setup-DhDDVlit.js';
+export { K as KnownMocks, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition, k as SetupEnv, U as UserInfo, l as defineSetup } from './setup-D0ubZt2C.js';

package/dist/test-api.d.mts

@@ -1,5 +1,5 @@
-import { W as WxaTestApi } from './testApi-BbK_1vhj.mjs';
-import './setup-DhDDVlit.mjs';
+import { a as WxaTestApi } from './testApi-x2Yph6M2.mjs';
+import './setup-D0ubZt2C.mjs';
 
 /**
  * window.__wxa_test_api__ 的全局类型声明，供测试代码按需引用：
@@ -17,5 +17,15 @@ declare global {
          * 这里调用 mock、route，App.onLaunch 里就能生效。抛错时模拟器显示错误，小程序不启动
          */
         __wxa_before_launch__?: (api: WxaTestApi) => unknown;
+        /**
+         * 由测试工具在页面脚本执行前设为 true，这次打开的小程序里 web-view 的网页在新窗口打开，
+         * 同开发服务器的 webViewWindow 选项（--webview-window）
+         */
+        __wxa_webview_window__?: boolean;
+        /**
+         * 由测试工具在页面脚本执行前定义。新窗口模式下宿主每新开一个网页窗口（type 为 'open'，带上地址）、关掉一个窗口（'close'）时调用，
+         * name 同 webViews() 的 windowName。网页设置了 Cross-Origin-Opener-Policy 时窗口名会被清空、宿主也关不掉窗口，测试工具靠它对上窗口
+         */
+        __wxa_webview_window_event__?: (type: 'open' | 'close', name: string, src?: string) => Promise<void> | void;
     }
 }

package/dist/test-api.d.ts

@@ -1,5 +1,5 @@
-import { W as WxaTestApi } from './testApi-DbTnccYV.js';
-import './setup-DhDDVlit.js';
+import { a as WxaTestApi } from './testApi-Df0ltBI6.js';
+import './setup-D0ubZt2C.js';
 
 /**
  * window.__wxa_test_api__ 的全局类型声明，供测试代码按需引用：
@@ -17,5 +17,15 @@ declare global {
          * 这里调用 mock、route，App.onLaunch 里就能生效。抛错时模拟器显示错误，小程序不启动
          */
         __wxa_before_launch__?: (api: WxaTestApi) => unknown;
+        /**
+         * 由测试工具在页面脚本执行前设为 true，这次打开的小程序里 web-view 的网页在新窗口打开，
+         * 同开发服务器的 webViewWindow 选项（--webview-window）
+         */
+        __wxa_webview_window__?: boolean;
+        /**
+         * 由测试工具在页面脚本执行前定义。新窗口模式下宿主每新开一个网页窗口（type 为 'open'，带上地址）、关掉一个窗口（'close'）时调用，
+         * name 同 webViews() 的 windowName。网页设置了 Cross-Origin-Opener-Policy 时窗口名会被清空、宿主也关不掉窗口，测试工具靠它对上窗口
+         */
+        __wxa_webview_window_event__?: (type: 'open' | 'close', name: string, src?: string) => Promise<void> | void;
     }
 }

package/dist/{testApi-BbK_1vhj.d.mts → testApi-Df0ltBI6.d.ts}

@@ -1,4 +1,4 @@
-import { d as MockRequest, j as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-DhDDVlit.mjs';
+import { d as MockRequest, j as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-D0ubZt2C.js';
 
 /**
  * 网络 API：wx.request / downloadFile / uploadFile / connectSocket
@@ -16,6 +16,28 @@ interface RecordedRequest extends MockRequest {
     routedBy: string | null;
 }
 
+/**
+ * web-view 组件背后的原生网页视图
+ *
+ * 渲染层的 web-view 组件调 insertHTMLWebView 占位，updateHTMLWebView 设置地址和位置，
+ * 销毁时 removeHTMLWebView；加载进度通过渲染层的 onWebviewStartLoad / onWebviewFinishLoad
+ * 告诉组件，组件据此触发 bindload。
+ *
+ * 默认把网页放在所在页面渲染层里的 iframe 中，跟着页面显示、隐藏和关闭。这有两个限制：
+ * - 设置了 X-Frame-Options 或 CSP frame-ancestors 的网站不允许被嵌入，这类网页显示不出来
+ * - 网页和宿主域名不同时，浏览器按跨站嵌入处理：SameSite 为 Lax、Strict 或没写的 Cookie 存不下、也不发送，
+ *   网页的登录态因此失效。微信里 web-view 是独立的原生网页视图，没有这个问题
+ *
+ * 新窗口模式（--webview-window）把网页放到新窗口里打开，网页是顶层页面，绕开这两个限制，见 WebViewWindows
+ */
+
+/** web-view 当前显示的网页，供测试 API 查询 */
+interface WebViewInfo {
+    src: string;
+    /** 新窗口模式下网页所在窗口的 name；iframe 模式为 null */
+    windowName: string | null;
+}
+
 interface FrameError {
     kind: FrameKind;
     webviewId: number;
@@ -44,6 +66,11 @@ interface WxaTestApi {
     currentPage(): PageSnapshot | null;
     /** 整个页面栈，栈底在前 */
     pageStack(): PageSnapshot[];
+    /**
+     * 当前页里设置过 src 的 web-view，按创建顺序；小程序启动前为空数组。
+     * 新窗口模式下 windowName 是网页所在窗口的 name，可以用它找到这个窗口；iframe 模式下为 null
+     */
+    webViews(): WebViewInfo[];
     /**
      * 等到指定页面成为当前页，已经是当前页时立即返回
      * @param path 页面路径，如 pages/index/index，开头的 / 可有可无
@@ -128,4 +155,4 @@ interface WxaTestApi {
     errors(): FrameError[];
 }
 
-export type { FrameError as F, PageSnapshot as P, RecordedRequest as R, WxaTestApi as W };
+export type { FrameError as F, PageSnapshot as P, RecordedRequest as R, WebViewInfo as W, WxaTestApi as a };

package/dist/{testApi-DbTnccYV.d.ts → testApi-x2Yph6M2.d.mts}

@@ -1,4 +1,4 @@
-import { d as MockRequest, j as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-DhDDVlit.js';
+import { d as MockRequest, j as FrameKind, a as ApiHandler, b as ApiResult, R as RouteHandler } from './setup-D0ubZt2C.mjs';
 
 /**
  * 网络 API：wx.request / downloadFile / uploadFile / connectSocket
@@ -16,6 +16,28 @@ interface RecordedRequest extends MockRequest {
     routedBy: string | null;
 }
 
+/**
+ * web-view 组件背后的原生网页视图
+ *
+ * 渲染层的 web-view 组件调 insertHTMLWebView 占位，updateHTMLWebView 设置地址和位置，
+ * 销毁时 removeHTMLWebView；加载进度通过渲染层的 onWebviewStartLoad / onWebviewFinishLoad
+ * 告诉组件，组件据此触发 bindload。
+ *
+ * 默认把网页放在所在页面渲染层里的 iframe 中，跟着页面显示、隐藏和关闭。这有两个限制：
+ * - 设置了 X-Frame-Options 或 CSP frame-ancestors 的网站不允许被嵌入，这类网页显示不出来
+ * - 网页和宿主域名不同时，浏览器按跨站嵌入处理：SameSite 为 Lax、Strict 或没写的 Cookie 存不下、也不发送，
+ *   网页的登录态因此失效。微信里 web-view 是独立的原生网页视图，没有这个问题
+ *
+ * 新窗口模式（--webview-window）把网页放到新窗口里打开，网页是顶层页面，绕开这两个限制，见 WebViewWindows
+ */
+
+/** web-view 当前显示的网页，供测试 API 查询 */
+interface WebViewInfo {
+    src: string;
+    /** 新窗口模式下网页所在窗口的 name；iframe 模式为 null */
+    windowName: string | null;
+}
+
 interface FrameError {
     kind: FrameKind;
     webviewId: number;
@@ -44,6 +66,11 @@ interface WxaTestApi {
     currentPage(): PageSnapshot | null;
     /** 整个页面栈，栈底在前 */
     pageStack(): PageSnapshot[];
+    /**
+     * 当前页里设置过 src 的 web-view，按创建顺序；小程序启动前为空数组。
+     * 新窗口模式下 windowName 是网页所在窗口的 name，可以用它找到这个窗口；iframe 模式下为 null
+     */
+    webViews(): WebViewInfo[];
     /**
      * 等到指定页面成为当前页，已经是当前页时立即返回
      * @param path 页面路径，如 pages/index/index，开头的 / 可有可无
@@ -128,4 +155,4 @@ interface WxaTestApi {
     errors(): FrameError[];
 }
 
-export type { FrameError as F, PageSnapshot as P, RecordedRequest as R, WxaTestApi as W };
+export type { FrameError as F, PageSnapshot as P, RecordedRequest as R, WebViewInfo as W, WxaTestApi as a };

package/dist/web.d.mts

@@ -33,6 +33,8 @@ interface AppInfo {
     };
     /** 没有时不转发 */
     forwardConsole?: ForwardConsole;
+    /** web-view 的网页在新窗口打开，见 api/webView.ts 的 WebViewWindows */
+    webViewWindow?: boolean;
 }
 
 /**

package/dist/web.d.ts

@@ -33,6 +33,8 @@ interface AppInfo {
     };
     /** 没有时不转发 */
     forwardConsole?: ForwardConsole;
+    /** web-view 的网页在新窗口打开，见 api/webView.ts 的 WebViewWindows */
+    webViewWindow?: boolean;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-wxa/wxa-runner-core",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Dev server and browser runtime that run WeChat mini-programs on the official base library",
   "license": "MIT",
   "author": "open-wxa",
@@ -59,8 +59,8 @@
     "less": "^4.9.1",
     "sass": "~1.99.0",
     "ws": "^8.14.2",
-    "@open-wxa/wxa-runner-extractor": "0.11.0",
-    "@open-wxa/wxa-runner-compiler": "0.11.0"
+    "@open-wxa/wxa-runner-extractor": "0.12.0",
+    "@open-wxa/wxa-runner-compiler": "0.12.0"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",