@mpcore/simulator 0.7.0 → 1.1.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 +51 -0
- package/dist/index.d.mts +259 -154
- package/dist/index.mjs +2437 -890
- package/package.json +8 -6
package/dist/index.d.mts
CHANGED
|
@@ -1021,6 +1021,28 @@ export interface HeadlessWxDriverCapabilities {
|
|
|
1021
1021
|
};
|
|
1022
1022
|
}
|
|
1023
1023
|
//#endregion
|
|
1024
|
+
//#region src/host/wx/workers.d.ts
|
|
1025
|
+
export interface HeadlessWorker {
|
|
1026
|
+
onMessage: (listener: (message: any) => void) => void;
|
|
1027
|
+
offMessage: (listener?: (message: any) => void) => void;
|
|
1028
|
+
postMessage: (message: unknown) => void;
|
|
1029
|
+
onError: (listener: (error: {
|
|
1030
|
+
message: string;
|
|
1031
|
+
}) => void) => void;
|
|
1032
|
+
offError: (listener?: (error: {
|
|
1033
|
+
message: string;
|
|
1034
|
+
}) => void) => void;
|
|
1035
|
+
terminate: () => void;
|
|
1036
|
+
}
|
|
1037
|
+
export interface HeadlessWorkerApis {
|
|
1038
|
+
createWorker: (scriptPath: string) => HeadlessWorker;
|
|
1039
|
+
preDownloadSubpackage: (options: HeadlessWxCallbackOption<{
|
|
1040
|
+
errMsg: string;
|
|
1041
|
+
}> & {
|
|
1042
|
+
packageType: 'workers';
|
|
1043
|
+
}) => void;
|
|
1044
|
+
}
|
|
1045
|
+
//#endregion
|
|
1024
1046
|
//#region src/host/wx/api.d.ts
|
|
1025
1047
|
/** 宿主已接受的一次路由操作;同一次操作的所有阶段共用事件标识。 */
|
|
1026
1048
|
export interface HeadlessWxRouteEvent {
|
|
@@ -1032,6 +1054,8 @@ export interface HeadlessWxRouteEvent {
|
|
|
1032
1054
|
routeEventId: string;
|
|
1033
1055
|
timeStamp: number;
|
|
1034
1056
|
}
|
|
1057
|
+
/** 路由动画完成只提供路由身份,不携带接受路由时的渲染引擎字段。 */
|
|
1058
|
+
export type HeadlessWxRouteDoneEvent = Omit<HeadlessWxRouteEvent, 'renderer'>;
|
|
1035
1059
|
/** 页面销毁前的原生实例,仍可同步读取页面数据。 */
|
|
1036
1060
|
export interface HeadlessWxBeforePageUnloadEvent extends HeadlessWxRouteEvent {
|
|
1037
1061
|
page: HeadlessPageInstance;
|
|
@@ -1043,8 +1067,8 @@ export interface HeadlessWxRouteListeners {
|
|
|
1043
1067
|
offBeforePageUnload: (listener?: (event: HeadlessWxBeforePageUnloadEvent) => void) => void;
|
|
1044
1068
|
onAppRoute: (listener: (event: HeadlessWxRouteEvent) => void) => void;
|
|
1045
1069
|
offAppRoute: (listener?: (event: HeadlessWxRouteEvent) => void) => void;
|
|
1046
|
-
onAppRouteDone: (listener: (event:
|
|
1047
|
-
offAppRouteDone: (listener?: (event:
|
|
1070
|
+
onAppRouteDone: (listener: (event: HeadlessWxRouteDoneEvent) => void) => void;
|
|
1071
|
+
offAppRouteDone: (listener?: (event: HeadlessWxRouteDoneEvent) => void) => void;
|
|
1048
1072
|
}
|
|
1049
1073
|
export interface HeadlessWxDriver extends HeadlessWxDriverCapabilities, HeadlessWxRouteListeners {
|
|
1050
1074
|
chooseImage: (option: HeadlessWxChooseImageOption) => HeadlessWxChooseImageResult;
|
|
@@ -1072,7 +1096,7 @@ export interface HeadlessWxDriver extends HeadlessWxDriverCapabilities, Headless
|
|
|
1072
1096
|
canvasToTempFilePath: (option: HeadlessWxCanvasToTempFilePathOption) => HeadlessWxCanvasToTempFilePathSuccessResult;
|
|
1073
1097
|
uploadFile: (option: HeadlessWxUploadFileOption) => HeadlessWxRequestTask;
|
|
1074
1098
|
}
|
|
1075
|
-
export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListeners {
|
|
1099
|
+
export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListeners, HeadlessWorkerApis {
|
|
1076
1100
|
[WEVU_ROUTE_EVENT_CONTRACT_KEY]: 1;
|
|
1077
1101
|
[WEVU_PAGE_SCROLL_EVENT_CONTRACT_KEY]: 1;
|
|
1078
1102
|
canIUse: (schema: string) => boolean;
|
|
@@ -1214,10 +1238,11 @@ export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListener
|
|
|
1214
1238
|
}
|
|
1215
1239
|
//#endregion
|
|
1216
1240
|
//#region src/host/wx/index.d.ts
|
|
1217
|
-
export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'
|
|
1241
|
+
export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'>, workers?: HeadlessWorkerApis): HeadlessWx;
|
|
1218
1242
|
//#endregion
|
|
1219
1243
|
//#region src/kernel/artifactSource.d.ts
|
|
1220
1244
|
export interface ArtifactSource {
|
|
1245
|
+
/** 判断产物文件是否存在,目录不属于产物。 */
|
|
1221
1246
|
has: (filePath: string) => boolean;
|
|
1222
1247
|
readText: (filePath: string) => string | undefined;
|
|
1223
1248
|
}
|
|
@@ -1377,6 +1402,7 @@ export interface BrowserModuleLoader {
|
|
|
1377
1402
|
executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
|
|
1378
1403
|
executeAppModule: (filePath: string) => HeadlessAppDefinition;
|
|
1379
1404
|
executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
|
|
1405
|
+
reloadPageModule: (filePath: string, route: string) => boolean;
|
|
1380
1406
|
wx: HeadlessWx;
|
|
1381
1407
|
}
|
|
1382
1408
|
export declare function createBrowserModuleLoader(files: BrowserVirtualFiles, registries: HeadlessHostRegistries, getCurrentPages: () => any[], getApp: () => any, wxDriver: Parameters<typeof createHeadlessWx>[0], options: {
|
|
@@ -1396,6 +1422,159 @@ export interface CreateBrowserProjectOptions {
|
|
|
1396
1422
|
}
|
|
1397
1423
|
export declare function createBrowserProject(files: BrowserVirtualFiles, options?: CreateBrowserProjectOptions): HeadlessProjectDescriptor;
|
|
1398
1424
|
//#endregion
|
|
1425
|
+
//#region src/view/nodeEvents.d.ts
|
|
1426
|
+
interface HeadlessTestingTouch {
|
|
1427
|
+
identifier?: number;
|
|
1428
|
+
pageX?: number;
|
|
1429
|
+
pageY?: number;
|
|
1430
|
+
clientX?: number;
|
|
1431
|
+
clientY?: number;
|
|
1432
|
+
}
|
|
1433
|
+
interface HeadlessTestingTouchEventInit {
|
|
1434
|
+
touches?: HeadlessTestingTouch[];
|
|
1435
|
+
changedTouches?: HeadlessTestingTouch[];
|
|
1436
|
+
/** @deprecated 请改用与微信事件一致的 changedTouches。 */
|
|
1437
|
+
changeTouches?: HeadlessTestingTouch[];
|
|
1438
|
+
}
|
|
1439
|
+
interface HeadlessTestingNodeEventInit extends HeadlessTestingTouchEventInit {
|
|
1440
|
+
currentTarget?: {
|
|
1441
|
+
dataset?: Record<string, unknown>;
|
|
1442
|
+
id?: string;
|
|
1443
|
+
};
|
|
1444
|
+
dataset?: Record<string, unknown>;
|
|
1445
|
+
detail?: unknown;
|
|
1446
|
+
id?: string;
|
|
1447
|
+
mark?: Record<string, unknown>;
|
|
1448
|
+
target?: {
|
|
1449
|
+
dataset?: Record<string, unknown>;
|
|
1450
|
+
id?: string;
|
|
1451
|
+
};
|
|
1452
|
+
}
|
|
1453
|
+
interface HeadlessTestingNodeValueEventInit extends HeadlessTestingNodeEventInit {
|
|
1454
|
+
detail?: {
|
|
1455
|
+
value?: string;
|
|
1456
|
+
[key: string]: unknown;
|
|
1457
|
+
};
|
|
1458
|
+
}
|
|
1459
|
+
interface HeadlessTestingDispatchEventInit extends HeadlessTestingNodeEventInit {
|
|
1460
|
+
eventName: string;
|
|
1461
|
+
$?: string;
|
|
1462
|
+
}
|
|
1463
|
+
//#endregion
|
|
1464
|
+
//#region src/view/nodeHandle.d.ts
|
|
1465
|
+
interface DomNodeLike$5 {
|
|
1466
|
+
attribs?: Record<string, string>;
|
|
1467
|
+
children?: DomNodeLike$5[];
|
|
1468
|
+
data?: string;
|
|
1469
|
+
dataset?: Record<string, unknown>;
|
|
1470
|
+
name?: string;
|
|
1471
|
+
parent?: DomNodeLike$5 | null;
|
|
1472
|
+
type?: string;
|
|
1473
|
+
}
|
|
1474
|
+
interface HeadlessTestingNodeInteractionHandlers {
|
|
1475
|
+
assertActive?: () => void;
|
|
1476
|
+
callMethod: (scopeId: string | null, methodName: string, event: Record<string, any>) => unknown;
|
|
1477
|
+
dispatchNativeEvent?: (node: DomNodeLike$5, eventName: string, event: HeadlessTestingNodeEventInit, onHandlerResult?: (result: unknown) => void) => boolean;
|
|
1478
|
+
createScopeHandle: (scopeId: string | null) => {
|
|
1479
|
+
scopeId: string;
|
|
1480
|
+
snapshot: () => Promise<unknown>;
|
|
1481
|
+
} | null;
|
|
1482
|
+
createPageHandle: () => {
|
|
1483
|
+
data: (path?: string) => Promise<unknown>;
|
|
1484
|
+
};
|
|
1485
|
+
ownerScopeId: (scopeId: string | null) => string | null;
|
|
1486
|
+
projectionOnly?: boolean;
|
|
1487
|
+
}
|
|
1488
|
+
export declare class HeadlessTestingNodeHandle {
|
|
1489
|
+
private readonly node;
|
|
1490
|
+
private readonly interactions?;
|
|
1491
|
+
constructor(node: DomNodeLike$5, interactions?: HeadlessTestingNodeInteractionHandlers | undefined);
|
|
1492
|
+
private assertActive;
|
|
1493
|
+
private query;
|
|
1494
|
+
$(selector: string): Promise<HeadlessTestingNodeHandle | null>;
|
|
1495
|
+
$$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
1496
|
+
getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
1497
|
+
attr(name: string): Promise<string | undefined>;
|
|
1498
|
+
dataset(): Promise<Record<string, unknown>>;
|
|
1499
|
+
scope(): Promise<{
|
|
1500
|
+
scopeId: string;
|
|
1501
|
+
snapshot: () => Promise<unknown>;
|
|
1502
|
+
} | null>;
|
|
1503
|
+
componentScope(): Promise<{
|
|
1504
|
+
scopeId: string;
|
|
1505
|
+
snapshot: () => Promise<unknown>;
|
|
1506
|
+
} | null>;
|
|
1507
|
+
pageScope(): Promise<{
|
|
1508
|
+
scopeId: string;
|
|
1509
|
+
snapshot: () => Promise<unknown>;
|
|
1510
|
+
} | null>;
|
|
1511
|
+
page(): Promise<{
|
|
1512
|
+
data: (path?: string) => Promise<unknown>;
|
|
1513
|
+
}>;
|
|
1514
|
+
ownerComponentScope(): Promise<{
|
|
1515
|
+
scopeId: string;
|
|
1516
|
+
snapshot: () => Promise<unknown>;
|
|
1517
|
+
} | null>;
|
|
1518
|
+
text(): Promise<string>;
|
|
1519
|
+
tagName(): Promise<string | undefined>;
|
|
1520
|
+
trigger(eventName: string, event?: HeadlessTestingNodeEventInit): Promise<unknown>;
|
|
1521
|
+
tap(event?: HeadlessTestingNodeEventInit): Promise<unknown>;
|
|
1522
|
+
touchstart(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
|
|
1523
|
+
touchmove(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
|
|
1524
|
+
touchend(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
|
|
1525
|
+
dispatchEvent({ eventName, $: selector, ...event }: HeadlessTestingDispatchEventInit): Promise<unknown>;
|
|
1526
|
+
input(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
|
|
1527
|
+
change(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
|
|
1528
|
+
blur(value?: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
|
|
1529
|
+
wxml(): Promise<string>;
|
|
1530
|
+
}
|
|
1531
|
+
//#endregion
|
|
1532
|
+
//#region src/view/eventBinding.d.ts
|
|
1533
|
+
export interface MiniProgramEventBinding {
|
|
1534
|
+
method: string;
|
|
1535
|
+
stopAfter: boolean;
|
|
1536
|
+
}
|
|
1537
|
+
export declare function collectMiniProgramEventBindings(attributes?: Record<string, string>): Map<string, MiniProgramEventBinding>;
|
|
1538
|
+
export declare function resolveMiniProgramEventBinding(attributes: Record<string, string> | undefined, eventName: string): MiniProgramEventBinding | null;
|
|
1539
|
+
/** 冒泡时保留原始 target,currentTarget 则属于当前执行绑定的节点。 */
|
|
1540
|
+
export declare function createMiniProgramEventPayload(node: {
|
|
1541
|
+
attribs?: Record<string, string>;
|
|
1542
|
+
dataset?: Record<string, unknown>;
|
|
1543
|
+
}, eventName: string, event: HeadlessTestingNodeEventInit, origin?: {
|
|
1544
|
+
attribs?: Record<string, string>;
|
|
1545
|
+
dataset?: Record<string, unknown>;
|
|
1546
|
+
}): {
|
|
1547
|
+
bubbles: boolean;
|
|
1548
|
+
capturePhase: boolean;
|
|
1549
|
+
composed: boolean;
|
|
1550
|
+
currentTarget: {
|
|
1551
|
+
dataset: Record<string, unknown>;
|
|
1552
|
+
id: string;
|
|
1553
|
+
};
|
|
1554
|
+
detail: unknown;
|
|
1555
|
+
mark: Record<string, unknown> | undefined;
|
|
1556
|
+
target: {
|
|
1557
|
+
dataset: Record<string, unknown>;
|
|
1558
|
+
id: string;
|
|
1559
|
+
};
|
|
1560
|
+
timeStamp: number;
|
|
1561
|
+
type: string;
|
|
1562
|
+
changedTouches?: {
|
|
1563
|
+
identifier?: number;
|
|
1564
|
+
pageX?: number;
|
|
1565
|
+
pageY?: number;
|
|
1566
|
+
clientX?: number;
|
|
1567
|
+
clientY?: number;
|
|
1568
|
+
}[] | undefined;
|
|
1569
|
+
touches?: {
|
|
1570
|
+
identifier?: number;
|
|
1571
|
+
pageX?: number;
|
|
1572
|
+
pageY?: number;
|
|
1573
|
+
clientX?: number;
|
|
1574
|
+
clientY?: number;
|
|
1575
|
+
}[] | undefined;
|
|
1576
|
+
};
|
|
1577
|
+
//#endregion
|
|
1399
1578
|
//#region src/view/wxs.d.ts
|
|
1400
1579
|
type WxsModuleBindings = Record<string, unknown>;
|
|
1401
1580
|
//#endregion
|
|
@@ -1431,13 +1610,13 @@ export declare function resolveBrowserPageStyles(files: BrowserVirtualFiles, rou
|
|
|
1431
1610
|
}): BrowserPageStyles;
|
|
1432
1611
|
//#endregion
|
|
1433
1612
|
//#region src/browser/render/types.d.ts
|
|
1434
|
-
interface DomNodeLike$
|
|
1613
|
+
interface DomNodeLike$4 {
|
|
1435
1614
|
attribs?: Record<string, string>;
|
|
1436
|
-
children?: DomNodeLike$
|
|
1615
|
+
children?: DomNodeLike$4[];
|
|
1437
1616
|
data?: string;
|
|
1438
1617
|
dataset?: Record<string, unknown>;
|
|
1439
1618
|
name?: string;
|
|
1440
|
-
parent?: DomNodeLike$
|
|
1619
|
+
parent?: DomNodeLike$4 | null;
|
|
1441
1620
|
type?: string;
|
|
1442
1621
|
}
|
|
1443
1622
|
interface BrowserRenderScope {
|
|
@@ -1446,14 +1625,13 @@ interface BrowserRenderScope {
|
|
|
1446
1625
|
classList?: string[];
|
|
1447
1626
|
data: Record<string, any>;
|
|
1448
1627
|
dataset?: Record<string, unknown>;
|
|
1449
|
-
eventBindings?: Map<string,
|
|
1450
|
-
|
|
1451
|
-
stopAfter: boolean;
|
|
1452
|
-
}>;
|
|
1628
|
+
eventBindings?: Map<string, MiniProgramEventBinding>;
|
|
1629
|
+
captureEventBindings?: Map<string, MiniProgramEventBinding>;
|
|
1453
1630
|
getMethod: (methodName: string) => ((...args: any[]) => any) | undefined;
|
|
1454
1631
|
getScopeId: () => string;
|
|
1455
1632
|
genericComponents?: Map<string, string>;
|
|
1456
1633
|
hostId?: string;
|
|
1634
|
+
hostNode?: DomNodeLike$4;
|
|
1457
1635
|
listenerScopeId?: string;
|
|
1458
1636
|
id?: string;
|
|
1459
1637
|
ownerScopeId?: string;
|
|
@@ -1461,14 +1639,14 @@ interface BrowserRenderScope {
|
|
|
1461
1639
|
}
|
|
1462
1640
|
interface BrowserSlotContent {
|
|
1463
1641
|
instancePath: string;
|
|
1464
|
-
node: DomNodeLike$
|
|
1642
|
+
node: DomNodeLike$4;
|
|
1465
1643
|
ownerFilePath: string;
|
|
1466
1644
|
ownerJsonPath: string;
|
|
1467
1645
|
scope: BrowserRenderScope;
|
|
1468
|
-
templateRenderState: TemplateRenderState<DomNodeLike$
|
|
1646
|
+
templateRenderState: TemplateRenderState<DomNodeLike$4>;
|
|
1469
1647
|
}
|
|
1470
1648
|
interface BrowserRenderedPageTree {
|
|
1471
|
-
root: DomNodeLike$
|
|
1649
|
+
root: DomNodeLike$4;
|
|
1472
1650
|
styles: BrowserPageStyles;
|
|
1473
1651
|
wxml: string;
|
|
1474
1652
|
}
|
|
@@ -1477,6 +1655,7 @@ interface BrowserRendererContext {
|
|
|
1477
1655
|
componentCache: Map<string, HeadlessComponentInstance>;
|
|
1478
1656
|
componentScopes: Map<string, BrowserRenderScope>;
|
|
1479
1657
|
files: BrowserVirtualFiles;
|
|
1658
|
+
templateSource?: Pick<ArtifactSource, 'readText'>;
|
|
1480
1659
|
moduleLoader: BrowserModuleLoader;
|
|
1481
1660
|
project: HeadlessProjectDescriptor;
|
|
1482
1661
|
session: {
|
|
@@ -1505,17 +1684,18 @@ interface HeadlessModuleLoader {
|
|
|
1505
1684
|
executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
|
|
1506
1685
|
executeAppModule: (filePath: string) => HeadlessAppDefinition;
|
|
1507
1686
|
executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
|
|
1687
|
+
reloadPageModule: (filePath: string, route: string) => boolean;
|
|
1508
1688
|
wx: HeadlessWx;
|
|
1509
1689
|
}
|
|
1510
1690
|
//#endregion
|
|
1511
1691
|
//#region src/runtime/render/types.d.ts
|
|
1512
|
-
interface DomNodeLike$
|
|
1692
|
+
interface DomNodeLike$3 {
|
|
1513
1693
|
attribs?: Record<string, string>;
|
|
1514
|
-
children?: DomNodeLike$
|
|
1694
|
+
children?: DomNodeLike$3[];
|
|
1515
1695
|
data?: string;
|
|
1516
1696
|
dataset?: Record<string, unknown>;
|
|
1517
1697
|
name?: string;
|
|
1518
|
-
parent?: DomNodeLike$
|
|
1698
|
+
parent?: DomNodeLike$3 | null;
|
|
1519
1699
|
type?: string;
|
|
1520
1700
|
}
|
|
1521
1701
|
interface RuntimeRenderScope {
|
|
@@ -1524,14 +1704,13 @@ interface RuntimeRenderScope {
|
|
|
1524
1704
|
classList?: string[];
|
|
1525
1705
|
data: Record<string, any>;
|
|
1526
1706
|
dataset?: Record<string, unknown>;
|
|
1527
|
-
eventBindings?: Map<string,
|
|
1528
|
-
|
|
1529
|
-
stopAfter: boolean;
|
|
1530
|
-
}>;
|
|
1707
|
+
eventBindings?: Map<string, MiniProgramEventBinding>;
|
|
1708
|
+
captureEventBindings?: Map<string, MiniProgramEventBinding>;
|
|
1531
1709
|
getMethod: (methodName: string) => ((...args: any[]) => any) | undefined;
|
|
1532
1710
|
getScopeId: () => string;
|
|
1533
1711
|
genericComponents?: Map<string, string>;
|
|
1534
1712
|
hostId?: string;
|
|
1713
|
+
hostNode?: DomNodeLike$3;
|
|
1535
1714
|
listenerScopeId?: string;
|
|
1536
1715
|
id?: string;
|
|
1537
1716
|
ownerScopeId?: string;
|
|
@@ -1539,14 +1718,14 @@ interface RuntimeRenderScope {
|
|
|
1539
1718
|
}
|
|
1540
1719
|
interface RuntimeSlotContent {
|
|
1541
1720
|
instancePath: string;
|
|
1542
|
-
node: DomNodeLike$
|
|
1721
|
+
node: DomNodeLike$3;
|
|
1543
1722
|
ownerFilePath: string;
|
|
1544
1723
|
ownerJsonPath: string;
|
|
1545
1724
|
scope: RuntimeRenderScope;
|
|
1546
|
-
templateRenderState: TemplateRenderState<DomNodeLike$
|
|
1725
|
+
templateRenderState: TemplateRenderState<DomNodeLike$3>;
|
|
1547
1726
|
}
|
|
1548
1727
|
interface RuntimeRenderedPageTree {
|
|
1549
|
-
root: DomNodeLike$
|
|
1728
|
+
root: DomNodeLike$3;
|
|
1550
1729
|
wxml: string;
|
|
1551
1730
|
}
|
|
1552
1731
|
interface RuntimeRendererContext {
|
|
@@ -1569,89 +1748,6 @@ interface RuntimeRendererContext {
|
|
|
1569
1748
|
//#region src/runtime/render/index.d.ts
|
|
1570
1749
|
export declare function renderRuntimePageTree(context: RuntimeRendererContext, page: HeadlessPageInstance): RuntimeRenderedPageTree;
|
|
1571
1750
|
//#endregion
|
|
1572
|
-
//#region src/view/nodeHandle.d.ts
|
|
1573
|
-
interface DomNodeLike$3 {
|
|
1574
|
-
attribs?: Record<string, string>;
|
|
1575
|
-
children?: DomNodeLike$3[];
|
|
1576
|
-
data?: string;
|
|
1577
|
-
dataset?: Record<string, unknown>;
|
|
1578
|
-
name?: string;
|
|
1579
|
-
parent?: DomNodeLike$3 | null;
|
|
1580
|
-
type?: string;
|
|
1581
|
-
}
|
|
1582
|
-
export interface HeadlessTestingNodeEventInit {
|
|
1583
|
-
currentTarget?: {
|
|
1584
|
-
dataset?: Record<string, unknown>;
|
|
1585
|
-
id?: string;
|
|
1586
|
-
};
|
|
1587
|
-
dataset?: Record<string, unknown>;
|
|
1588
|
-
detail?: unknown;
|
|
1589
|
-
id?: string;
|
|
1590
|
-
mark?: Record<string, unknown>;
|
|
1591
|
-
target?: {
|
|
1592
|
-
dataset?: Record<string, unknown>;
|
|
1593
|
-
id?: string;
|
|
1594
|
-
};
|
|
1595
|
-
}
|
|
1596
|
-
export interface HeadlessTestingNodeValueEventInit extends HeadlessTestingNodeEventInit {
|
|
1597
|
-
detail?: {
|
|
1598
|
-
value?: string;
|
|
1599
|
-
[key: string]: unknown;
|
|
1600
|
-
};
|
|
1601
|
-
}
|
|
1602
|
-
interface HeadlessTestingNodeInteractionHandlers {
|
|
1603
|
-
assertActive?: () => void;
|
|
1604
|
-
callMethod: (scopeId: string | null, methodName: string, event: Record<string, any>) => unknown;
|
|
1605
|
-
dispatchNativeEvent?: (node: DomNodeLike$3, eventName: string, event: HeadlessTestingNodeEventInit, onHandlerResult?: (result: unknown) => void) => boolean;
|
|
1606
|
-
createScopeHandle: (scopeId: string | null) => {
|
|
1607
|
-
scopeId: string;
|
|
1608
|
-
snapshot: () => Promise<unknown>;
|
|
1609
|
-
} | null;
|
|
1610
|
-
createPageHandle: () => {
|
|
1611
|
-
data: (path?: string) => Promise<unknown>;
|
|
1612
|
-
};
|
|
1613
|
-
ownerScopeId: (scopeId: string | null) => string | null;
|
|
1614
|
-
}
|
|
1615
|
-
export declare class HeadlessTestingNodeHandle {
|
|
1616
|
-
private readonly node;
|
|
1617
|
-
private readonly interactions?;
|
|
1618
|
-
constructor(node: DomNodeLike$3, interactions?: HeadlessTestingNodeInteractionHandlers | undefined);
|
|
1619
|
-
private assertActive;
|
|
1620
|
-
private query;
|
|
1621
|
-
$(selector: string): Promise<HeadlessTestingNodeHandle | null>;
|
|
1622
|
-
$$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
1623
|
-
getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
|
|
1624
|
-
attr(name: string): Promise<string | undefined>;
|
|
1625
|
-
dataset(): Promise<Record<string, unknown>>;
|
|
1626
|
-
scope(): Promise<{
|
|
1627
|
-
scopeId: string;
|
|
1628
|
-
snapshot: () => Promise<unknown>;
|
|
1629
|
-
} | null>;
|
|
1630
|
-
componentScope(): Promise<{
|
|
1631
|
-
scopeId: string;
|
|
1632
|
-
snapshot: () => Promise<unknown>;
|
|
1633
|
-
} | null>;
|
|
1634
|
-
pageScope(): Promise<{
|
|
1635
|
-
scopeId: string;
|
|
1636
|
-
snapshot: () => Promise<unknown>;
|
|
1637
|
-
} | null>;
|
|
1638
|
-
page(): Promise<{
|
|
1639
|
-
data: (path?: string) => Promise<unknown>;
|
|
1640
|
-
}>;
|
|
1641
|
-
ownerComponentScope(): Promise<{
|
|
1642
|
-
scopeId: string;
|
|
1643
|
-
snapshot: () => Promise<unknown>;
|
|
1644
|
-
} | null>;
|
|
1645
|
-
text(): Promise<string>;
|
|
1646
|
-
tagName(): Promise<string | undefined>;
|
|
1647
|
-
trigger(eventName: string, event?: HeadlessTestingNodeEventInit): Promise<unknown>;
|
|
1648
|
-
tap(event?: HeadlessTestingNodeEventInit): Promise<unknown>;
|
|
1649
|
-
input(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
|
|
1650
|
-
change(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
|
|
1651
|
-
blur(value?: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
|
|
1652
|
-
wxml(): Promise<string>;
|
|
1653
|
-
}
|
|
1654
|
-
//#endregion
|
|
1655
1751
|
//#region src/view/nativeNode.d.ts
|
|
1656
1752
|
interface HeadlessNativeNode {
|
|
1657
1753
|
attribs?: Record<string, string>;
|
|
@@ -2053,6 +2149,8 @@ export declare function createHeadlessWxState(scheduler?: Pick<RuntimeScheduler,
|
|
|
2053
2149
|
//#endregion
|
|
2054
2150
|
//#region src/runtime/session.d.ts
|
|
2055
2151
|
export interface HeadlessSessionOptions {
|
|
2152
|
+
/** 相对小程序根目录的编译模板路径;仅在显式宿主重载时提交新版本。 */
|
|
2153
|
+
compiledTemplatePaths?: readonly string[];
|
|
2056
2154
|
globals?: Record<string, unknown>;
|
|
2057
2155
|
project?: HeadlessProjectDescriptor;
|
|
2058
2156
|
projectPath?: string;
|
|
@@ -2066,6 +2164,7 @@ export declare class HeadlessSession {
|
|
|
2066
2164
|
private appInstance;
|
|
2067
2165
|
private readonly appLifecycle;
|
|
2068
2166
|
private readonly moduleLoader;
|
|
2167
|
+
private readonly templateRegistration;
|
|
2069
2168
|
private readonly routeEvents;
|
|
2070
2169
|
private readonly eventListeners;
|
|
2071
2170
|
private readonly registries;
|
|
@@ -2074,8 +2173,7 @@ export declare class HeadlessSession {
|
|
|
2074
2173
|
private readonly componentCache;
|
|
2075
2174
|
private readonly componentScopes;
|
|
2076
2175
|
private readonly selectorQueryScopeSnapshots;
|
|
2077
|
-
private
|
|
2078
|
-
private readonly renderRequestCallbacks;
|
|
2176
|
+
private readonly renderQueue;
|
|
2079
2177
|
private readonly tabBarRoutes;
|
|
2080
2178
|
private readonly tabPages;
|
|
2081
2179
|
private readonly tabBarItems;
|
|
@@ -2098,6 +2196,10 @@ export declare class HeadlessSession {
|
|
|
2098
2196
|
get isClosed(): boolean;
|
|
2099
2197
|
getApp(): HeadlessAppInstance | null;
|
|
2100
2198
|
getCurrentPages(): HeadlessPageInstance[];
|
|
2199
|
+
/** 显式重载已变更的页面 entry,保留 App 与依赖缓存;调用者随后自行导航。 */
|
|
2200
|
+
reloadPageDefinition(route: string): boolean;
|
|
2201
|
+
/** 显式提交编译模板及其 import/include 依赖;不重载脚本、不导航或替换实例。 */
|
|
2202
|
+
reloadTemplates(): boolean;
|
|
2101
2203
|
getWx(): HeadlessWx;
|
|
2102
2204
|
/** 在当前小程序实例的上下文执行测试函数,复用应用全局对象与调度器。 */
|
|
2103
2205
|
evaluateRuntime<T = unknown>(source: string, args?: any[]): T;
|
|
@@ -2415,6 +2517,8 @@ export declare function createHeadlessSession(options: HeadlessSessionOptions):
|
|
|
2415
2517
|
//#endregion
|
|
2416
2518
|
//#region src/browser/session.d.ts
|
|
2417
2519
|
export interface BrowserHeadlessSessionOptions {
|
|
2520
|
+
/** 相对小程序根目录的编译模板路径;仅在显式宿主重载时提交新版本。 */
|
|
2521
|
+
compiledTemplatePaths?: readonly string[];
|
|
2418
2522
|
files: BrowserVirtualFiles;
|
|
2419
2523
|
globals?: Record<string, unknown>;
|
|
2420
2524
|
/** 返回的 Promise 表示宿主 DOM 已提交;普通返回值按同步渲染处理。 */
|
|
@@ -2429,6 +2533,7 @@ export declare class BrowserHeadlessSession {
|
|
|
2429
2533
|
private appInstance;
|
|
2430
2534
|
private readonly appLifecycle;
|
|
2431
2535
|
private readonly moduleLoader;
|
|
2536
|
+
private readonly templateRegistration;
|
|
2432
2537
|
private readonly onRender?;
|
|
2433
2538
|
private readonly registries;
|
|
2434
2539
|
private currentPageInstance;
|
|
@@ -2436,9 +2541,7 @@ export declare class BrowserHeadlessSession {
|
|
|
2436
2541
|
private readonly componentCache;
|
|
2437
2542
|
private readonly componentScopes;
|
|
2438
2543
|
private readonly selectorQueryScopeSnapshots;
|
|
2439
|
-
private
|
|
2440
|
-
private renderInProgress;
|
|
2441
|
-
private readonly renderRequestCallbacks;
|
|
2544
|
+
private readonly renderQueue;
|
|
2442
2545
|
private readonly tabBarRoutes;
|
|
2443
2546
|
private readonly tabPages;
|
|
2444
2547
|
private readonly tabBarItems;
|
|
@@ -2461,6 +2564,10 @@ export declare class BrowserHeadlessSession {
|
|
|
2461
2564
|
get isClosed(): boolean;
|
|
2462
2565
|
getApp(): HeadlessAppInstance | null;
|
|
2463
2566
|
getCurrentPages(): HeadlessPageInstance[];
|
|
2567
|
+
/** 显式重载已变更的页面 entry,保留 App 与依赖缓存;调用者随后自行导航。 */
|
|
2568
|
+
reloadPageDefinition(route: string): boolean;
|
|
2569
|
+
/** 显式提交编译模板及其 import/include 依赖;不重载脚本、不导航或替换实例。 */
|
|
2570
|
+
reloadTemplates(): boolean;
|
|
2464
2571
|
getCurrentPageNavigationBarTitle(): string | null;
|
|
2465
2572
|
getCurrentPageNavigationBar(): {
|
|
2466
2573
|
animation: {
|
|
@@ -2806,38 +2913,6 @@ export declare function waitForPageText<NodeHandle, ScopeHandle>(access: Headles
|
|
|
2806
2913
|
export declare function waitForPageTextGone<NodeHandle, ScopeHandle>(access: HeadlessTestingPageWaitAccess<NodeHandle, ScopeHandle>, text: string, options?: HeadlessTestingWaitOptions): Promise<void>;
|
|
2807
2914
|
export declare function waitForPageData<NodeHandle, ScopeHandle>(access: HeadlessTestingPageWaitAccess<NodeHandle, ScopeHandle>, path: string, matcher: HeadlessTestingDataMatcher, hasMatcher: boolean, options?: HeadlessTestingWaitOptions): Promise<{}>;
|
|
2808
2915
|
//#endregion
|
|
2809
|
-
//#region src/view/eventBinding.d.ts
|
|
2810
|
-
export interface MiniProgramEventBinding {
|
|
2811
|
-
method: string;
|
|
2812
|
-
stopAfter: boolean;
|
|
2813
|
-
}
|
|
2814
|
-
export declare function collectMiniProgramEventBindings(attributes?: Record<string, string>): Map<string, MiniProgramEventBinding>;
|
|
2815
|
-
export declare function resolveMiniProgramEventBinding(attributes: Record<string, string> | undefined, eventName: string): MiniProgramEventBinding | null;
|
|
2816
|
-
/** 冒泡时保留原始 target,currentTarget 则属于当前执行绑定的节点。 */
|
|
2817
|
-
export declare function createMiniProgramEventPayload(node: {
|
|
2818
|
-
attribs?: Record<string, string>;
|
|
2819
|
-
dataset?: Record<string, unknown>;
|
|
2820
|
-
}, eventName: string, event: HeadlessTestingNodeEventInit, origin?: {
|
|
2821
|
-
attribs?: Record<string, string>;
|
|
2822
|
-
dataset?: Record<string, unknown>;
|
|
2823
|
-
}): {
|
|
2824
|
-
bubbles: boolean;
|
|
2825
|
-
capturePhase: boolean;
|
|
2826
|
-
composed: boolean;
|
|
2827
|
-
currentTarget: {
|
|
2828
|
-
dataset: Record<string, unknown>;
|
|
2829
|
-
id: string;
|
|
2830
|
-
};
|
|
2831
|
-
detail: unknown;
|
|
2832
|
-
mark: Record<string, unknown> | undefined;
|
|
2833
|
-
target: {
|
|
2834
|
-
dataset: Record<string, unknown>;
|
|
2835
|
-
id: string;
|
|
2836
|
-
};
|
|
2837
|
-
timeStamp: number;
|
|
2838
|
-
type: string;
|
|
2839
|
-
};
|
|
2840
|
-
//#endregion
|
|
2841
2916
|
//#region src/view/render.d.ts
|
|
2842
2917
|
interface DomNodeLike$2 {
|
|
2843
2918
|
attribs?: Record<string, string>;
|
|
@@ -2982,6 +3057,30 @@ export declare class HeadlessTestingPageHandle {
|
|
|
2982
3057
|
private waitAccess;
|
|
2983
3058
|
}
|
|
2984
3059
|
//#endregion
|
|
3060
|
+
//#region src/testing/sessionHandle/protocol.d.ts
|
|
3061
|
+
interface HeadlessTestingProtocolOptions {
|
|
3062
|
+
timeout?: number;
|
|
3063
|
+
}
|
|
3064
|
+
type HeadlessTestingEvaluator<T = unknown> = ((...args: any[]) => T | PromiseLike<T>) | string;
|
|
3065
|
+
interface HeadlessTestingToolInfo {
|
|
3066
|
+
version: 'mpcore-simulator';
|
|
3067
|
+
}
|
|
3068
|
+
/** 无头协议只公布已有运行时语义;不把宿主缺失能力伪装为调试器结果。 */
|
|
3069
|
+
export declare class HeadlessTestingProtocolUnsupportedError extends Error {
|
|
3070
|
+
readonly method: string;
|
|
3071
|
+
readonly code = "HEADLESS_PROTOCOL_UNSUPPORTED";
|
|
3072
|
+
constructor(method: string);
|
|
3073
|
+
}
|
|
3074
|
+
//#endregion
|
|
3075
|
+
//#region src/testing/sessionHandle/cdp.d.ts
|
|
3076
|
+
type HeadlessTestingCDPEventListener = (domain: string, event: string, params: unknown) => void;
|
|
3077
|
+
interface HeadlessTestingCDP {
|
|
3078
|
+
enable: (options?: HeadlessTestingProtocolOptions) => Promise<unknown>;
|
|
3079
|
+
sendCommand: <T = unknown>(domain: string, method: string, params?: Record<string, unknown>, options?: HeadlessTestingProtocolOptions) => Promise<T>;
|
|
3080
|
+
listProtocol: <T = unknown>(options?: HeadlessTestingProtocolOptions) => Promise<T>;
|
|
3081
|
+
onEvent: (listener: HeadlessTestingCDPEventListener) => () => void;
|
|
3082
|
+
}
|
|
3083
|
+
//#endregion
|
|
2985
3084
|
//#region src/testing/sessionHandle/scope.d.ts
|
|
2986
3085
|
export declare class HeadlessTestingScopeHandle {
|
|
2987
3086
|
readonly scopeId: string;
|
|
@@ -3029,19 +3128,18 @@ export declare class HeadlessTestingScopeHandle {
|
|
|
3029
3128
|
}
|
|
3030
3129
|
//#endregion
|
|
3031
3130
|
//#region src/testing/sessionHandle/index.d.ts
|
|
3032
|
-
interface HeadlessTestingProtocolOptions {
|
|
3033
|
-
timeout?: number;
|
|
3034
|
-
}
|
|
3035
|
-
type HeadlessTestingEvaluator<T = unknown> = ((...args: any[]) => T | PromiseLike<T>) | string;
|
|
3036
|
-
interface HeadlessTestingToolInfo {
|
|
3037
|
-
version: 'mpcore-simulator';
|
|
3038
|
-
}
|
|
3039
3131
|
export declare class HeadlessTestingSessionHandle {
|
|
3040
3132
|
private readonly project;
|
|
3041
3133
|
private readonly session;
|
|
3042
|
-
private readonly
|
|
3134
|
+
private readonly navigation;
|
|
3135
|
+
private disconnection?;
|
|
3136
|
+
private cdp?;
|
|
3043
3137
|
constructor(project: HeadlessProjectDescriptor, session: HeadlessSession);
|
|
3044
3138
|
close(): Promise<void>;
|
|
3139
|
+
/** 先保存共享结果,再同步开始关闭,覆盖关闭监听器内的重入调用。 */
|
|
3140
|
+
disconnect(): Promise<void>;
|
|
3141
|
+
send<T = unknown>(method: string, params?: Record<string, unknown>, options?: HeadlessTestingProtocolOptions): Promise<T>;
|
|
3142
|
+
CDP(): HeadlessTestingCDP;
|
|
3045
3143
|
toolInfo(): Promise<HeadlessTestingToolInfo>;
|
|
3046
3144
|
on(eventName: string, handler: (...args: any[]) => void): this;
|
|
3047
3145
|
removeListener(eventName: string, handler: (...args: any[]) => void): this;
|
|
@@ -3052,6 +3150,8 @@ export declare class HeadlessTestingSessionHandle {
|
|
|
3052
3150
|
getCurrentPages(): Promise<HeadlessTestingPageHandle[]>;
|
|
3053
3151
|
callWxMethod<T = unknown>(methodName: string, ...args: any[]): Promise<T>;
|
|
3054
3152
|
callWxMethodWithOptions<T = unknown>(methodName: string, options?: HeadlessTestingProtocolOptions, ...args: any[]): Promise<T>;
|
|
3153
|
+
/** 返回与 DevTools automator 兼容的运行时系统信息。 */
|
|
3154
|
+
systemInfo<T = unknown>(): Promise<T>;
|
|
3055
3155
|
scopeSnapshot(scopeId: string): Promise<{
|
|
3056
3156
|
data: Record<string, any>;
|
|
3057
3157
|
methods: string[];
|
|
@@ -3076,6 +3176,10 @@ export declare class HeadlessTestingSessionHandle {
|
|
|
3076
3176
|
waitForComponent(selector: string, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingScopeHandle>;
|
|
3077
3177
|
waitForComponents(selector: string, count?: number, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingScopeHandle[]>;
|
|
3078
3178
|
reLaunch(route: string): Promise<HeadlessTestingPageHandle>;
|
|
3179
|
+
/** 只更新页面定义;不隐式导航,也不替换当前页面或应用实例。 */
|
|
3180
|
+
reloadPageDefinition(route: string): Promise<boolean>;
|
|
3181
|
+
/** 显式提交宿主编译模板;不隐式重载脚本或导航。 */
|
|
3182
|
+
reloadTemplates(): Promise<boolean>;
|
|
3079
3183
|
navigateTo(route: string): Promise<HeadlessTestingPageHandle>;
|
|
3080
3184
|
redirectTo(route: string): Promise<HeadlessTestingPageHandle>;
|
|
3081
3185
|
navigateBack(delta?: number): Promise<HeadlessTestingPageHandle | null>;
|
|
@@ -3088,17 +3192,18 @@ export declare class HeadlessTestingSessionHandle {
|
|
|
3088
3192
|
triggerReachBottom(): Promise<void>;
|
|
3089
3193
|
triggerResize(options: Record<string, any>): Promise<void>;
|
|
3090
3194
|
triggerRouteDone(options?: Record<string, any>): Promise<void>;
|
|
3091
|
-
private invokeNavigation;
|
|
3092
3195
|
private requireCurrentPage;
|
|
3093
3196
|
private evaluateInRuntime;
|
|
3094
3197
|
}
|
|
3095
3198
|
//#endregion
|
|
3096
3199
|
//#region src/testing/launch.d.ts
|
|
3097
3200
|
export interface HeadlessTestingLaunchOptions {
|
|
3201
|
+
/** 相对小程序根目录的编译模板路径;普通查询不得提交尚未注册的模板。 */
|
|
3202
|
+
compiledTemplatePaths?: readonly string[];
|
|
3098
3203
|
projectPath: string;
|
|
3099
3204
|
configureSession?: (session: HeadlessSession) => void | Promise<void>;
|
|
3100
3205
|
onSessionCreated?: (session: HeadlessTestingSessionHandle) => void | Promise<void>;
|
|
3101
3206
|
}
|
|
3102
3207
|
export declare function launch(options: HeadlessTestingLaunchOptions): Promise<HeadlessTestingSessionHandle>;
|
|
3103
3208
|
//#endregion
|
|
3104
|
-
export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingToolInfo, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };
|
|
3209
|
+
export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingCDP, HeadlessTestingCDPEventListener, HeadlessTestingDispatchEventInit, HeadlessTestingEvaluator, HeadlessTestingNodeEventInit, HeadlessTestingNodeValueEventInit, HeadlessTestingProtocolOptions, HeadlessTestingToolInfo, HeadlessTestingTouch, HeadlessTestingTouchEventInit, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };
|