@mpcore/simulator 0.4.3 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -0
- package/dist/index.d.mts +109 -80
- package/dist/index.mjs +1276 -440
- package/package.json +8 -4
package/README.md
CHANGED
|
@@ -12,7 +12,15 @@
|
|
|
12
12
|
- 提供测试节点句柄上的 `tap()`、`trigger()`、`input()`、`change()`、`blur()` 交互辅助方法
|
|
13
13
|
- 提供测试页面/会话句柄上的 `waitForSelector()`、`waitForText()`、`waitForTextGone()`、`waitForData()`、`waitForCurrentPage()` 等轮询等待方法
|
|
14
14
|
- 测试会话句柄提供与 `miniprogram-automator` 对齐的 `toolInfo()`,headless provider 返回稳定的 simulator 标识
|
|
15
|
+
- 提供原生形状的 `wx.onAppShow/offAppShow/onAppHide/offAppHide`;Node/browser session 与测试句柄通过 `triggerAppShow(options?)`、`triggerAppHide({ reason })` 显式驱动应用前后台事件,普通页面导航不会伪造应用切换
|
|
16
|
+
- 测试入口 `launch({ configureSession })` 会在执行 `app.js` 前等待配置完成,可安装测试宿主能力;配置失败会关闭会话,默认 request 仍受既有 mock / strict mock 策略约束,不自动开放真实网络
|
|
15
17
|
- 通过共享 `RuntimeKernel` 管理 artifact、独立执行 realm、timer、diagnostics 与平台适配边界
|
|
16
18
|
- `close()` 会清理页面栈、组件 scope、observer、timer、事件和模块缓存,并使旧页面/节点 handle 失效
|
|
17
19
|
|
|
18
20
|
编写页面和组件单测时优先使用上层 `@mpcore/test`;直接使用本包适合实现 provider、调试桥或更低层运行时断言。
|
|
21
|
+
|
|
22
|
+
应用首次启动只执行一次 `onLaunch`,并在首页加载前发送应用显示事件。后续 `triggerAppShow` 更新 enter options,不改写 launch options;隐藏原因显式限定为 `0 | 1 | 2 | 3`。关闭会话会清理应用事件监听,不合成额外的隐藏事件。这里定义的是可测试的 simulator 行为,不代表已验证真实微信 IDE 中 App hook 与 `wx` 监听器之间的相对调用顺序。
|
|
23
|
+
|
|
24
|
+
浏览器会话的 `renderCurrentPage().styles` 提供当前页面的 `cssText`、项目相对 `dependencies` 和 `appWxssEnabled`,Web demo 将该结果挂载到页面预览的 Shadow DOM。解析器读取 `app.wxss`、页面 `.wxss` 及递归本地 `@import`,保留导入位置和全局在前、页面在后的层叠顺序;页面 `.wxss` 内联的全局样式快照也会动态加载,并保留其后页面自有样式的覆盖优先级。文件修改后重新渲染会读取最新内容,包括只更新样式的场景,不重建页面或 App 实例。
|
|
25
|
+
|
|
26
|
+
此入口只负责页面样式依赖和 CSS 兼容声明,不实现嵌套组件的完整样式隔离、类名前缀转换或 `rpx` 布局换算。Component 页面的 `page-isolated`、`page-strong-isolated`、`page-apply-shared`、`page-shared` 禁用隐式 `app.wxss`,页面仍可显式导入样式;最终页面 JSON 的 `styleIsolation` 优先于 JS 定义,JSON 未提供该值时才保留 JS 选项。普通 `Page` 注册不应用组件隔离选项,普通 `isolated` 也不等同于 `page-isolated`。缺失依赖、循环导入、非法 CSS 和不支持的导入会抛出明确错误。支持带媒体条件的本地导入;远程导入及 `layer` / `supports` 导入条件不受支持,也不会触发外部请求。
|
package/dist/index.d.mts
CHANGED
|
@@ -337,11 +337,16 @@ export interface HeadlessWxLaunchOptions {
|
|
|
337
337
|
path: string;
|
|
338
338
|
query: Record<string, string>;
|
|
339
339
|
referrerInfo: {
|
|
340
|
-
appId
|
|
341
|
-
extraData
|
|
340
|
+
appId?: string;
|
|
341
|
+
extraData?: Record<string, never>;
|
|
342
342
|
};
|
|
343
343
|
scene: number;
|
|
344
344
|
}
|
|
345
|
+
export interface HeadlessWxAppHideOptions {
|
|
346
|
+
reason: 0 | 1 | 2 | 3;
|
|
347
|
+
}
|
|
348
|
+
export type HeadlessWxAppHideCallback = (options: HeadlessWxAppHideOptions) => void;
|
|
349
|
+
export type HeadlessWxAppShowCallback = (options: HeadlessWxLaunchOptions) => void;
|
|
345
350
|
export interface HeadlessWxMenuButtonBoundingClientRectResult {
|
|
346
351
|
bottom: number;
|
|
347
352
|
height: number;
|
|
@@ -478,6 +483,18 @@ export interface HeadlessWxFileSystemManager {
|
|
|
478
483
|
writeFileSync: (filePath: string, data: string, encoding?: string) => void;
|
|
479
484
|
}
|
|
480
485
|
//#endregion
|
|
486
|
+
//#region src/host/wx/logManager.d.ts
|
|
487
|
+
interface HeadlessWxGetLogManagerOption {
|
|
488
|
+
/** 控制宿主自动生命周期及 API 日志,不过滤显式日志方法。 */
|
|
489
|
+
level?: number;
|
|
490
|
+
}
|
|
491
|
+
interface HeadlessWxLogManager {
|
|
492
|
+
debug: (...args: unknown[]) => void;
|
|
493
|
+
info: (...args: unknown[]) => void;
|
|
494
|
+
log: (...args: unknown[]) => void;
|
|
495
|
+
warn: (...args: unknown[]) => void;
|
|
496
|
+
}
|
|
497
|
+
//#endregion
|
|
481
498
|
//#region src/host/wx/media.d.ts
|
|
482
499
|
export interface HeadlessWxGetImageInfoResult {
|
|
483
500
|
errMsg: string;
|
|
@@ -837,7 +854,11 @@ export interface HeadlessWxDriverCapabilities {
|
|
|
837
854
|
navigateBack: (option?: HeadlessWxNavigateBackOption) => unknown;
|
|
838
855
|
navigateTo: (option: HeadlessWxNavigateOption) => unknown;
|
|
839
856
|
nextTick: (callback?: () => void) => void;
|
|
857
|
+
offAppHide: (callback?: HeadlessWxAppHideCallback) => void;
|
|
858
|
+
offAppShow: (callback?: HeadlessWxAppShowCallback) => void;
|
|
840
859
|
offNetworkStatusChange: (callback?: HeadlessWxNetworkStatusChangeCallback) => void;
|
|
860
|
+
onAppHide: (callback: HeadlessWxAppHideCallback) => void;
|
|
861
|
+
onAppShow: (callback: HeadlessWxAppShowCallback) => void;
|
|
841
862
|
onNetworkStatusChange: (callback: HeadlessWxNetworkStatusChangeCallback) => void;
|
|
842
863
|
pageScrollTo: (option: HeadlessWxPageScrollToOption) => unknown;
|
|
843
864
|
reLaunch: (option: HeadlessWxNavigateOption) => unknown;
|
|
@@ -947,6 +968,7 @@ export interface HeadlessWx extends HeadlessUniEventBus {
|
|
|
947
968
|
getAppBaseInfoSync: () => HeadlessWxAppBaseInfoResult;
|
|
948
969
|
getDeviceInfo: () => HeadlessWxDeviceInfoResult;
|
|
949
970
|
getLaunchOptionsSync: () => HeadlessWxLaunchOptions;
|
|
971
|
+
getLogManager: (option?: HeadlessWxGetLogManagerOption) => HeadlessWxLogManager;
|
|
950
972
|
getMenuButtonBoundingClientRect: () => HeadlessWxMenuButtonBoundingClientRectResult;
|
|
951
973
|
getClipboardData: (option?: HeadlessWxGetClipboardDataOption) => HeadlessWxGetClipboardDataResult | undefined;
|
|
952
974
|
getLocation: (option?: HeadlessWxGetLocationOption) => HeadlessWxGetLocationResult | undefined;
|
|
@@ -970,7 +992,11 @@ export interface HeadlessWx extends HeadlessUniEventBus {
|
|
|
970
992
|
navigateBack: (option?: HeadlessWxNavigateBackOption) => unknown;
|
|
971
993
|
navigateTo: (option: HeadlessWxNavigateOption) => unknown;
|
|
972
994
|
nextTick: (callback?: () => void) => void;
|
|
995
|
+
offAppHide: (callback?: HeadlessWxAppHideCallback) => void;
|
|
996
|
+
offAppShow: (callback?: HeadlessWxAppShowCallback) => void;
|
|
973
997
|
offNetworkStatusChange: (callback?: HeadlessWxNetworkStatusChangeCallback) => void;
|
|
998
|
+
onAppHide: (callback: HeadlessWxAppHideCallback) => void;
|
|
999
|
+
onAppShow: (callback: HeadlessWxAppShowCallback) => void;
|
|
974
1000
|
onNetworkStatusChange: (callback: HeadlessWxNetworkStatusChangeCallback) => void;
|
|
975
1001
|
openDocument: (option: HeadlessWxOpenDocumentOption) => HeadlessWxOpenDocumentResult | undefined;
|
|
976
1002
|
pageScrollTo: (option: HeadlessWxPageScrollToOption) => unknown;
|
|
@@ -1055,7 +1081,7 @@ export interface HeadlessWx extends HeadlessUniEventBus {
|
|
|
1055
1081
|
}
|
|
1056
1082
|
//#endregion
|
|
1057
1083
|
//#region src/host/wx/index.d.ts
|
|
1058
|
-
export declare function createHeadlessWx(driver: HeadlessWxDriver): HeadlessWx;
|
|
1084
|
+
export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'>): HeadlessWx;
|
|
1059
1085
|
//#endregion
|
|
1060
1086
|
//#region src/kernel/artifactSource.d.ts
|
|
1061
1087
|
export interface ArtifactSource {
|
|
@@ -1246,30 +1272,6 @@ interface HeadlessBackgroundSnapshot {
|
|
|
1246
1272
|
textStyle: HeadlessBackgroundTextStyle;
|
|
1247
1273
|
}
|
|
1248
1274
|
//#endregion
|
|
1249
|
-
//#region src/runtime/pageInstance.d.ts
|
|
1250
|
-
export interface HeadlessPageInstance extends Record<string, any> {
|
|
1251
|
-
__background__?: HeadlessBackgroundSnapshot;
|
|
1252
|
-
__backgroundTextStyle__?: HeadlessBackgroundTextStyle;
|
|
1253
|
-
__lastChangedKeys__?: string[];
|
|
1254
|
-
__navigationBar__?: HeadlessNavigationBarSnapshot;
|
|
1255
|
-
__navigationBarTitle__?: string;
|
|
1256
|
-
__route__: string;
|
|
1257
|
-
__scrollTop__?: number;
|
|
1258
|
-
data: Record<string, any>;
|
|
1259
|
-
options: Record<string, string>;
|
|
1260
|
-
route: string;
|
|
1261
|
-
createIntersectionObserver?: (options?: Record<string, any>) => any;
|
|
1262
|
-
createMediaQueryObserver?: () => HeadlessWxMediaQueryObserver;
|
|
1263
|
-
selectAllComponents?: (selector: string) => any[];
|
|
1264
|
-
selectComponent?: (selector: string) => any;
|
|
1265
|
-
setData: (patch: Record<string, any>, callback?: () => void) => void;
|
|
1266
|
-
}
|
|
1267
|
-
export declare function createPageInstance(route: string, definition: HeadlessPageDefinition, options?: Record<string, string>, pageState?: {
|
|
1268
|
-
background?: HeadlessBackgroundSnapshot;
|
|
1269
|
-
backgroundTextStyle?: HeadlessBackgroundTextStyle;
|
|
1270
|
-
navigationBar?: HeadlessNavigationBarSnapshot;
|
|
1271
|
-
}): HeadlessPageInstance;
|
|
1272
|
-
//#endregion
|
|
1273
1275
|
//#region src/runtime/componentInstance/types.d.ts
|
|
1274
1276
|
interface HeadlessComponentInstance extends Record<string, any> {
|
|
1275
1277
|
__definition__?: HeadlessComponentDefinition;
|
|
@@ -1278,6 +1280,8 @@ interface HeadlessComponentInstance extends Record<string, any> {
|
|
|
1278
1280
|
__ready__?: boolean;
|
|
1279
1281
|
createIntersectionObserver?: (options?: Record<string, any>) => any;
|
|
1280
1282
|
createMediaQueryObserver?: () => HeadlessWxMediaQueryObserver;
|
|
1283
|
+
createSelectorQuery?: () => HeadlessWxSelectorQuery;
|
|
1284
|
+
getRelationNodes: (relationKey: string) => HeadlessComponentInstance[];
|
|
1281
1285
|
data: Record<string, any>;
|
|
1282
1286
|
properties: Record<string, any>;
|
|
1283
1287
|
selectAllComponents?: (selector: string) => any[];
|
|
@@ -1309,18 +1313,68 @@ export declare function createComponentInstance(options: CreateComponentInstance
|
|
|
1309
1313
|
export declare function runComponentLifecycle(instance: HeadlessComponentInstance, lifecycleName: 'attached' | 'created' | 'detached' | 'ready'): void;
|
|
1310
1314
|
export declare function runComponentPageLifetime(instance: HeadlessComponentInstance, lifetimeName: 'hide' | 'resize' | 'show', payload?: unknown): void;
|
|
1311
1315
|
//#endregion
|
|
1316
|
+
//#region src/runtime/pageInstance.d.ts
|
|
1317
|
+
export interface HeadlessPageInstance extends Record<string, any> {
|
|
1318
|
+
__background__?: HeadlessBackgroundSnapshot;
|
|
1319
|
+
__backgroundTextStyle__?: HeadlessBackgroundTextStyle;
|
|
1320
|
+
__lastChangedKeys__?: string[];
|
|
1321
|
+
__navigationBar__?: HeadlessNavigationBarSnapshot;
|
|
1322
|
+
__navigationBarTitle__?: string;
|
|
1323
|
+
__route__: string;
|
|
1324
|
+
__scrollTop__?: number;
|
|
1325
|
+
data: Record<string, any>;
|
|
1326
|
+
properties: Record<string, any>;
|
|
1327
|
+
options: Record<string, string>;
|
|
1328
|
+
route: string;
|
|
1329
|
+
createIntersectionObserver?: (options?: Record<string, any>) => any;
|
|
1330
|
+
createMediaQueryObserver?: () => HeadlessWxMediaQueryObserver;
|
|
1331
|
+
getTabBar?: () => HeadlessComponentInstance | null;
|
|
1332
|
+
selectAllComponents?: (selector: string) => any[];
|
|
1333
|
+
selectComponent?: (selector: string) => any;
|
|
1334
|
+
setData: (patch: Record<string, any>, callback?: () => void) => void;
|
|
1335
|
+
}
|
|
1336
|
+
export declare function getPageInstanceId(page: HeadlessPageInstance): number;
|
|
1337
|
+
export declare function createPageInstance(route: string, definition: HeadlessPageDefinition, options?: Record<string, string>, pageState?: {
|
|
1338
|
+
background?: HeadlessBackgroundSnapshot;
|
|
1339
|
+
backgroundTextStyle?: HeadlessBackgroundTextStyle;
|
|
1340
|
+
navigationBar?: HeadlessNavigationBarSnapshot;
|
|
1341
|
+
requestRender?: (callback?: () => void) => void;
|
|
1342
|
+
}): HeadlessPageInstance;
|
|
1343
|
+
//#endregion
|
|
1344
|
+
//#region src/view/wxs.d.ts
|
|
1345
|
+
type WxsModuleBindings = Record<string, unknown>;
|
|
1346
|
+
//#endregion
|
|
1312
1347
|
//#region src/view/templateRuntime.d.ts
|
|
1313
1348
|
interface TemplateNodeLike {
|
|
1314
1349
|
attribs?: Record<string, string>;
|
|
1315
1350
|
children?: TemplateNodeLike[];
|
|
1351
|
+
data?: string;
|
|
1316
1352
|
name?: string;
|
|
1317
1353
|
type?: string;
|
|
1318
1354
|
}
|
|
1319
1355
|
interface TemplateRenderState<T extends TemplateNodeLike> {
|
|
1320
1356
|
definitions: Map<string, T>;
|
|
1357
|
+
definitionScopes?: Map<T, Map<string, T>>;
|
|
1358
|
+
definitionWxsScopes?: Map<T, WxsModuleBindings>;
|
|
1359
|
+
wxsModules?: WxsModuleBindings;
|
|
1321
1360
|
stack: string[];
|
|
1322
1361
|
}
|
|
1323
1362
|
//#endregion
|
|
1363
|
+
//#region src/browser/styles/index.d.ts
|
|
1364
|
+
export interface BrowserPageStyles {
|
|
1365
|
+
/** 按实际遍历顺序去重的项目相对样式依赖。 */
|
|
1366
|
+
dependencies: string[];
|
|
1367
|
+
/** 已展开本地导入的页面 CSS;不包含嵌套组件样式隔离转换。 */
|
|
1368
|
+
cssText: string;
|
|
1369
|
+
/** Component 页面的 page-* 隔离选项可关闭隐式 app.wxss。 */
|
|
1370
|
+
appWxssEnabled: boolean;
|
|
1371
|
+
}
|
|
1372
|
+
/** 读取当前文件内容并展开页面样式依赖,保持 app 在前、页面声明在后的层叠顺序。 */
|
|
1373
|
+
export declare function resolveBrowserPageStyles(files: BrowserVirtualFiles, route: string, options?: {
|
|
1374
|
+
miniprogramRootPath?: string;
|
|
1375
|
+
styleIsolation?: string;
|
|
1376
|
+
}): BrowserPageStyles;
|
|
1377
|
+
//#endregion
|
|
1324
1378
|
//#region src/browser/render/types.d.ts
|
|
1325
1379
|
interface DomNodeLike$5 {
|
|
1326
1380
|
attribs?: Record<string, string>;
|
|
@@ -1331,6 +1385,7 @@ interface DomNodeLike$5 {
|
|
|
1331
1385
|
type?: string;
|
|
1332
1386
|
}
|
|
1333
1387
|
interface BrowserRenderScope {
|
|
1388
|
+
wxs?: WxsModuleBindings;
|
|
1334
1389
|
alias?: string;
|
|
1335
1390
|
classList?: string[];
|
|
1336
1391
|
data: Record<string, any>;
|
|
@@ -1358,6 +1413,7 @@ interface BrowserSlotContent {
|
|
|
1358
1413
|
}
|
|
1359
1414
|
interface BrowserRenderedPageTree {
|
|
1360
1415
|
root: DomNodeLike$5;
|
|
1416
|
+
styles: BrowserPageStyles;
|
|
1361
1417
|
wxml: string;
|
|
1362
1418
|
}
|
|
1363
1419
|
interface BrowserRendererContext {
|
|
@@ -1389,6 +1445,7 @@ export declare function createAppInstance(definition: HeadlessAppDefinition): He
|
|
|
1389
1445
|
//#region src/runtime/moduleLoader.d.ts
|
|
1390
1446
|
interface HeadlessModuleLoader {
|
|
1391
1447
|
close: () => void;
|
|
1448
|
+
evaluate: <T>(source: string, args: any[]) => T;
|
|
1392
1449
|
executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
|
|
1393
1450
|
executeAppModule: (filePath: string) => HeadlessAppDefinition;
|
|
1394
1451
|
executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
|
|
@@ -1405,6 +1462,7 @@ interface DomNodeLike$4 {
|
|
|
1405
1462
|
type?: string;
|
|
1406
1463
|
}
|
|
1407
1464
|
interface RuntimeRenderScope {
|
|
1465
|
+
wxs?: WxsModuleBindings;
|
|
1408
1466
|
alias?: string;
|
|
1409
1467
|
classList?: string[];
|
|
1410
1468
|
data: Record<string, any>;
|
|
@@ -1846,6 +1904,7 @@ export declare class HeadlessSession {
|
|
|
1846
1904
|
private readonly kernel;
|
|
1847
1905
|
private appDefinition;
|
|
1848
1906
|
private appInstance;
|
|
1907
|
+
private readonly appLifecycle;
|
|
1849
1908
|
private readonly moduleLoader;
|
|
1850
1909
|
private readonly eventListeners;
|
|
1851
1910
|
private readonly registries;
|
|
@@ -1879,6 +1938,8 @@ export declare class HeadlessSession {
|
|
|
1879
1938
|
getApp(): HeadlessAppInstance | null;
|
|
1880
1939
|
getCurrentPages(): HeadlessPageInstance[];
|
|
1881
1940
|
getWx(): HeadlessWx;
|
|
1941
|
+
/** 在当前小程序实例的上下文执行测试函数,复用应用全局对象与调度器。 */
|
|
1942
|
+
evaluateRuntime<T = unknown>(source: string, args?: any[]): T;
|
|
1882
1943
|
callWxMethod(methodName: string, ...args: any[]): any;
|
|
1883
1944
|
getCurrentPageNavigationBarTitle(): string | null;
|
|
1884
1945
|
getCurrentPageNavigationBar(): {
|
|
@@ -2045,32 +2106,8 @@ export declare class HeadlessSession {
|
|
|
2045
2106
|
getWindowInfo(): HeadlessWxWindowInfoResult;
|
|
2046
2107
|
getAppBaseInfo(): HeadlessWxAppBaseInfoResult;
|
|
2047
2108
|
getDeviceInfo(): HeadlessWxDeviceInfoResult;
|
|
2048
|
-
getLaunchOptions():
|
|
2049
|
-
|
|
2050
|
-
[x: string]: string;
|
|
2051
|
-
};
|
|
2052
|
-
referrerInfo: {
|
|
2053
|
-
extraData: {
|
|
2054
|
-
[x: string]: never;
|
|
2055
|
-
};
|
|
2056
|
-
appId: string;
|
|
2057
|
-
};
|
|
2058
|
-
path: string;
|
|
2059
|
-
scene: number;
|
|
2060
|
-
};
|
|
2061
|
-
getEnterOptions(): {
|
|
2062
|
-
query: {
|
|
2063
|
-
[x: string]: string;
|
|
2064
|
-
};
|
|
2065
|
-
referrerInfo: {
|
|
2066
|
-
extraData: {
|
|
2067
|
-
[x: string]: never;
|
|
2068
|
-
};
|
|
2069
|
-
appId: string;
|
|
2070
|
-
};
|
|
2071
|
-
path: string;
|
|
2072
|
-
scene: number;
|
|
2073
|
-
};
|
|
2109
|
+
getLaunchOptions(): HeadlessWxLaunchOptions;
|
|
2110
|
+
getEnterOptions(): HeadlessWxLaunchOptions;
|
|
2074
2111
|
getMenuButtonBoundingClientRect(): HeadlessWxMenuButtonBoundingClientRectResult;
|
|
2075
2112
|
getLocation(): HeadlessWxGetLocationResult;
|
|
2076
2113
|
getNetworkType(): HeadlessWxGetNetworkTypeResult;
|
|
@@ -2172,6 +2209,8 @@ export declare class HeadlessSession {
|
|
|
2172
2209
|
fail?: (error: Error) => void;
|
|
2173
2210
|
complete?: () => void;
|
|
2174
2211
|
}): void;
|
|
2212
|
+
triggerAppHide(options: HeadlessWxAppHideOptions): void;
|
|
2213
|
+
triggerAppShow(options?: HeadlessWxLaunchOptions): void;
|
|
2175
2214
|
triggerPullDownRefresh(): HeadlessPageInstance;
|
|
2176
2215
|
startPullDownRefresh(): {
|
|
2177
2216
|
errMsg: string;
|
|
@@ -2219,6 +2258,7 @@ export declare class BrowserHeadlessSession {
|
|
|
2219
2258
|
readonly project: HeadlessProjectDescriptor;
|
|
2220
2259
|
private appDefinition;
|
|
2221
2260
|
private appInstance;
|
|
2261
|
+
private readonly appLifecycle;
|
|
2222
2262
|
private readonly moduleLoader;
|
|
2223
2263
|
private readonly onRender?;
|
|
2224
2264
|
private readonly registries;
|
|
@@ -2385,32 +2425,8 @@ export declare class BrowserHeadlessSession {
|
|
|
2385
2425
|
getWindowInfo(): HeadlessWxWindowInfoResult;
|
|
2386
2426
|
getAppBaseInfo(): HeadlessWxAppBaseInfoResult;
|
|
2387
2427
|
getDeviceInfo(): HeadlessWxDeviceInfoResult;
|
|
2388
|
-
getLaunchOptions():
|
|
2389
|
-
|
|
2390
|
-
[x: string]: string;
|
|
2391
|
-
};
|
|
2392
|
-
referrerInfo: {
|
|
2393
|
-
extraData: {
|
|
2394
|
-
[x: string]: never;
|
|
2395
|
-
};
|
|
2396
|
-
appId: string;
|
|
2397
|
-
};
|
|
2398
|
-
path: string;
|
|
2399
|
-
scene: number;
|
|
2400
|
-
};
|
|
2401
|
-
getEnterOptions(): {
|
|
2402
|
-
query: {
|
|
2403
|
-
[x: string]: string;
|
|
2404
|
-
};
|
|
2405
|
-
referrerInfo: {
|
|
2406
|
-
extraData: {
|
|
2407
|
-
[x: string]: never;
|
|
2408
|
-
};
|
|
2409
|
-
appId: string;
|
|
2410
|
-
};
|
|
2411
|
-
path: string;
|
|
2412
|
-
scene: number;
|
|
2413
|
-
};
|
|
2428
|
+
getLaunchOptions(): HeadlessWxLaunchOptions;
|
|
2429
|
+
getEnterOptions(): HeadlessWxLaunchOptions;
|
|
2414
2430
|
getMenuButtonBoundingClientRect(): HeadlessWxMenuButtonBoundingClientRectResult;
|
|
2415
2431
|
getLocation(): HeadlessWxGetLocationResult;
|
|
2416
2432
|
getNetworkType(): HeadlessWxGetNetworkTypeResult;
|
|
@@ -2552,6 +2568,8 @@ export declare class BrowserHeadlessSession {
|
|
|
2552
2568
|
selector?: string;
|
|
2553
2569
|
scrollTop?: number;
|
|
2554
2570
|
}): void;
|
|
2571
|
+
triggerAppHide(options: HeadlessWxAppHideOptions): void;
|
|
2572
|
+
triggerAppShow(options?: HeadlessWxLaunchOptions): void;
|
|
2555
2573
|
triggerPullDownRefresh(): HeadlessPageInstance;
|
|
2556
2574
|
startPullDownRefresh(): {
|
|
2557
2575
|
errMsg: string;
|
|
@@ -2663,8 +2681,10 @@ export declare class HeadlessTestingNodeHandle {
|
|
|
2663
2681
|
private readonly interactions?;
|
|
2664
2682
|
constructor(node: DomNodeLike$3, interactions?: HeadlessTestingNodeInteractionHandlers | undefined);
|
|
2665
2683
|
private assertActive;
|
|
2684
|
+
private query;
|
|
2666
2685
|
$(selector: string): Promise<HeadlessTestingNodeHandle | null>;
|
|
2667
2686
|
$$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
2687
|
+
getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
2668
2688
|
attr(name: string): Promise<string | undefined>;
|
|
2669
2689
|
dataset(): Promise<Record<string, string>>;
|
|
2670
2690
|
scope(): Promise<{
|
|
@@ -2804,6 +2824,8 @@ export declare class HeadlessTestingPageHandle {
|
|
|
2804
2824
|
private readonly page;
|
|
2805
2825
|
private readonly session?;
|
|
2806
2826
|
constructor(project: HeadlessProjectDescriptor, page: HeadlessPageInstance, session?: HeadlessSession | undefined);
|
|
2827
|
+
/** 返回底层页面实例身份;重新获取 handle 不会改变该身份。 */
|
|
2828
|
+
get pageId(): number;
|
|
2807
2829
|
get path(): string;
|
|
2808
2830
|
get query(): {
|
|
2809
2831
|
[x: string]: string;
|
|
@@ -2814,11 +2836,13 @@ export declare class HeadlessTestingPageHandle {
|
|
|
2814
2836
|
callMethod(methodName: string, ...args: any[]): Promise<any>;
|
|
2815
2837
|
callMethodWithOptions(methodName: string, options?: HeadlessTestingPageCallMethodOptions, ...args: any[]): Promise<any>;
|
|
2816
2838
|
data(path?: string): Promise<any>;
|
|
2839
|
+
setData(data: Record<string, unknown>): Promise<void>;
|
|
2817
2840
|
selectComponent(selector: string): Promise<HeadlessTestingScopeHandle | null>;
|
|
2818
2841
|
selectAllComponents(selector: string): Promise<HeadlessTestingScopeHandle[]>;
|
|
2819
2842
|
waitFor(ms?: number): Promise<void>;
|
|
2820
2843
|
$(selector: string): Promise<HeadlessTestingNodeHandle | null>;
|
|
2821
2844
|
$$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
2845
|
+
getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
2822
2846
|
renderedNodes(selector: string, options?: HeadlessTestingPageQueryOptions): Promise<HeadlessTestingRenderedNodeSnapshot[]>;
|
|
2823
2847
|
renderedSelectorNodes(selectors: string[], options?: HeadlessTestingPageQueryOptions): Promise<HeadlessTestingRenderedSelectorNodesSnapshot>;
|
|
2824
2848
|
waitForRendered(options?: HeadlessTestingRenderedOptions): Promise<string>;
|
|
@@ -2933,10 +2957,13 @@ export declare class HeadlessTestingSessionHandle {
|
|
|
2933
2957
|
switchTab(route: string): Promise<HeadlessTestingPageHandle>;
|
|
2934
2958
|
waitForCurrentPage(route?: string, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingPageHandle>;
|
|
2935
2959
|
pageScrollTo(scrollTop: number): Promise<void>;
|
|
2960
|
+
triggerAppHide(options: HeadlessWxAppHideOptions): Promise<void>;
|
|
2961
|
+
triggerAppShow(options?: HeadlessWxLaunchOptions): Promise<void>;
|
|
2936
2962
|
triggerPullDownRefresh(): Promise<void>;
|
|
2937
2963
|
triggerReachBottom(): Promise<void>;
|
|
2938
2964
|
triggerResize(options: Record<string, any>): Promise<void>;
|
|
2939
2965
|
triggerRouteDone(options?: Record<string, any>): Promise<void>;
|
|
2966
|
+
private invokeNavigation;
|
|
2940
2967
|
private requireCurrentPage;
|
|
2941
2968
|
private evaluateInRuntime;
|
|
2942
2969
|
}
|
|
@@ -2944,7 +2971,9 @@ export declare class HeadlessTestingSessionHandle {
|
|
|
2944
2971
|
//#region src/testing/launch.d.ts
|
|
2945
2972
|
export interface HeadlessTestingLaunchOptions {
|
|
2946
2973
|
projectPath: string;
|
|
2974
|
+
configureSession?: (session: HeadlessSession) => void | Promise<void>;
|
|
2975
|
+
onSessionCreated?: (session: HeadlessTestingSessionHandle) => void | Promise<void>;
|
|
2947
2976
|
}
|
|
2948
2977
|
export declare function launch(options: HeadlessTestingLaunchOptions): Promise<HeadlessTestingSessionHandle>;
|
|
2949
2978
|
//#endregion
|
|
2950
|
-
export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingToolInfo, RuntimeRenderedPageTree, RuntimeRendererContext };
|
|
2979
|
+
export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingToolInfo, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };
|