@applitools/eyes-selenium 4.57.0 → 4.58.3

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.
Files changed (3) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/package.json +17 -17
  3. package/types/index.d.ts +1362 -2010
package/types/index.d.ts CHANGED
@@ -1,2092 +1,1444 @@
1
+ export type Driver = import('selenium-webdriver').WebDriver & { __applitoolsBrand?: never; };
2
+ export type Element = import('selenium-webdriver').WebElement & { __applitoolsBrand?: never; };
3
+ export type Selector = (import('selenium-webdriver').Locator | { using: string; value: string; }) & { __applitoolsBrand?: never; };
4
+ export class Eyes {
5
+ static setViewportSize: (driver: Driver, viewportSize: RectangleSize) => Promise<void>;
6
+ constructor(runner?: EyesRunner, config?: ConfigurationPlain);
7
+ constructor(config?: ConfigurationPlain);
8
+ get logger(): Logger;
9
+ getLogger(): Logger;
10
+ get runner(): EyesRunner;
11
+ getRunner(): EyesRunner;
12
+ get driver(): Driver;
13
+ getDriver(): Driver;
14
+ get configuration(): ConfigurationPlain;
15
+ set configuration(configuration: ConfigurationPlain);
16
+ getConfiguration(): Configuration;
17
+ setConfiguration(config: ConfigurationPlain): void;
18
+ get isOpen(): boolean;
19
+ getIsOpen(): boolean;
20
+ on(handler: (event: string, data?: Record<string, any>) => any): () => void;
21
+ on(event: "setSizeWillStart", handler: (data: { viewportSize: RectangleSizePlain; }) => any): () => void;
22
+ on(event: "setSizeEnded", handler: () => any): () => void;
23
+ on(event: "initStarted", handler: () => any): () => void;
24
+ on(event: "initEnded", handler: () => any): () => void;
25
+ on(event: "testStarted", handler: (data: { sessionId: string; }) => any): () => void;
26
+ on(event: "validationWillStart", handler: (data: { sessionId: string; validationInfo: ValidationInfoPlain; }) => any): () => void;
27
+ on(event: "validationEnded", handler: (data: { sessionId: string; validationId: number; validationResult: ValidationResultPlain; }) => any): () => void;
28
+ on(event: "testEnded", handler: (data: { sessionId: string; testResults: TestResultsPlain; }) => any): () => void;
29
+ off(event: string): void;
30
+ off(handler: (...args: Array<any>) => any): void;
31
+ open(driver: Driver, config?: ConfigurationPlain): Promise<Driver>;
32
+ open(driver: Driver, appName?: string, testName?: string, viewportSize?: RectangleSizePlain, sessionType?: SessionTypePlain): Promise<Driver>;
33
+ checkWindow(name?: string, timeout?: number, fully?: boolean): Promise<MatchResult>;
34
+ checkFrame(element: number | Element | EyesSelector<Selector>, timeout?: number, name?: string): Promise<MatchResult>;
35
+ checkElement(element: Element, timeout?: number, name?: string): Promise<MatchResult>;
36
+ checkElementBy(selector: EyesSelector<Selector>, timeout?: number, name?: string): Promise<MatchResult>;
37
+ checkRegion(region?: RegionPlain, name?: string, timeout?: number): Promise<MatchResult>;
38
+ checkRegionByElement(element: Element, name?: string, timeout?: number): Promise<MatchResult>;
39
+ checkRegionBy(selector: EyesSelector<Selector>, name?: string, timeout?: number, fully?: boolean): Promise<MatchResult>;
40
+ checkRegionInFrame(frame: number | Element | EyesSelector<Selector>, selector: EyesSelector<Selector>, timeout?: number, name?: string, fully?: boolean): Promise<MatchResult>;
41
+ check(name: string, checkSettings: CheckSettings): Promise<MatchResult>;
42
+ check(checkSettings?: CheckSettingsPlain): Promise<MatchResult>;
43
+ locate<TLocator extends string>(settings: VisualLocatorSettings<TLocator>): Promise<Record<TLocator, Array<RegionPlain>>>;
44
+ extractTextRegions<TPattern extends string>(settings: OCRSettings<TPattern>): Promise<Record<TPattern, Array<TextRegion>>>;
45
+ extractText(regions: Array<OCRRegion>): Promise<Array<string>>;
46
+ close(throwErr?: boolean): Promise<TestResults>;
47
+ closeAsync(): Promise<void>;
48
+ abort(): Promise<TestResults>;
49
+ abortAsync(): Promise<void>;
50
+ abortIfNotClosed(): Promise<TestResultsPlain>;
51
+ getViewportSize(): Promise<RectangleSize>;
52
+ setViewportSize(size: RectangleSizePlain): Promise<void>;
53
+ getScrollRootElement(): Element | EyesSelector<Selector>;
54
+ setScrollRootElement(scrollRootElement: Element | EyesSelector<Selector>): void;
55
+ setLogHandler(handler: LogHandler): void;
56
+ getLogHandler(): LogHandler;
57
+ setCutProvider(cutProvider: CutProvider): void;
58
+ setImageCut(cutProvider: CutProvider): void;
59
+ getIsCutProviderExplicitlySet(): boolean;
60
+ getRotation(): ImageRotation;
61
+ setRotation(rotation: ImageRotationPlain | ImageRotation): void;
62
+ getScaleRatio(): number;
63
+ setScaleRatio(scaleRatio: number): void;
64
+ getSaveDebugScreenshots(): boolean;
65
+ setSaveDebugScreenshots(save: boolean): void;
66
+ getDebugScreenshotsPath(): string;
67
+ setDebugScreenshotsPath(path: string): void;
68
+ getDebugScreenshotsPrefix(): string;
69
+ setDebugScreenshotsPrefix(prefix: string): void;
70
+ addProperty(name: string, value: string): Configuration;
71
+ clearProperties(): Configuration;
72
+ getBatch(): BatchInfo;
73
+ setBatch(batch: BatchInfoPlain): void;
74
+ setBatch(name: string, id?: string, startedAt?: string | Date): void;
75
+ getApiKey(): string;
76
+ setApiKey(apiKey: string): void;
77
+ getTestName(): string;
78
+ setTestName(testName: string): void;
79
+ getAppName(): string;
80
+ setAppName(appName: string): void;
81
+ getBaselineBranchName(): string;
82
+ setBaselineBranchName(baselineBranchName: string): void;
83
+ getBaselineName(): string;
84
+ setBaselineName(baselineName: string): void;
85
+ getBaselineEnvName(): string;
86
+ setBaselineEnvName(baselineEnvName: string): void;
87
+ getBranchName(): string;
88
+ setBranchName(branchName: string): void;
89
+ getHostApp(): string;
90
+ setHostApp(hostApp: string): void;
91
+ getHostOS(): string;
92
+ setHostOS(hostOS: string): void;
93
+ getHostAppInfo(): string;
94
+ setHostAppInfo(hostAppInfo: string): void;
95
+ getHostOSInfo(): string;
96
+ setHostOSInfo(hostOSInfo: string): void;
97
+ getDeviceInfo(): string;
98
+ setDeviceInfo(deviceInfo: string): void;
99
+ setIgnoreCaret(ignoreCaret: boolean): void;
100
+ getIgnoreCaret(): boolean;
101
+ getIsDisabled(): boolean;
102
+ setIsDisabled(isDisabled: boolean): void;
103
+ getMatchLevel(): MatchLevel;
104
+ setMatchLevel(matchLevel: MatchLevelPlain): void;
105
+ getMatchTimeout(): number;
106
+ setMatchTimeout(matchTimeout: number): void;
107
+ getParentBranchName(): string;
108
+ setParentBranchName(parentBranchName: string): void;
109
+ setProxy(proxy: ProxySettingsPlain): void;
110
+ setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): void;
111
+ setProxy(isEnabled: false): void;
112
+ getProxy(): ProxySettings;
113
+ getSaveDiffs(): boolean;
114
+ setSaveDiffs(saveDiffs: boolean): void;
115
+ getSaveNewTests(): boolean;
116
+ setSaveNewTests(saveNewTests: boolean): void;
117
+ getServerUrl(): string;
118
+ setServerUrl(serverUrl: string): void;
119
+ getSendDom(): boolean;
120
+ setSendDom(sendDom: boolean): void;
121
+ getHideCaret(): boolean;
122
+ setHideCaret(hideCaret: boolean): void;
123
+ getHideScrollbars(): boolean;
124
+ setHideScrollbars(hideScrollbars: boolean): void;
125
+ getForceFullPageScreenshot(): boolean;
126
+ setForceFullPageScreenshot(forceFullPageScreenshot: boolean): void;
127
+ getWaitBeforeScreenshots(): number;
128
+ setWaitBeforeScreenshots(waitBeforeScreenshots: number): void;
129
+ getStitchMode(): StitchMode;
130
+ setStitchMode(stitchMode: StitchModePlain): void;
131
+ getStitchOverlap(): number;
132
+ setStitchOverlap(stitchOverlap: number): void;
133
+ getSessionEventHandlers(): SessionEventHandlers;
134
+ addSessionEventHandler(handler: SessionEventHandler): void;
135
+ removeSessionEventHandler(handler: SessionEventHandler): void;
136
+ clearSessionEventHandlers(): void;
137
+ }
138
+ export type ConfigurationPlain = {
139
+ logs?: LogHandlerPlain;
140
+ debugScreenshots?: { save: boolean; path?: string; prefix?: string; };
141
+ agentId?: string;
142
+ apiKey?: string;
143
+ serverUrl?: string;
144
+ proxy?: ProxySettingsPlain;
145
+ isDisabled?: boolean;
146
+ connectionTimeout?: number;
147
+ removeSession?: boolean;
148
+ remoteEvents?: { serverUrl: string; accessKey?: string; timeout?: number; };
149
+ appName?: string;
150
+ testName?: string;
151
+ displayName?: string;
152
+ viewportSize?: RectangleSizePlain;
153
+ sessionType?: SessionTypePlain;
154
+ properties?: Array<PropertyDataPlain>;
155
+ batch?: BatchInfoPlain;
156
+ defaultMatchSettings?: ImageMatchSettingsPlain;
157
+ hostApp?: string;
158
+ hostOS?: string;
159
+ hostAppInfo?: string;
160
+ hostOSInfo?: string;
161
+ deviceInfo?: string;
162
+ baselineEnvName?: string;
163
+ environmentName?: string;
164
+ branchName?: string;
165
+ parentBranchName?: string;
166
+ baselineBranchName?: string;
167
+ compareWithParentBranch?: boolean;
168
+ ignoreBaseline?: boolean;
169
+ saveFailedTests?: boolean;
170
+ saveNewTests?: boolean;
171
+ saveDiffs?: boolean;
172
+ dontCloseBatches?: boolean;
173
+ sendDom?: boolean;
174
+ matchTimeout?: number;
175
+ forceFullPageScreenshot?: boolean;
176
+ waitBeforeScreenshots?: number;
177
+ stitchMode?: StitchModePlain;
178
+ hideScrollbars?: boolean;
179
+ hideCaret?: boolean;
180
+ stitchOverlap?: number;
181
+ scrollRootElement?: Element | EyesSelector<Selector>;
182
+ cut?: CutProviderPlain;
183
+ rotation?: ImageRotationPlain;
184
+ scaleRatio?: number;
185
+ waitBeforeCapture?: number;
186
+ concurrentSessions?: number;
187
+ browsersInfo?: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo>;
188
+ visualGridOptions?: Record<string, any>;
189
+ layoutBreakpoints?: boolean | Array<number>;
190
+ disableBrowserFetching?: boolean;
191
+ };
192
+ export class Configuration implements Required<ConfigurationPlain> {
193
+ constructor(config?: ConfigurationPlain);
194
+ get logs(): LogHandlerPlain;
195
+ set logs(logs: LogHandlerPlain);
196
+ getShowLogs(): boolean;
197
+ setShowLogs(show: boolean): Configuration;
198
+ getLogHandler(): LogHandlerPlain;
199
+ setLogHandler(handler: LogHandlerPlain): Configuration;
200
+ get debugScreenshots(): { save: boolean; path?: string; prefix?: string; };
201
+ set debugScreenshots(debugScreenshots: { save: boolean; path?: string; prefix?: string; });
202
+ getSaveDebugScreenshots(): boolean;
203
+ setSaveDebugScreenshots(save: boolean): Configuration;
204
+ getDebugScreenshotsPath(): string;
205
+ setDebugScreenshotsPath(path: string): Configuration;
206
+ getDebugScreenshotsPrefix(): string;
207
+ setDebugScreenshotsPrefix(prefix: string): Configuration;
208
+ get appName(): string;
209
+ set appName(appName: string);
210
+ getAppName(): string;
211
+ setAppName(appName: string): Configuration;
212
+ get testName(): string;
213
+ set testName(testName: string);
214
+ getTestName(): string;
215
+ setTestName(testName: string): Configuration;
216
+ get displayName(): string;
217
+ set displayName(displayName: string);
218
+ getDisplayName(): string;
219
+ setDisplayName(displayName: string): Configuration;
220
+ get isDisabled(): boolean;
221
+ set isDisabled(isDisabled: boolean);
222
+ getIsDisabled(): boolean;
223
+ setIsDisabled(isDisabled: boolean): Configuration;
224
+ get matchTimeout(): number;
225
+ set matchTimeout(matchTimeout: number);
226
+ getMatchTimeout(): number;
227
+ setMatchTimeout(matchTimeout: number): Configuration;
228
+ get sessionType(): SessionTypePlain;
229
+ set sessionType(sessionType: SessionTypePlain);
230
+ getSessionType(): SessionType;
231
+ setSessionType(sessionType: SessionTypePlain): Configuration;
232
+ get viewportSize(): RectangleSizePlain;
233
+ set viewportSize(viewportSize: RectangleSizePlain);
234
+ getViewportSize(): RectangleSize;
235
+ setViewportSize(viewportSize: RectangleSizePlain): Configuration;
236
+ get agentId(): string;
237
+ set agentId(agentId: string);
238
+ getAgentId(): string;
239
+ setAgentId(agentId: string): Configuration;
240
+ get apiKey(): string;
241
+ set apiKey(apiKey: string);
242
+ getApiKey(): string;
243
+ setApiKey(apiKey: string): Configuration;
244
+ get serverUrl(): string;
245
+ set serverUrl(serverUrl: string);
246
+ getServerUrl(): string;
247
+ setServerUrl(serverUrl: string): Configuration;
248
+ get proxy(): ProxySettingsPlain;
249
+ set proxy(proxy: ProxySettingsPlain);
250
+ getProxy(): ProxySettings;
251
+ setProxy(proxy: ProxySettingsPlain): Configuration;
252
+ setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): Configuration;
253
+ setProxy(isEnabled: false): Configuration;
254
+ get connectionTimeout(): number;
255
+ set connectionTimeout(connectionTimeout: number);
256
+ getConnectionTimeout(): number;
257
+ setConnectionTimeout(connectionTimeout: number): Configuration;
258
+ get removeSession(): boolean;
259
+ set removeSession(removeSession: boolean);
260
+ getRemoveSession(): boolean;
261
+ setRemoveSession(removeSession: boolean): Configuration;
262
+ get remoteEvents(): { serverUrl: string; accessKey?: string; timeout?: number; };
263
+ set remoteEvents(remoteEvents: { serverUrl: string; accessKey?: string; timeout?: number; });
264
+ getRemoteEvents(): { serverUrl: string; accessKey?: string; timeout?: number; };
265
+ setRemoteEvents(remoteEvents: { serverUrl: string; accessKey?: string; timeout?: number; }): Configuration;
266
+ get batch(): BatchInfoPlain;
267
+ set batch(batch: BatchInfoPlain);
268
+ getBatch(): BatchInfo;
269
+ setBatch(batch: BatchInfoPlain): Configuration;
270
+ get properties(): Array<PropertyDataPlain>;
271
+ set properties(properties: Array<PropertyDataPlain>);
272
+ getProperties(): Array<PropertyData>;
273
+ setProperties(properties: Array<PropertyDataPlain>): Configuration;
274
+ addProperty(name: string, value: string): Configuration;
275
+ addProperty(prop: PropertyDataPlain): Configuration;
276
+ clearProperties(): Configuration;
277
+ get baselineEnvName(): string;
278
+ set baselineEnvName(baselineEnvName: string);
279
+ getBaselineEnvName(): string;
280
+ setBaselineEnvName(baselineEnvName: string): Configuration;
281
+ get environmentName(): string;
282
+ set environmentName(environmentName: string);
283
+ getEnvironmentName(): string;
284
+ setEnvironmentName(environmentName: string): Configuration;
285
+ get branchName(): string;
286
+ set branchName(branchName: string);
287
+ getBranchName(): string;
288
+ setBranchName(branchName: string): Configuration;
289
+ get parentBranchName(): string;
290
+ set parentBranchName(parentBranchName: string);
291
+ getParentBranchName(): string;
292
+ setParentBranchName(parentBranchName: string): Configuration;
293
+ get baselineBranchName(): string;
294
+ set baselineBranchName(baselineBranchName: string);
295
+ getBaselineBranchName(): string;
296
+ setBaselineBranchName(baselineBranchName: string): Configuration;
297
+ get compareWithParentBranch(): boolean;
298
+ set compareWithParentBranch(compareWithParentBranch: boolean);
299
+ getCompareWithParentBranch(): boolean;
300
+ setCompareWithParentBranch(compareWithParentBranch: boolean): Configuration;
301
+ get ignoreBaseline(): boolean;
302
+ set ignoreBaseline(ignoreBaseline: boolean);
303
+ getIgnoreBaseline(): boolean;
304
+ setIgnoreBaseline(ignoreBaseline: boolean): Configuration;
305
+ get saveFailedTests(): boolean;
306
+ set saveFailedTests(saveFailedTests: boolean);
307
+ getSaveFailedTests(): boolean;
308
+ setSaveFailedTests(saveFailedTests: boolean): Configuration;
309
+ get saveNewTests(): boolean;
310
+ set saveNewTests(saveNewTests: boolean);
311
+ getSaveNewTests(): boolean;
312
+ setSaveNewTests(saveNewTests: boolean): Configuration;
313
+ get saveDiffs(): boolean;
314
+ set saveDiffs(saveDiffs: boolean);
315
+ getSaveDiffs(): boolean;
316
+ setSaveDiffs(saveDiffs: boolean): Configuration;
317
+ get sendDom(): boolean;
318
+ set sendDom(sendDom: boolean);
319
+ getSendDom(): boolean;
320
+ setSendDom(sendDom: boolean): Configuration;
321
+ get hostApp(): string;
322
+ set hostApp(hostApp: string);
323
+ getHostApp(): string;
324
+ setHostApp(hostApp: string): Configuration;
325
+ get hostOS(): string;
326
+ set hostOS(hostOS: string);
327
+ getHostOS(): string;
328
+ setHostOS(hostOS: string): Configuration;
329
+ get hostAppInfo(): string;
330
+ set hostAppInfo(hostAppInfo: string);
331
+ getHostAppInfo(): string;
332
+ setHostAppInfo(hostAppInfo: string): Configuration;
333
+ get hostOSInfo(): string;
334
+ set hostOSInfo(hostOSInfo: string);
335
+ getHostOSInfo(): string;
336
+ setHostOSInfo(hostOSInfo: string): Configuration;
337
+ get deviceInfo(): string;
338
+ set deviceInfo(deviceInfo: string);
339
+ getDeviceInfo(): string;
340
+ setDeviceInfo(deviceInfo: string): Configuration;
341
+ get defaultMatchSettings(): ImageMatchSettingsPlain;
342
+ set defaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain);
343
+ getDefaultMatchSettings(): ImageMatchSettingsPlain;
344
+ setDefaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain): Configuration;
345
+ getMatchLevel(): MatchLevel;
346
+ setMatchLevel(matchLevel: MatchLevelPlain): Configuration;
347
+ getAccessibilityValidation(): AccessibilitySettings;
348
+ setAccessibilityValidation(accessibilityValidation: AccessibilitySettings): Configuration;
349
+ getUseDom(): boolean;
350
+ setUseDom(useDom: boolean): Configuration;
351
+ getEnablePatterns(): boolean;
352
+ setEnablePatterns(enablePatterns: boolean): Configuration;
353
+ getIgnoreDisplacements(): boolean;
354
+ setIgnoreDisplacements(ignoreDisplacements: boolean): Configuration;
355
+ getIgnoreCaret(): boolean;
356
+ setIgnoreCaret(ignoreCaret: boolean): Configuration;
357
+ get forceFullPageScreenshot(): boolean;
358
+ set forceFullPageScreenshot(forceFullPageScreenshot: boolean);
359
+ getForceFullPageScreenshot(): boolean;
360
+ setForceFullPageScreenshot(forceFullPageScreenshot: boolean): Configuration;
361
+ get waitBeforeScreenshots(): number;
362
+ set waitBeforeScreenshots(waitBeforeScreenshots: number);
363
+ getWaitBeforeScreenshots(): number;
364
+ setWaitBeforeScreenshots(waitBeforeScreenshots: number): Configuration;
365
+ get waitBeforeCapture(): number;
366
+ set waitBeforeCapture(waitBeforeCapture: number);
367
+ getWaitBeforeCapture(): number;
368
+ setWaitBeforeCapture(waitBeforeCapture: number): Configuration;
369
+ get stitchMode(): StitchModePlain;
370
+ set stitchMode(stitchMode: StitchModePlain);
371
+ getStitchMode(): StitchMode;
372
+ setStitchMode(stitchMode: StitchModePlain): Configuration;
373
+ get hideScrollbars(): boolean;
374
+ set hideScrollbars(hideScrollbars: boolean);
375
+ getHideScrollbars(): boolean;
376
+ setHideScrollbars(hideScrollbars: boolean): Configuration;
377
+ get hideCaret(): boolean;
378
+ set hideCaret(hideCaret: boolean);
379
+ getHideCaret(): boolean;
380
+ setHideCaret(hideCaret: boolean): Configuration;
381
+ get stitchOverlap(): number;
382
+ set stitchOverlap(stitchOverlap: number);
383
+ getStitchOverlap(): number;
384
+ setStitchOverlap(stitchOverlap: number): Configuration;
385
+ get scrollRootElement(): Element | EyesSelector<Selector>;
386
+ set scrollRootElement(scrollRootElement: Element | EyesSelector<Selector>);
387
+ getScrollRootElement(): Element | EyesSelector<Selector>;
388
+ setScrollRootElement(scrollRootElement: Element | EyesSelector<Selector>): Configuration;
389
+ get cut(): CutProviderPlain;
390
+ set cut(cut: CutProviderPlain);
391
+ getCut(): CutProviderPlain;
392
+ setCut(cut: CutProviderPlain): Configuration;
393
+ get rotation(): ImageRotationPlain;
394
+ set rotation(rotation: ImageRotationPlain);
395
+ getRotation(): ImageRotation;
396
+ setRotation(rotation: ImageRotationPlain | ImageRotation): Configuration;
397
+ get scaleRatio(): number;
398
+ set scaleRatio(scaleRatio: number);
399
+ getScaleRatio(): number;
400
+ setScaleRatio(scaleRatio: number): Configuration;
401
+ get concurrentSessions(): number;
402
+ set concurrentSessions(concurrentSessions: number);
403
+ getConcurrentSessions(): number;
404
+ setConcurrentSessions(concurrentSessions: number): Configuration;
405
+ get browsersInfo(): Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo>;
406
+ set browsersInfo(browsersInfo: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo>);
407
+ getBrowsersInfo(): Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }>;
408
+ setBrowsersInfo(browsersInfo: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }>): Configuration;
409
+ addBrowsers(...browsersInfo: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }>): Configuration;
410
+ addBrowser(browserInfo: DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }): Configuration;
411
+ addBrowser(width: number, height: number, name?: BrowserTypePlain): Configuration;
412
+ addDeviceEmulation(deviceName: DeviceNamePlain, screenOrientation?: ScreenOrientationPlain): Configuration;
413
+ get visualGridOptions(): { [key: string]: any; };
414
+ set visualGridOptions(visualGridOptions: { [key: string]: any; });
415
+ getVisualGridOptions(): { [key: string]: any; };
416
+ setVisualGridOptions(visualGridOptions: { [key: string]: any; }): Configuration;
417
+ setVisualGridOption(key: string, value: any): Configuration;
418
+ get layoutBreakpoints(): boolean | Array<number>;
419
+ set layoutBreakpoints(layoutBreakpoints: boolean | Array<number>);
420
+ getLayoutBreakpoints(): boolean | Array<number>;
421
+ setLayoutBreakpoints(layoutBreakpoints: boolean | Array<number>): Configuration;
422
+ get disableBrowserFetching(): boolean;
423
+ set disableBrowserFetching(disableBrowserFetching: boolean);
424
+ getDisableBrowserFetching(): boolean;
425
+ setDisableBrowserFetching(disableBrowserFetching: boolean): Configuration;
426
+ get dontCloseBatches(): boolean;
427
+ set dontCloseBatches(dontCloseBatches: boolean);
428
+ getDontCloseBatches(): boolean;
429
+ setDontCloseBatches(dontCloseBatches: boolean): Configuration;
430
+ }
431
+ export type OCRRegion = { target: Element | RegionPlain | EyesSelector<Selector>; hint?: string; minMatch?: number; language?: string; };
432
+ export type CheckSettingsPlain = {
433
+ name?: string;
434
+ region?: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
435
+ frames?: Array<{ frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }); } | (number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>;
436
+ scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; });
437
+ fully?: boolean;
438
+ matchLevel?: MatchLevelPlain;
439
+ useDom?: boolean;
440
+ sendDom?: boolean;
441
+ enablePatterns?: boolean;
442
+ ignoreDisplacements?: boolean;
443
+ ignoreCaret?: boolean;
444
+ ignoreRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
445
+ layoutRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
446
+ strictRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
447
+ contentRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
448
+ floatingRegions?: Array<(RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | {
449
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
450
+ maxUpOffset?: number;
451
+ maxDownOffset?: number;
452
+ maxLeftOffset?: number;
453
+ maxRightOffset?: number;
454
+ }>;
455
+ accessibilityRegions?: Array<(RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | { region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); type?: AccessibilityRegionTypePlain; }>;
456
+ disableBrowserFetching?: boolean;
457
+ layoutBreakpoints?: boolean | Array<number>;
458
+ visualGridOptions?: { [key: string]: any; };
459
+ hooks?: { beforeCaptureScreenshot: string; };
460
+ renderId?: string;
461
+ variationGroupId?: string;
462
+ timeout?: number;
463
+ waitBeforeCapture?: number;
464
+ };
465
+ export class CheckSettings {
466
+ constructor(settings?: CheckSettingsPlain);
467
+ name(name: string): CheckSettings;
468
+ withName(name: string): CheckSettings;
469
+ region(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
470
+ shadow(selector: string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }): CheckSettings;
471
+ frame(context: { frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }); }): CheckSettings;
472
+ frame(frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })), scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })): CheckSettings;
473
+ ignoreRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
474
+ ignoreRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
475
+ ignore(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
476
+ ignores(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
477
+ layoutRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
478
+ layoutRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
479
+ strictRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
480
+ strictRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
481
+ contentRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
482
+ contentRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
483
+ floatingRegion(region: {
484
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
485
+ maxUpOffset?: number;
486
+ maxDownOffset?: number;
487
+ maxLeftOffset?: number;
488
+ maxRightOffset?: number;
489
+ }): CheckSettings;
490
+ floatingRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))), maxUpOffset?: number, maxDownOffset?: number, maxLeftOffset?: number, maxRightOffset?: number): CheckSettings;
491
+ floatingRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | {
492
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
493
+ maxUpOffset?: number;
494
+ maxDownOffset?: number;
495
+ maxLeftOffset?: number;
496
+ maxRightOffset?: number;
497
+ }>): CheckSettings;
498
+ floatingRegions(maxOffset: number, ...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
499
+ floating(region: {
500
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
501
+ maxUpOffset?: number;
502
+ maxDownOffset?: number;
503
+ maxLeftOffset?: number;
504
+ maxRightOffset?: number;
505
+ }): CheckSettings;
506
+ floating(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
507
+ floatings(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | {
508
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
509
+ maxUpOffset?: number;
510
+ maxDownOffset?: number;
511
+ maxLeftOffset?: number;
512
+ maxRightOffset?: number;
513
+ }>): CheckSettings;
514
+ floatings(maxOffset: number, ...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
515
+ accessibilityRegion(region: { region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); type?: AccessibilityRegionTypePlain; }): CheckSettings;
516
+ accessibilityRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))), type?: AccessibilityRegionTypePlain): CheckSettings;
517
+ accessibilityRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | { region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); type?: AccessibilityRegionTypePlain; }>): CheckSettings;
518
+ accessibilityRegions(type: AccessibilityRegionTypePlain, ...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
519
+ scrollRootElement(scrollRootElement: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })): CheckSettings;
520
+ fully(fully?: boolean): CheckSettings;
521
+ stitchContent(stitchContent?: boolean): CheckSettings;
522
+ matchLevel(matchLevel: MatchLevelPlain): CheckSettings;
523
+ layout(): CheckSettings;
524
+ exact(): CheckSettings;
525
+ strict(): CheckSettings;
526
+ content(): CheckSettings;
527
+ useDom(useDom?: boolean): CheckSettings;
528
+ sendDom(sendDom?: boolean): CheckSettings;
529
+ enablePatterns(enablePatterns?: boolean): CheckSettings;
530
+ ignoreDisplacements(ignoreDisplacements?: boolean): CheckSettings;
531
+ ignoreCaret(ignoreCaret?: boolean): CheckSettings;
532
+ disableBrowserFetching(disableBrowserFetching: boolean): CheckSettings;
533
+ layoutBreakpoints(layoutBreakpoints?: boolean | Array<number>): CheckSettings;
534
+ hook(name: string, script: string): CheckSettings;
535
+ beforeRenderScreenshotHook(script: string): CheckSettings;
536
+ webHook(script: string): CheckSettings;
537
+ visualGridOption(key: string, value: any): CheckSettings;
538
+ visualGridOptions(options: { [key: string]: any; }): CheckSettings;
539
+ renderId(renderId: string): CheckSettings;
540
+ variationGroupId(variationGroupId: string): CheckSettings;
541
+ timeout(timeout: number): CheckSettings;
542
+ waitBeforeCapture(waitBeforeCapture: number): CheckSettings;
543
+ }
544
+ export const Target: {
545
+ window(): CheckSettings;
546
+ region(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
547
+ frame(context: { frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }); }): CheckSettings;
548
+ frame(frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })), scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })): CheckSettings;
549
+ shadow(selector: string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }): CheckSettings;
550
+ };
551
+ export class BatchClose {
552
+ static close(settings: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }): Promise<void>;
553
+ constructor(options?: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; });
554
+ close(): Promise<void>;
555
+ setBatchIds(batchIds: Array<string>): BatchClose;
556
+ setUrl(serverUrl: string): BatchClose;
557
+ setApiKey(apiKey: string): BatchClose;
558
+ setProxy(proxy: ProxySettingsPlain): BatchClose;
559
+ }
560
+ export type AccessibilityGuidelinesVersionPlain = "WCAG_2_0" | "WCAG_2_1";
1
561
  export enum AccessibilityGuidelinesVersion {
2
- WCAG_2_0 = 'WCAG_2_0',
3
- WCAG_2_1 = 'WCAG_2_1',
562
+ WCAG_2_0 = 'WCAG_2_0',
563
+ WCAG_2_1 = 'WCAG_2_1'
4
564
  }
5
-
565
+ export type AccessibilityLevelPlain = "AA" | "AAA";
6
566
  export enum AccessibilityLevel {
7
- AA = 'AA',
8
- AAA = 'AAA',
567
+ AA = 'AA',
568
+ AAA = 'AAA'
9
569
  }
10
-
570
+ export type AccessibilityRegionTypePlain = "IgnoreContrast" | "RegularText" | "LargeText" | "BoldText" | "GraphicalObject";
11
571
  export enum AccessibilityRegionType {
12
- BoldText = 'BoldText',
13
- GraphicalObject = 'GraphicalObject',
14
- IgnoreContrast = 'IgnoreContrast',
15
- LargeText = 'LargeText',
16
- RegularText = 'RegularText',
572
+ IgnoreContrast = 'IgnoreContrast',
573
+ RegularText = 'RegularText',
574
+ LargeText = 'LargeText',
575
+ BoldText = 'BoldText',
576
+ GraphicalObject = 'GraphicalObject'
17
577
  }
18
-
578
+ export type AccessibilityStatusPlain = "Passed" | "Failed";
19
579
  export enum AccessibilityStatus {
20
- Failed = 'Failed',
21
- Passed = 'Passed',
580
+ Passed = 'Passed',
581
+ Failed = 'Failed'
22
582
  }
23
-
583
+ export type BrowserTypePlain = "chrome" | "chrome-one-version-back" | "chrome-two-versions-back" | "firefox" | "firefox-one-version-back" | "firefox-two-versions-back" | "ie" | "ie10" | "edge" | "edgechromium" | "edgelegacy" | "edgechromium-one-version-back" | "edgechromium-two-versions-back" | "safari" | "safari-earlyaccess" | "safari-one-version-back" | "safari-two-versions-back";
24
584
  export enum BrowserType {
25
- CHROME = 'chrome',
26
- CHROME_ONE_VERSION_BACK = 'chrome-one-version-back',
27
- CHROME_TWO_VERSIONS_BACK = 'chrome-two-versions-back',
28
- EDGE = 'edge',
29
- EDGE_CHROMIUM = 'edgechromium',
30
- EDGE_CHROMIUM_ONE_VERSION_BACK = 'edgechromium-one-version-back',
31
- EDGE_CHROMIUM_TWO_VERSIONS_BACK = 'edgechromium-two-versions-back',
32
- EDGE_LEGACY = 'edgelegacy',
33
- FIREFOX = 'firefox',
34
- FIREFOX_ONE_VERSION_BACK = 'firefox-one-version-back',
35
- FIREFOX_TWO_VERSIONS_BACK = 'firefox-two-versions-back',
36
- IE_10 = 'ie10',
37
- IE_11 = 'ie',
38
- SAFARI = 'safari',
39
- SAFARI_EARLY_ACCESS = 'safari-earlyaccess',
40
- SAFARI_ONE_VERSION_BACK = 'safari-one-version-back',
41
- SAFARI_TWO_VERSIONS_BACK = 'safari-two-versions-back',
585
+ CHROME = 'chrome',
586
+ CHROME_ONE_VERSION_BACK = 'chrome-one-version-back',
587
+ CHROME_TWO_VERSIONS_BACK = 'chrome-two-versions-back',
588
+ FIREFOX = 'firefox',
589
+ FIREFOX_ONE_VERSION_BACK = 'firefox-one-version-back',
590
+ FIREFOX_TWO_VERSIONS_BACK = 'firefox-two-versions-back',
591
+ IE_11 = 'ie',
592
+ IE_10 = 'ie10',
593
+ EDGE = 'edge',
594
+ EDGE_CHROMIUM = 'edgechromium',
595
+ EDGE_LEGACY = 'edgelegacy',
596
+ EDGE_CHROMIUM_ONE_VERSION_BACK = 'edgechromium-one-version-back',
597
+ EDGE_CHROMIUM_TWO_VERSIONS_BACK = 'edgechromium-two-versions-back',
598
+ SAFARI = 'safari',
599
+ SAFARI_EARLY_ACCESS = 'safari-earlyaccess',
600
+ SAFARI_ONE_VERSION_BACK = 'safari-one-version-back',
601
+ SAFARI_TWO_VERSIONS_BACK = 'safari-two-versions-back'
42
602
  }
43
-
44
- /** @undocumented */
603
+ export type CorsIframeHandlePlain = "BLANK" | "KEEP" | "SNAPSHOT";
45
604
  export enum CorsIframeHandle {
46
- BLANK = 'BLANK',
47
- KEEP = 'KEEP',
48
- SNAPSHOT = 'SNAPSHOT',
605
+ BLANK = 'BLANK',
606
+ KEEP = 'KEEP',
607
+ SNAPSHOT = 'SNAPSHOT'
49
608
  }
50
-
609
+ export type DeviceNamePlain = "Blackberry PlayBook" | "BlackBerry Z30" | "Galaxy A5" | "Galaxy Note 10" | "Galaxy Note 10 Plus" | "Galaxy Note 2" | "Galaxy Note 3" | "Galaxy Note 4" | "Galaxy Note 8" | "Galaxy Note 9" | "Galaxy S3" | "Galaxy S5" | "Galaxy S8" | "Galaxy S8 Plus" | "Galaxy S9" | "Galaxy S9 Plus" | "Galaxy S10" | "Galaxy S10 Plus" | "Galaxy S20" | "iPad" | "iPad 6th Gen" | "iPad 7th Gen" | "iPad Air 2" | "iPad Mini" | "iPad Pro" | "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone 4" | "iPhone 5/SE" | "iPhone 6/7/8" | "iPhone 6/7/8 Plus" | "iPhone X" | "iPhone XR" | "iPhone XS" | "iPhone XS Max" | "Kindle Fire HDX" | "Laptop with HiDPI screen" | "Laptop with MDPI screen" | "Laptop with touch" | "LG G6" | "LG Optimus L70" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Nexus 10" | "Nexus 4" | "Nexus 5" | "Nexus 5X" | "Nexus 6" | "Nexus 6P" | "Nexus 7" | "Nokia Lumia 520" | "Nokia N9" | "OnePlus 7T" | "OnePlus 7T Pro" | "Pixel 2" | "Pixel 2 XL" | "Pixel 3" | "Pixel 3 XL" | "Pixel 4" | "Pixel 4 XL" | "Pixel 5";
51
610
  export enum DeviceName {
52
- BlackBerry_Z30 = 'BlackBerry Z30',
53
- Blackberry_PlayBook = 'Blackberry PlayBook',
54
- Galaxy_A5 = 'Galaxy A5',
55
- Galaxy_Note_10 = 'Galaxy Note 10',
56
- Galaxy_Note_10_Plus = 'Galaxy Note 10 Plus',
57
- Galaxy_Note_2 = 'Galaxy Note 2',
58
- Galaxy_Note_3 = 'Galaxy Note 3',
59
- Galaxy_Note_4 = 'Galaxy Note 4',
60
- Galaxy_Note_8 = 'Galaxy Note 8',
61
- Galaxy_Note_9 = 'Galaxy Note 9',
62
- Galaxy_S10 = 'Galaxy S10',
63
- Galaxy_S10_Plus = 'Galaxy S10 Plus',
64
- Galaxy_S20 = 'Galaxy S20',
65
- Galaxy_S3 = 'Galaxy S3',
66
- Galaxy_S5 = 'Galaxy S5',
67
- Galaxy_S8 = 'Galaxy S8',
68
- Galaxy_S8_Plus = 'Galaxy S8 Plus',
69
- Galaxy_S9 = 'Galaxy S9',
70
- Galaxy_S9_Plus = 'Galaxy S9 Plus',
71
- Kindle_Fire_HDX = 'Kindle Fire HDX',
72
- LG_G6 = 'LG G6',
73
- LG_Optimus_L70 = 'LG Optimus L70',
74
- Laptop_with_HiDPI_screen = 'Laptop with HiDPI screen',
75
- Laptop_with_MDPI_screen = 'Laptop with MDPI screen',
76
- Laptop_with_touch = 'Laptop with touch',
77
- Microsoft_Lumia_550 = 'Microsoft Lumia 550',
78
- Microsoft_Lumia_950 = 'Microsoft Lumia 950',
79
- Nexus_10 = 'Nexus 10',
80
- Nexus_4 = 'Nexus 4',
81
- Nexus_5 = 'Nexus 5',
82
- Nexus_5X = 'Nexus 5X',
83
- Nexus_6 = 'Nexus 6',
84
- Nexus_6P = 'Nexus 6P',
85
- Nexus_7 = 'Nexus 7',
86
- Nokia_Lumia_520 = 'Nokia Lumia 520',
87
- Nokia_N9 = 'Nokia N9',
88
- OnePlus_7T = 'OnePlus 7T',
89
- OnePlus_7T_Pro = 'OnePlus 7T Pro',
90
- Pixel_2 = 'Pixel 2',
91
- Pixel_2_XL = 'Pixel 2 XL',
92
- Pixel_3 = 'Pixel 3',
93
- Pixel_3_XL = 'Pixel 3 XL',
94
- Pixel_4 = 'Pixel 4',
95
- Pixel_4_XL = 'Pixel 4 XL',
96
- Pixel_5 = 'Pixel 5',
97
- iPad = 'iPad',
98
- iPad_6th_Gen = 'iPad 6th Gen',
99
- iPad_7th_Gen = 'iPad 7th Gen',
100
- iPad_Air_2 = 'iPad Air 2',
101
- iPad_Mini = 'iPad Mini',
102
- iPad_Pro = 'iPad Pro',
103
- iPhone_11 = 'iPhone 11',
104
- iPhone_11_Pro = 'iPhone 11 Pro',
105
- iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
106
- iPhone_4 = 'iPhone 4',
107
- iPhone_5SE = 'iPhone 5/SE',
108
- iPhone_6_7_8 = 'iPhone 6/7/8',
109
- iPhone_6_7_8_Plus = 'iPhone 6/7/8 Plus',
110
- iPhone_X = 'iPhone X',
111
- iPhone_XR = 'iPhone XR',
112
- iPhone_XS = 'iPhone XS',
113
- iPhone_XS_Max = 'iPhone XS Max',
611
+ Blackberry_PlayBook = 'Blackberry PlayBook',
612
+ BlackBerry_Z30 = 'BlackBerry Z30',
613
+ Galaxy_A5 = 'Galaxy A5',
614
+ Galaxy_Note_10 = 'Galaxy Note 10',
615
+ Galaxy_Note_10_Plus = 'Galaxy Note 10 Plus',
616
+ Galaxy_Note_2 = 'Galaxy Note 2',
617
+ Galaxy_Note_3 = 'Galaxy Note 3',
618
+ Galaxy_Note_4 = 'Galaxy Note 4',
619
+ Galaxy_Note_8 = 'Galaxy Note 8',
620
+ Galaxy_Note_9 = 'Galaxy Note 9',
621
+ Galaxy_S3 = 'Galaxy S3',
622
+ Galaxy_S5 = 'Galaxy S5',
623
+ Galaxy_S8 = 'Galaxy S8',
624
+ Galaxy_S8_Plus = 'Galaxy S8 Plus',
625
+ Galaxy_S9 = 'Galaxy S9',
626
+ Galaxy_S9_Plus = 'Galaxy S9 Plus',
627
+ Galaxy_S10 = 'Galaxy S10',
628
+ Galaxy_S10_Plus = 'Galaxy S10 Plus',
629
+ Galaxy_S20 = 'Galaxy S20',
630
+ iPad = 'iPad',
631
+ iPad_6th_Gen = 'iPad 6th Gen',
632
+ iPad_7th_Gen = 'iPad 7th Gen',
633
+ iPad_Air_2 = 'iPad Air 2',
634
+ iPad_Mini = 'iPad Mini',
635
+ iPad_Pro = 'iPad Pro',
636
+ iPhone_11 = 'iPhone 11',
637
+ iPhone_11_Pro = 'iPhone 11 Pro',
638
+ iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
639
+ iPhone_4 = 'iPhone 4',
640
+ iPhone_5SE = 'iPhone 5/SE',
641
+ iPhone_6_7_8 = 'iPhone 6/7/8',
642
+ iPhone_6_7_8_Plus = 'iPhone 6/7/8 Plus',
643
+ iPhone_X = 'iPhone X',
644
+ iPhone_XR = 'iPhone XR',
645
+ iPhone_XS = 'iPhone XS',
646
+ iPhone_XS_Max = 'iPhone XS Max',
647
+ Kindle_Fire_HDX = 'Kindle Fire HDX',
648
+ Laptop_with_HiDPI_screen = 'Laptop with HiDPI screen',
649
+ Laptop_with_MDPI_screen = 'Laptop with MDPI screen',
650
+ Laptop_with_touch = 'Laptop with touch',
651
+ LG_G6 = 'LG G6',
652
+ LG_Optimus_L70 = 'LG Optimus L70',
653
+ Microsoft_Lumia_550 = 'Microsoft Lumia 550',
654
+ Microsoft_Lumia_950 = 'Microsoft Lumia 950',
655
+ Nexus_10 = 'Nexus 10',
656
+ Nexus_4 = 'Nexus 4',
657
+ Nexus_5 = 'Nexus 5',
658
+ Nexus_5X = 'Nexus 5X',
659
+ Nexus_6 = 'Nexus 6',
660
+ Nexus_6P = 'Nexus 6P',
661
+ Nexus_7 = 'Nexus 7',
662
+ Nokia_Lumia_520 = 'Nokia Lumia 520',
663
+ Nokia_N9 = 'Nokia N9',
664
+ OnePlus_7T = 'OnePlus 7T',
665
+ OnePlus_7T_Pro = 'OnePlus 7T Pro',
666
+ Pixel_2 = 'Pixel 2',
667
+ Pixel_2_XL = 'Pixel 2 XL',
668
+ Pixel_3 = 'Pixel 3',
669
+ Pixel_3_XL = 'Pixel 3 XL',
670
+ Pixel_4 = 'Pixel 4',
671
+ Pixel_4_XL = 'Pixel 4 XL',
672
+ Pixel_5 = 'Pixel 5'
114
673
  }
115
-
674
+ export type FailureReportPlain = "IMMEDIATE" | "ON_CLOSE";
116
675
  export enum FailureReport {
117
- IMMEDIATE = 'IMMEDIATE',
118
- ON_CLOSE = 'ON_CLOSE',
676
+ IMMEDIATE = 'IMMEDIATE',
677
+ ON_CLOSE = 'ON_CLOSE'
119
678
  }
120
-
679
+ export type IosDeviceNamePlain = "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone X" | "iPhone XR" | "iPhone 13 Pro Max" | "iPhone 13 Pro" | "iPhone 13" | "iPhone 12 Pro Max" | "iPhone 12 Pro" | "iPhone 12" | "iPhone 12 mini" | "iPhone Xs" | "iPhone 8" | "iPhone 7" | "iPad Pro (12.9-inch) (3rd generation)" | "iPad (7th generation)" | "iPad (9th generation)" | "iPad Air (2nd generation)";
121
680
  export enum IosDeviceName {
122
- iPad_7 = 'iPad (7th generation)',
123
- iPad_9 = 'iPad (9th generation)',
124
- iPad_Air_2 = 'iPad Air (2nd generation)',
125
- iPad_Pro_3 = 'iPad Pro (12.9-inch) (3rd generation)',
126
- iPhone_11 = 'iPhone 11',
127
- iPhone_11_Pro = 'iPhone 11 Pro',
128
- iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
129
- iPhone_12 = 'iPhone 12',
130
- iPhone_12_Pro = 'iPhone 12 Pro',
131
- iPhone_12_Pro_Max = 'iPhone 12 Pro Max',
132
- iPhone_12_mini = 'iPhone 12 mini',
133
- iPhone_13 = 'iPhone 13',
134
- iPhone_13_Pro = 'iPhone 13 Pro',
135
- iPhone_13_Pro_Max = 'iPhone 13 Pro Max',
136
- iPhone_7 = 'iPhone 7',
137
- iPhone_8 = 'iPhone 8',
138
- iPhone_X = 'iPhone X',
139
- iPhone_XR = 'iPhone XR',
140
- iPhone_XS = 'iPhone Xs',
681
+ iPhone_13_Pro_Max = 'iPhone 13 Pro Max',
682
+ iPhone_13_Pro = 'iPhone 13 Pro',
683
+ iPhone_13 = 'iPhone 13',
684
+ iPhone_12_Pro_Max = 'iPhone 12 Pro Max',
685
+ iPhone_12_Pro = 'iPhone 12 Pro',
686
+ iPhone_12 = 'iPhone 12',
687
+ iPhone_12_mini = 'iPhone 12 mini',
688
+ iPhone_11_Pro = 'iPhone 11 Pro',
689
+ iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
690
+ iPhone_11 = 'iPhone 11',
691
+ iPhone_XR = 'iPhone XR',
692
+ iPhone_XS = 'iPhone Xs',
693
+ iPhone_X = 'iPhone X',
694
+ iPhone_8 = 'iPhone 8',
695
+ iPhone_7 = 'iPhone 7',
696
+ iPad_Pro_3 = 'iPad Pro (12.9-inch) (3rd generation)',
697
+ iPad_7 = 'iPad (7th generation)',
698
+ iPad_9 = 'iPad (9th generation)',
699
+ iPad_Air_2 = 'iPad Air (2nd generation)'
141
700
  }
142
-
701
+ export type IosVersionPlain = "latest" | "latest-1";
143
702
  export enum IosVersion {
144
- LATEST = 'latest',
145
- /** @deprecated */
146
- LATEST_ONE_VERSION_BACK = 'latest-1',
147
- ONE_VERSION_BACK = 'latest-1',
703
+ LATEST = 'latest',
704
+ ONE_VERSION_BACK = 'latest-1',
705
+ LATEST_ONE_VERSION_BACK = 'latest-1'
148
706
  }
149
-
707
+ export type MatchLevelPlain = "None" | "Layout1" | "Layout" | "Layout2" | "Content" | "Strict" | "Exact";
150
708
  export enum MatchLevel {
151
- Content = 'Content',
152
- Exact = 'Exact',
153
- Layout = 'Layout',
154
- Layout2 = 'Layout2',
155
- LegacyLayout = 'Layout1',
156
- None = 'None',
157
- Strict = 'Strict',
709
+ None = 'None',
710
+ LegacyLayout = 'Layout1',
711
+ Layout = 'Layout',
712
+ Layout2 = 'Layout2',
713
+ Content = 'Content',
714
+ Strict = 'Strict',
715
+ Exact = 'Exact'
158
716
  }
159
-
717
+ export type ScreenOrientationPlain = "portrait" | "landscape";
160
718
  export enum ScreenOrientation {
161
- LANDSCAPE = 'landscape',
162
- PORTRAIT = 'portrait',
719
+ PORTRAIT = 'portrait',
720
+ LANDSCAPE = 'landscape'
163
721
  }
164
-
722
+ export type SessionTypePlain = "SEQUENTIAL" | "PROGRESSION";
165
723
  export enum SessionType {
166
- PROGRESSION = 'PROGRESSION',
167
- SEQUENTIAL = 'SEQUENTIAL',
724
+ SEQUENTIAL = 'SEQUENTIAL',
725
+ PROGRESSION = 'PROGRESSION'
168
726
  }
169
-
727
+ export type StitchModePlain = "Scroll" | "CSS";
170
728
  export enum StitchMode {
171
- CSS = 'CSS',
172
- SCROLL = 'Scroll',
729
+ SCROLL = 'Scroll',
730
+ CSS = 'CSS'
173
731
  }
174
-
732
+ export type TestResultsStatusPlain = "Passed" | "Failed" | "Unresolved";
175
733
  export enum TestResultsStatus {
176
- Failed = 'Failed',
177
- Passed = 'Passed',
178
- Unresolved = 'Unresolved',
734
+ Passed = 'Passed',
735
+ Unresolved = 'Unresolved',
736
+ Failed = 'Failed'
179
737
  }
180
-
181
- export class AccessibilityMatchSettings implements Required<AccessibilityMatchSettingsPlain> {
182
- constructor(settings: AccessibilityMatchSettingsPlain);
183
- constructor(region: RegionPlain);
184
- constructor(
185
- x: number,
186
- y: number,
187
- width: number,
188
- height: number,
189
- type?: 'IgnoreContrast' | 'RegularText' | 'LargeText' | 'BoldText' | 'GraphicalObject',
190
- );
191
- get region(): RegionPlain;
192
- set region(region: RegionPlain);
193
- get type(): 'IgnoreContrast' | 'RegularText' | 'LargeText' | 'BoldText' | 'GraphicalObject';
194
- set type(type: 'IgnoreContrast' | 'RegularText' | 'LargeText' | 'BoldText' | 'GraphicalObject');
195
- getHeight(): number;
196
- getLeft(): number;
197
- getRegion(): Region;
198
- getTop(): number;
199
- getType(): AccessibilityRegionType;
200
- getWidth(): number;
201
- setHeight(height: number): void;
202
- setLeft(left: number): void;
203
- setRegion(region: RegionPlain): void;
204
- setTop(top: number): void;
205
- setType(type: AccessibilityRegionTypePlain): void;
206
- setWidth(width: number): void;
207
- }
208
-
209
- export class ApiUrls implements Required<ApiUrlsPlain> {
210
- get baselineImage(): string;
211
- get checkpointImage(): string;
212
- get checkpointImageThumbnail(): string;
213
- get currentImage(): string;
214
- get diffImage(): string;
215
- getBaselineImage(): string;
216
- getCheckpointImage(): string;
217
- getCheckpointImageThumbnail(): string;
218
- getCurrentImage(): string;
219
- getDiffImage(): string;
220
- /** @deprecated */
221
- setBaselineImage(setBaselineImage: string): void;
222
- /** @deprecated */
223
- setCheckpointImage(checkpointImage: string): void;
224
- /** @deprecated */
225
- setCheckpointImageThumbnail(checkpointImageThumbnail: string): void;
226
- /** @deprecated */
227
- setCurrentImage(currentImage: string): void;
228
- /** @deprecated */
229
- setDiffImage(diffImage: string): void;
738
+ export class EyesError extends Error {
230
739
  }
231
-
232
- export class AppUrls implements Required<AppUrlsPlain> {
233
- get step(): string;
234
- get stepEditor(): string;
235
- getStep(): string;
236
- getStepEditor(): string;
237
- /** @deprecated */
238
- setStep(step: string): void;
239
- /** @deprecated */
240
- setStepEditor(stepEditor: string): void;
740
+ export class TestFailedError extends EyesError {
741
+ constructor(message: string, results?: TestResultsPlain);
742
+ constructor(results: TestResultsPlain);
743
+ get testResults(): TestResultsPlain;
744
+ getTestResults(): TestResults;
241
745
  }
242
-
243
- export class BatchClose {
244
- constructor(options?: {batchIds: string[]; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain});
245
- close(): Promise<void>;
246
- setApiKey(apiKey: string): this;
247
- setBatchIds(batchIds: string[]): this;
248
- setProxy(proxy: ProxySettingsPlain): this;
249
- setUrl(serverUrl: string): this;
250
- static close(settings: {
251
- batchIds: string[];
252
- serverUrl?: string;
253
- apiKey?: string;
254
- proxy?: ProxySettingsPlain;
255
- }): Promise<void>;
746
+ export class DiffsFoundError extends TestFailedError {
747
+ constructor(message: string, results?: TestResultsPlain);
748
+ constructor(results: TestResultsPlain);
256
749
  }
257
-
258
- export class BatchInfo implements Required<BatchInfoPlain> {
259
- constructor();
260
- constructor(batch?: BatchInfoPlain);
261
- constructor(name?: string, startedAt?: string | Date, id?: string);
262
- get id(): string;
263
- set id(id: string);
264
- get name(): string;
265
- set name(name: string);
266
- get notifyOnCompletion(): boolean;
267
- set notifyOnCompletion(notifyOnCompletion: boolean);
268
- get properties(): PropertyDataPlain[];
269
- set properties(properties: PropertyDataPlain[]);
270
- get sequenceName(): string;
271
- set sequenceName(sequenceName: string);
272
- get startedAt(): string | Date;
273
- set startedAt(startedAt: string | Date);
274
- addProperty(property: PropertyDataPlain): this;
275
- getId(): string;
276
- getName(): string;
277
- getNotifyOnCompletion(): boolean;
278
- getProperties(): PropertyData[];
279
- getSequenceName(): string;
280
- getStartedAt(): Date | string;
281
- setId(id: string): this;
282
- setName(name: string): this;
283
- setNotifyOnCompletion(notifyOnCompletion: boolean): this;
284
- setProperties(properties: PropertyDataPlain[]): this;
285
- setSequenceName(sequenceName: string): this;
286
- setStartedAt(startedAt: Date): this;
287
- setStartedAt(startedAt: string): this;
750
+ export class NewTestError extends TestFailedError {
751
+ constructor(message: string, results?: TestResultsPlain);
752
+ constructor(results: TestResultsPlain);
288
753
  }
289
-
290
- export class CheckSettings {
291
- constructor(settings?: CheckSettingsPlain);
292
- accessibilityRegion(region: {
293
- region: RegionPlain | Element | EyesSelector<Selector>;
294
- type?: AccessibilityRegionTypePlain;
295
- }): this;
296
- accessibilityRegion(region: RegionPlain, type?: AccessibilityRegionTypePlain): this;
297
- accessibilityRegion(region: Element, type?: AccessibilityRegionTypePlain): this;
298
- accessibilityRegion(region: EyesSelector<Selector>, type?: AccessibilityRegionTypePlain): this;
299
- accessibilityRegion(region: LegacyRegionPlain, type?: AccessibilityRegionTypePlain): this;
300
- accessibilityRegions(
301
- ...regions: (
302
- | {region: RegionPlain | Element | EyesSelector<Selector>; type?: AccessibilityRegionTypePlain}
303
- | RegionPlain
304
- | Element
305
- | EyesSelector<Selector>
306
- | LegacyRegionPlain
307
- )[]
308
- ): this;
309
- accessibilityRegions(
310
- type: AccessibilityRegionTypePlain,
311
- ...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]
312
- ): this;
313
- beforeRenderScreenshotHook(script: string): this;
314
- content(): this;
315
- contentRegion(region: RegionPlain): this;
316
- contentRegion(region: Element): this;
317
- contentRegion(region: EyesSelector<Selector>): this;
318
- contentRegion(region: LegacyRegionPlain): this;
319
- contentRegions(...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]): this;
320
- disableBrowserFetching(disableBrowserFetching: boolean): this;
321
- enablePatterns(enablePatterns?: boolean): this;
322
- exact(): this;
323
- /** @deprecated */
324
- floating(region: {
325
- region: RegionPlain | Element | EyesSelector<Selector>;
326
- maxUpOffset?: number;
327
- maxDownOffset?: number;
328
- maxLeftOffset?: number;
329
- maxRightOffset?: number;
330
- }): this;
331
- /** @deprecated */
332
- floating(region: RegionPlain): this;
333
- /** @deprecated */
334
- floating(region: Element): this;
335
- /** @deprecated */
336
- floating(region: EyesSelector<Selector>): this;
337
- /** @deprecated */
338
- floating(region: LegacyRegionPlain): this;
339
- floatingRegion(region: {
340
- region: RegionPlain | Element | EyesSelector<Selector>;
341
- maxUpOffset?: number;
342
- maxDownOffset?: number;
343
- maxLeftOffset?: number;
344
- maxRightOffset?: number;
345
- }): this;
346
- floatingRegion(
347
- region: RegionPlain,
348
- maxUpOffset?: number,
349
- maxDownOffset?: number,
350
- maxLeftOffset?: number,
351
- maxRightOffset?: number,
352
- ): this;
353
- floatingRegion(
354
- region: Element,
355
- maxUpOffset?: number,
356
- maxDownOffset?: number,
357
- maxLeftOffset?: number,
358
- maxRightOffset?: number,
359
- ): this;
360
- floatingRegion(
361
- region: EyesSelector<Selector>,
362
- maxUpOffset?: number,
363
- maxDownOffset?: number,
364
- maxLeftOffset?: number,
365
- maxRightOffset?: number,
366
- ): this;
367
- floatingRegion(
368
- region: LegacyRegionPlain,
369
- maxUpOffset?: number,
370
- maxDownOffset?: number,
371
- maxLeftOffset?: number,
372
- maxRightOffset?: number,
373
- ): this;
374
- floatingRegions(
375
- ...regions: (
376
- | {
377
- region: RegionPlain | Element | EyesSelector<Selector>;
378
- maxUpOffset?: number;
379
- maxDownOffset?: number;
380
- maxLeftOffset?: number;
381
- maxRightOffset?: number;
382
- }
383
- | RegionPlain
384
- | Element
385
- | EyesSelector<Selector>
386
- | LegacyRegionPlain
387
- )[]
388
- ): this;
389
- floatingRegions(
390
- maxOffset: number,
391
- ...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]
392
- ): this;
393
- /** @deprecated */
394
- floatings(
395
- ...regions: (
396
- | {
397
- region: RegionPlain | Element | EyesSelector<Selector>;
398
- maxUpOffset?: number;
399
- maxDownOffset?: number;
400
- maxLeftOffset?: number;
401
- maxRightOffset?: number;
402
- }
403
- | RegionPlain
404
- | Element
405
- | EyesSelector<Selector>
406
- | LegacyRegionPlain
407
- )[]
408
- ): this;
409
- /** @deprecated */
410
- floatings(
411
- maxOffset: number,
412
- ...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]
413
- ): this;
414
- frame(context: {
415
- frame: Element | EyesSelector<Selector> | string | number;
416
- scrollRootElement?: Element | EyesSelector<Selector>;
417
- }): this;
418
- frame(frame: Element, scrollRootElement?: Element): this;
419
- frame(frame: Element, scrollRootElement?: EyesSelector<Selector>): this;
420
- frame(frame: EyesSelector<Selector>, scrollRootElement?: Element): this;
421
- frame(frame: EyesSelector<Selector>, scrollRootElement?: EyesSelector<Selector>): this;
422
- frame(frame: string, scrollRootElement?: Element): this;
423
- frame(frame: string, scrollRootElement?: EyesSelector<Selector>): this;
424
- frame(frame: number, scrollRootElement?: Element): this;
425
- frame(frame: number, scrollRootElement?: EyesSelector<Selector>): this;
426
- fully(fully?: boolean): this;
427
- hook(name: string, script: string): this;
428
- /** @deprecated */
429
- ignore(region: RegionPlain): this;
430
- /** @deprecated */
431
- ignore(region: Element): this;
432
- /** @deprecated */
433
- ignore(region: EyesSelector<Selector>): this;
434
- /** @deprecated */
435
- ignore(region: LegacyRegionPlain): this;
436
- ignoreCaret(ignoreCaret?: boolean): this;
437
- ignoreDisplacements(ignoreDisplacements?: boolean): this;
438
- ignoreRegion(region: RegionPlain): this;
439
- ignoreRegion(region: Element): this;
440
- ignoreRegion(region: EyesSelector<Selector>): this;
441
- ignoreRegion(region: LegacyRegionPlain): this;
442
- ignoreRegions(...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]): this;
443
- /** @deprecated */
444
- ignores(...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]): this;
445
- layout(): this;
446
- layoutBreakpoints(layoutBreakpoints?: boolean): this;
447
- layoutBreakpoints(layoutBreakpoints?: number[]): this;
448
- layoutRegion(region: RegionPlain): this;
449
- layoutRegion(region: Element): this;
450
- layoutRegion(region: EyesSelector<Selector>): this;
451
- layoutRegion(region: LegacyRegionPlain): this;
452
- layoutRegions(...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]): this;
453
- matchLevel(matchLevel: MatchLevelPlain): this;
454
- /** @undocumented */
455
- name(name: string): this;
456
- region(region: RegionPlain): this;
457
- region(region: Element): this;
458
- region(region: EyesSelector<Selector>): this;
459
- region(region: LegacyRegionPlain): this;
460
- renderId(renderId: string): this;
461
- scrollRootElement(scrollRootElement: Element): this;
462
- scrollRootElement(scrollRootElement: EyesSelector<Selector>): this;
463
- sendDom(sendDom?: boolean): this;
464
- shadow(selector: EyesSelector<Selector>): this;
465
- /** @deprecated */
466
- stitchContent(stitchContent?: boolean): this;
467
- strict(): this;
468
- strictRegion(region: RegionPlain): this;
469
- strictRegion(region: Element): this;
470
- strictRegion(region: EyesSelector<Selector>): this;
471
- strictRegion(region: LegacyRegionPlain): this;
472
- strictRegions(...regions: (RegionPlain | Element | EyesSelector<Selector> | LegacyRegionPlain)[]): this;
473
- timeout(timeout: number): this;
474
- useDom(useDom?: boolean): this;
475
- variationGroupId(variationGroupId: string): this;
476
- visualGridOption(key: string, value: any): this;
477
- visualGridOptions(options: {[key: string]: any}): this;
478
- waitBeforeCapture(waitBeforeCapture: number): this;
479
- /** @deprecated */
480
- webHook(script: string): this;
481
- withName(name: string): this;
754
+ export type AccessibilityMatchSettingsPlain = { region: RegionPlain; type?: AccessibilityRegionTypePlain; };
755
+ export class AccessibilityMatchSettings implements Required<AccessibilityMatchSettingsPlain> {
756
+ constructor(settings: AccessibilityMatchSettingsPlain);
757
+ constructor(region: RegionPlain);
758
+ constructor(x: number, y: number, width: number, height: number, type?: AccessibilityRegionTypePlain);
759
+ get region(): RegionPlain;
760
+ set region(region: RegionPlain);
761
+ getRegion(): Region;
762
+ setRegion(region: RegionPlain): void;
763
+ getLeft(): number;
764
+ setLeft(left: number): void;
765
+ getTop(): number;
766
+ setTop(top: number): void;
767
+ getWidth(): number;
768
+ setWidth(width: number): void;
769
+ getHeight(): number;
770
+ setHeight(height: number): void;
771
+ get type(): AccessibilityRegionTypePlain;
772
+ set type(type: AccessibilityRegionTypePlain);
773
+ getType(): AccessibilityRegionType;
774
+ setType(type: AccessibilityRegionTypePlain): void;
482
775
  }
483
-
484
- export class ClassicRunner extends EyesRunner {}
485
-
486
- export class Configuration {
487
- constructor(config?: ConfigurationPlain);
488
- get agentId(): string;
489
- set agentId(agentId: string);
490
- get apiKey(): string;
491
- set apiKey(apiKey: string);
492
- get appName(): string;
493
- set appName(appName: string);
494
- get baselineBranchName(): string;
495
- set baselineBranchName(baselineBranchName: string);
496
- get baselineEnvName(): string;
497
- set baselineEnvName(baselineEnvName: string);
498
- get batch(): BatchInfoPlain;
499
- set batch(batch: BatchInfoPlain);
500
- get branchName(): string;
501
- set branchName(branchName: string);
502
- get browsersInfo(): (DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo)[];
503
- set browsersInfo(browsersInfo: (DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo)[]);
504
- get compareWithParentBranch(): boolean;
505
- set compareWithParentBranch(compareWithParentBranch: boolean);
506
- /** @undocumented */
507
- get concurrentSessions(): number;
508
- /** @undocumented */
509
- set concurrentSessions(concurrentSessions: number);
510
- /** @undocumented */
511
- get connectionTimeout(): number;
512
- /** @undocumented */
513
- set connectionTimeout(connectionTimeout: number);
514
- get cut(): CutProviderPlain;
515
- set cut(cut: CutProviderPlain);
516
- /** @undocumented */
517
- get debugScreenshots(): {save: boolean; path?: string; prefix?: string};
518
- /** @undocumented */
519
- set debugScreenshots(debugScreenshots: {save: boolean; path?: string; prefix?: string});
520
- get defaultMatchSettings(): ImageMatchSettingsPlain;
521
- set defaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain);
522
- get deviceInfo(): string;
523
- set deviceInfo(deviceInfo: string);
524
- get disableBrowserFetching(): boolean;
525
- set disableBrowserFetching(disableBrowserFetching: boolean);
526
- get displayName(): string;
527
- set displayName(displayName: string);
528
- /** @undocumented */
529
- get dontCloseBatches(): boolean;
530
- /** @undocumented */
531
- set dontCloseBatches(dontCloseBatches: boolean);
532
- get environmentName(): string;
533
- set environmentName(environmentName: string);
534
- get forceFullPageScreenshot(): boolean;
535
- set forceFullPageScreenshot(forceFullPageScreenshot: boolean);
536
- get hideCaret(): boolean;
537
- set hideCaret(hideCaret: boolean);
538
- get hideScrollbars(): boolean;
539
- set hideScrollbars(hideScrollbars: boolean);
540
- get hostApp(): string;
541
- set hostApp(hostApp: string);
542
- get hostAppInfo(): string;
543
- set hostAppInfo(hostAppInfo: string);
544
- get hostOS(): string;
545
- set hostOS(hostOS: string);
546
- get hostOSInfo(): string;
547
- set hostOSInfo(hostOSInfo: string);
548
- get ignoreBaseline(): boolean;
549
- set ignoreBaseline(ignoreBaseline: boolean);
550
- get isDisabled(): boolean;
551
- set isDisabled(isDisabled: boolean);
552
- get layoutBreakpoints(): boolean | number[];
553
- set layoutBreakpoints(layoutBreakpoints: boolean | number[]);
554
- /** @undocumented */
555
- get logs(): LogHandlerPlain;
556
- /** @undocumented */
557
- set logs(logs: LogHandlerPlain);
558
- get matchTimeout(): number;
559
- set matchTimeout(matchTimeout: number);
560
- get parentBranchName(): string;
561
- set parentBranchName(parentBranchName: string);
562
- get properties(): PropertyDataPlain[];
563
- set properties(properties: PropertyDataPlain[]);
564
- get proxy(): ProxySettingsPlain;
565
- set proxy(proxy: ProxySettingsPlain);
566
- /** @undocumented */
567
- get remoteEvents(): {accessKey?: string; serverUrl: string; timeout?: number};
568
- /** @undocumented */
569
- set remoteEvents(remoteEvents: {accessKey?: string; serverUrl: string; timeout?: number});
570
- /** @undocumented */
571
- get removeSession(): boolean;
572
- /** @undocumented */
573
- set removeSession(removeSession: boolean);
574
- get rotation(): ImageRotationPlain;
575
- set rotation(rotation: ImageRotationPlain);
576
- get saveDiffs(): boolean;
577
- set saveDiffs(saveDiffs: boolean);
578
- get saveFailedTests(): boolean;
579
- set saveFailedTests(saveFailedTests: boolean);
580
- get saveNewTests(): boolean;
581
- set saveNewTests(saveNewTests: boolean);
582
- get scaleRatio(): number;
583
- set scaleRatio(scaleRatio: number);
584
- get scrollRootElement(): Element | EyesSelector<Selector>;
585
- set scrollRootElement(scrollRootElement: Element | EyesSelector<Selector>);
586
- get sendDom(): boolean;
587
- set sendDom(sendDom: boolean);
588
- get serverUrl(): string;
589
- set serverUrl(serverUrl: string);
590
- get sessionType(): 'SEQUENTIAL' | 'PROGRESSION';
591
- set sessionType(sessionType: 'SEQUENTIAL' | 'PROGRESSION');
592
- get stitchMode(): 'Scroll' | 'CSS';
593
- set stitchMode(stitchMode: 'Scroll' | 'CSS');
594
- get stitchOverlap(): number;
595
- set stitchOverlap(stitchOverlap: number);
596
- get testName(): string;
597
- set testName(testName: string);
598
- get viewportSize(): RectangleSizePlain;
599
- set viewportSize(viewportSize: RectangleSizePlain);
600
- get visualGridOptions(): {[key: string]: any};
601
- set visualGridOptions(visualGridOptions: {[key: string]: any});
602
- get waitBeforeCapture(): number;
603
- set waitBeforeCapture(waitBeforeCapture: number);
604
- get waitBeforeScreenshots(): number;
605
- set waitBeforeScreenshots(waitBeforeScreenshots: number);
606
- addBrowser(browserInfo: DesktopBrowserInfo): this;
607
- addBrowser(browserInfo: ChromeEmulationInfo): this;
608
- addBrowser(browserInfo: IOSDeviceInfo): this;
609
- addBrowser(browserInfo: {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}): this;
610
- addBrowser(width: number, height: number, name?: BrowserTypePlain): this;
611
- addBrowsers(
612
- ...browsersInfo: (
613
- | DesktopBrowserInfo
614
- | ChromeEmulationInfo
615
- | IOSDeviceInfo
616
- | {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}
617
- )[]
618
- ): this;
619
- addDeviceEmulation(deviceName: DeviceNamePlain, screenOrientation?: ScreenOrientationPlain): this;
620
- addProperty(name: string, value: string): this;
621
- addProperty(prop: PropertyDataPlain): this;
622
- clearProperties(): this;
623
- getAccessibilityValidation(): AccessibilitySettings;
624
- getAgentId(): string;
625
- getApiKey(): string;
626
- getAppName(): string;
627
- getBaselineBranchName(): string;
628
- getBaselineEnvName(): string;
629
- getBatch(): BatchInfo;
630
- getBranchName(): string;
631
- getBrowsersInfo(): (
632
- | DesktopBrowserInfo
633
- | ChromeEmulationInfo
634
- | IOSDeviceInfo
635
- | {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}
636
- )[];
637
- getCompareWithParentBranch(): boolean;
638
- /** @undocumented */
639
- getConcurrentSessions(): number;
640
- /** @undocumented */
641
- getConnectionTimeout(): number;
642
- getCut(): CutProviderPlain;
643
- /** @undocumented */
644
- getDebugScreenshotsPath(): string;
645
- /** @undocumented */
646
- getDebugScreenshotsPrefix(): string;
647
- getDefaultMatchSettings(): ImageMatchSettingsPlain;
648
- getDeviceInfo(): string;
649
- getDisableBrowserFetching(): boolean;
650
- getDisplayName(): string;
651
- /** @undocumented */
652
- getDontCloseBatches(): boolean;
653
- getEnablePatterns(): boolean;
654
- getEnvironmentName(): string;
655
- getForceFullPageScreenshot(): boolean;
656
- getHideCaret(): boolean;
657
- getHideScrollbars(): boolean;
658
- getHostApp(): string;
659
- getHostAppInfo(): string;
660
- getHostOS(): string;
661
- getHostOSInfo(): string;
662
- getIgnoreBaseline(): boolean;
663
- getIgnoreCaret(): boolean;
664
- getIgnoreDisplacements(): boolean;
665
- getIsDisabled(): boolean;
666
- getLayoutBreakpoints(): boolean | number[];
667
- /** @undocumented */
668
- getLogHandler(): LogHandlerPlain;
669
- getMatchLevel(): MatchLevel;
670
- getMatchTimeout(): number;
671
- getParentBranchName(): string;
672
- getProperties(): PropertyData[];
673
- getProxy(): ProxySettings;
674
- /** @undocumented */
675
- getRemoteEvents(): {serverUrl: string; accessKey?: string; timeout?: number};
676
- /** @undocumented */
677
- getRemoveSession(): boolean;
678
- getRotation(): ImageRotation;
679
- /** @undocumented */
680
- getSaveDebugScreenshots(): boolean;
681
- getSaveDiffs(): boolean;
682
- getSaveFailedTests(): boolean;
683
- getSaveNewTests(): boolean;
684
- getScaleRatio(): number;
685
- getScrollRootElement(): Element | EyesSelector<Selector>;
686
- getSendDom(): boolean;
687
- getServerUrl(): string;
688
- getSessionType(): SessionType;
689
- /** @undocumented */
690
- getShowLogs(): boolean;
691
- getStitchMode(): StitchMode;
692
- getStitchOverlap(): number;
693
- getTestName(): string;
694
- getUseDom(): boolean;
695
- getViewportSize(): RectangleSize;
696
- getVisualGridOptions(): {[key: string]: any};
697
- getWaitBeforeCapture(): number;
698
- getWaitBeforeScreenshots(): number;
699
- setAccessibilityValidation(accessibilityValidation: AccessibilitySettings): this;
700
- setAgentId(agentId: string): this;
701
- setApiKey(apiKey: string): this;
702
- setAppName(appName: string): this;
703
- setBaselineBranchName(baselineBranchName: string): this;
704
- setBaselineEnvName(baselineEnvName: string): this;
705
- setBatch(batch: BatchInfoPlain): this;
706
- setBranchName(branchName: string): this;
707
- setBrowsersInfo(
708
- browsersInfo: (
709
- | DesktopBrowserInfo
710
- | ChromeEmulationInfo
711
- | IOSDeviceInfo
712
- | {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}
713
- )[],
714
- ): this;
715
- setCompareWithParentBranch(compareWithParentBranch: boolean): this;
716
- /** @undocumented */
717
- setConcurrentSessions(concurrentSessions: number): this;
718
- /** @undocumented */
719
- setConnectionTimeout(connectionTimeout: number): this;
720
- setCut(cut: CutProviderPlain): this;
721
- /** @undocumented */
722
- setDebugScreenshotsPath(path: string): this;
723
- /** @undocumented */
724
- setDebugScreenshotsPrefix(prefix: string): this;
725
- setDefaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain): this;
726
- setDeviceInfo(deviceInfo: string): this;
727
- setDisableBrowserFetching(disableBrowserFetching: boolean): this;
728
- setDisplayName(displayName: string): this;
729
- /** @undocumented */
730
- setDontCloseBatches(dontCloseBatches: boolean): this;
731
- setEnablePatterns(enablePatterns: boolean): this;
732
- setEnvironmentName(environmentName: string): this;
733
- setForceFullPageScreenshot(forceFullPageScreenshot: boolean): this;
734
- setHideCaret(hideCaret: boolean): this;
735
- setHideScrollbars(hideScrollbars: boolean): this;
736
- setHostApp(hostApp: string): this;
737
- setHostAppInfo(hostAppInfo: string): this;
738
- setHostOS(hostOS: string): this;
739
- setHostOSInfo(hostOSInfo: string): this;
740
- setIgnoreBaseline(ignoreBaseline: boolean): this;
741
- setIgnoreCaret(ignoreCaret: boolean): this;
742
- setIgnoreDisplacements(ignoreDisplacements: boolean): this;
743
- setIsDisabled(isDisabled: boolean): this;
744
- setLayoutBreakpoints(layoutBreakpoints: boolean): this;
745
- setLayoutBreakpoints(layoutBreakpoints: number[]): this;
746
- /** @undocumented */
747
- setLogHandler(handler: LogHandlerPlain): this;
748
- setMatchLevel(matchLevel: MatchLevelPlain): this;
749
- setMatchTimeout(matchTimeout: number): this;
750
- setParentBranchName(parentBranchName: string): this;
751
- setProperties(properties: PropertyDataPlain[]): this;
752
- setProxy(proxy: ProxySettingsPlain): this;
753
- setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): this;
754
- setProxy(isEnabled: false): this;
755
- /** @undocumented */
756
- setRemoteEvents(remoteEvents: {serverUrl: string; accessKey?: string; timeout?: number}): this;
757
- /** @undocumented */
758
- setRemoveSession(removeSession: boolean): this;
759
- setRotation(rotation: ImageRotationPlain): this;
760
- setRotation(rotation: ImageRotation): this;
761
- /** @undocumented */
762
- setSaveDebugScreenshots(save: boolean): this;
763
- setSaveDiffs(saveDiffs: boolean): this;
764
- setSaveFailedTests(saveFailedTests: boolean): this;
765
- setSaveNewTests(saveNewTests: boolean): this;
766
- setScaleRatio(scaleRatio: number): this;
767
- setScrollRootElement(scrollRootElement: Element): this;
768
- setScrollRootElement(scrollRootElement: EyesSelector<Selector>): this;
769
- setSendDom(sendDom: boolean): this;
770
- setServerUrl(serverUrl: string): this;
771
- setSessionType(sessionType: SessionTypePlain): this;
772
- /** @undocumented */
773
- setShowLogs(show: boolean): this;
774
- setStitchMode(stitchMode: StitchModePlain): this;
775
- setStitchOverlap(stitchOverlap: number): this;
776
- setTestName(testName: string): this;
777
- setUseDom(useDom: boolean): this;
778
- setViewportSize(viewportSize: RectangleSizePlain): this;
779
- setVisualGridOption(key: string, value: any): this;
780
- setVisualGridOptions(visualGridOptions: {[key: string]: any}): this;
781
- setWaitBeforeCapture(waitBeforeCapture: number): this;
782
- setWaitBeforeScreenshots(waitBeforeScreenshots: number): this;
776
+ export type AccessibilitySettings = { level?: AccessibilityLevelPlain; guidelinesVersion?: AccessibilityGuidelinesVersionPlain; };
777
+ export type BatchInfoPlain = {
778
+ id?: string;
779
+ name?: string;
780
+ sequenceName?: string;
781
+ startedAt?: string | Date;
782
+ notifyOnCompletion?: boolean;
783
+ properties?: Array<PropertyDataPlain>;
784
+ };
785
+ export class BatchInfo implements Required<BatchInfoPlain> {
786
+ constructor();
787
+ constructor(batch?: BatchInfoPlain);
788
+ constructor(name?: string, startedAt?: string | Date, id?: string);
789
+ get id(): string;
790
+ set id(id: string);
791
+ getId(): string;
792
+ setId(id: string): BatchInfo;
793
+ get name(): string;
794
+ set name(name: string);
795
+ getName(): string;
796
+ setName(name: string): BatchInfo;
797
+ get sequenceName(): string;
798
+ set sequenceName(sequenceName: string);
799
+ getSequenceName(): string;
800
+ setSequenceName(sequenceName: string): BatchInfo;
801
+ get startedAt(): string | Date;
802
+ set startedAt(startedAt: string | Date);
803
+ getStartedAt(): string | Date;
804
+ setStartedAt(startedAt: string | Date): BatchInfo;
805
+ get notifyOnCompletion(): boolean;
806
+ set notifyOnCompletion(notifyOnCompletion: boolean);
807
+ getNotifyOnCompletion(): boolean;
808
+ setNotifyOnCompletion(notifyOnCompletion: boolean): BatchInfo;
809
+ get properties(): Array<PropertyDataPlain>;
810
+ set properties(properties: Array<PropertyDataPlain>);
811
+ getProperties(): Array<PropertyData>;
812
+ setProperties(properties: Array<PropertyDataPlain>): BatchInfo;
813
+ addProperty(property: PropertyDataPlain): BatchInfo;
783
814
  }
784
-
785
- export class ConsoleLogHandler extends LogHandler implements ConsoleLogHandlerPlain {
786
- readonly type: 'console';
787
- close(): void;
788
- onMessage(): void;
789
- open(): void;
815
+ export type CutProviderPlain = { top: number; right: number; bottom: number; left: number; } | { x: number; y: number; width: number; height: number; };
816
+ export class CutProvider implements Required<{
817
+ x: number;
818
+ y: number;
819
+ width: number;
820
+ height: number;
821
+ top: number;
822
+ right: number;
823
+ bottom: number;
824
+ left: number;
825
+ }> {
826
+ constructor(rectOrRegion: CutProviderPlain);
827
+ constructor(top: number, bottom: number, left: number, right: number);
828
+ get top(): number;
829
+ get right(): number;
830
+ get bottom(): number;
831
+ get left(): number;
832
+ get width(): number;
833
+ get height(): number;
834
+ get x(): number;
835
+ get y(): number;
836
+ scale(scaleRatio: number): CutProvider;
790
837
  }
791
-
792
- export class CutProvider
793
- implements
794
- Required<
795
- {x: number; y: number; width: number; height: number} & {top: number; right: number; bottom: number; left: number}
796
- > {
797
- constructor(rectOrRegion: CutProviderPlain);
798
- constructor(top: number, bottom: number, left: number, right: number);
799
- get bottom(): number;
800
- get height(): number;
801
- get left(): number;
802
- get right(): number;
803
- get top(): number;
804
- get width(): number;
805
- get x(): number;
806
- get y(): number;
807
- scale(scaleRatio: number): CutProvider;
838
+ export class FixedCutProvider extends CutProvider {
808
839
  }
809
-
810
- export class DiffsFoundError extends TestFailedError {
811
- constructor(message: string, results?: TestResultsPlain);
812
- constructor(results: TestResultsPlain);
840
+ export class UnscaledFixedCutProvider extends CutProvider {
841
+ scale(): UnscaledFixedCutProvider;
813
842
  }
814
-
815
- /** @undocumented */
843
+ export type ExactMatchSettingsPlain = { minDiffIntensity: number; minDiffWidth: number; minDiffHeight: number; matchThreshold: number; };
816
844
  export class ExactMatchSettings implements Required<ExactMatchSettingsPlain> {
817
- constructor(settings: ExactMatchSettingsPlain);
818
- get matchThreshold(): number;
819
- set matchThreshold(matchThreshold: number);
820
- get minDiffHeight(): number;
821
- set minDiffHeight(minDiffHeight: number);
822
- get minDiffIntensity(): number;
823
- set minDiffIntensity(minDiffIntensity: number);
824
- get minDiffWidth(): number;
825
- set minDiffWidth(minDiffWidth: number);
826
- getMatchThreshold(): number;
827
- getMinDiffHeight(): number;
828
- getMinDiffIntensity(): number;
829
- getMinDiffWidth(): number;
830
- setMatchThreshold(value: number): void;
831
- setMinDiffHeight(value: number): void;
832
- setMinDiffIntensity(value: number): void;
833
- setMinDiffWidth(value: number): void;
834
- }
835
-
836
- export class Eyes {
837
- constructor(runner?: EyesRunner, config?: ConfigurationPlain);
838
- constructor(config?: ConfigurationPlain);
839
- static setViewportSize(driver: Driver, viewportSize: RectangleSize): Promise<void>;
840
- get configuration(): ConfigurationPlain;
841
- set configuration(config: ConfigurationPlain);
842
- get driver(): Driver;
843
- get isOpen(): boolean;
844
- get logger(): Logger;
845
- get runner(): EyesRunner;
846
- abort(): Promise<TestResults>;
847
- /** @deprecated */
848
- abortAsync(): Promise<void>;
849
- /** @deprecated */
850
- abortIfNotClosed(): Promise<TestResultsPlain>;
851
- addProperty(name: string, value: string): Configuration;
852
- /**
853
- * @undocumented
854
- * @deprecated
855
- */
856
- addSessionEventHandler(handler: SessionEventHandler): void;
857
- check(name: string, checkSettings: CheckSettings): Promise<MatchResult>;
858
- check(checkSettings?: CheckSettingsPlain): Promise<MatchResult>;
859
- /** @deprecated */
860
- checkElement(element: Element, timeout?: number, name?: string): Promise<MatchResult>;
861
- /** @deprecated */
862
- checkElementBy(selector: EyesSelector<Selector>, timeout?: number, name?: string): Promise<MatchResult>;
863
- /** @deprecated */
864
- checkFrame(element: Element, timeout?: number, name?: string): Promise<MatchResult>;
865
- /** @deprecated */
866
- checkFrame(element: EyesSelector<Selector>, timeout?: number, name?: string): Promise<MatchResult>;
867
- /** @deprecated */
868
- checkFrame(element: string, timeout?: number, name?: string): Promise<MatchResult>;
869
- /** @deprecated */
870
- checkFrame(element: number, timeout?: number, name?: string): Promise<MatchResult>;
871
- /** @deprecated */
872
- checkRegion(region?: RegionPlain, name?: string, timeout?: number): Promise<MatchResult>;
873
- /** @deprecated */
874
- checkRegionBy(
875
- selector: EyesSelector<Selector>,
876
- name?: string,
877
- timeout?: number,
878
- fully?: boolean,
879
- ): Promise<MatchResult>;
880
- /** @deprecated */
881
- checkRegionByElement(element: Element, name?: string, timeout?: number): Promise<MatchResult>;
882
- /** @deprecated */
883
- checkRegionInFrame(
884
- frame: Element,
885
- selector: EyesSelector<Selector>,
886
- timeout?: number,
887
- name?: string,
888
- fully?: boolean,
889
- ): Promise<MatchResult>;
890
- /** @deprecated */
891
- checkRegionInFrame(
892
- frame: EyesSelector<Selector>,
893
- selector: EyesSelector<Selector>,
894
- timeout?: number,
895
- name?: string,
896
- fully?: boolean,
897
- ): Promise<MatchResult>;
898
- /** @deprecated */
899
- checkRegionInFrame(
900
- frame: string,
901
- selector: EyesSelector<Selector>,
902
- timeout?: number,
903
- name?: string,
904
- fully?: boolean,
905
- ): Promise<MatchResult>;
906
- /** @deprecated */
907
- checkRegionInFrame(
908
- frame: number,
909
- selector: EyesSelector<Selector>,
910
- timeout?: number,
911
- name?: string,
912
- fully?: boolean,
913
- ): Promise<MatchResult>;
914
- /** @deprecated */
915
- checkWindow(name?: string, timeout?: number, fully?: boolean): Promise<MatchResult>;
916
- clearProperties(): Configuration;
917
- /**
918
- * @undocumented
919
- * @deprecated
920
- */
921
- clearSessionEventHandlers(): void;
922
- close(throwErr?: boolean): Promise<TestResults>;
923
- /** @deprecated */
924
- closeAsync(): Promise<void>;
925
- extractText(regions: OCRRegion[]): Promise<string[]>;
926
- extractTextRegions<TPattern extends string>(settings: OCRSettings<TPattern>): Promise<Record<TPattern, TextRegion[]>>;
927
- getApiKey(): string;
928
- getAppName(): string;
929
- getBaselineBranchName(): string;
930
- getBaselineEnvName(): string;
931
- /** @deprecated */
932
- getBaselineName(): string;
933
- getBatch(): BatchInfo;
934
- getBranchName(): string;
935
- getConfiguration(): Configuration;
936
- getDebugScreenshotsPath(): string;
937
- getDebugScreenshotsPrefix(): string;
938
- getDeviceInfo(): string;
939
- getDriver(): Driver;
940
- getForceFullPageScreenshot(): boolean;
941
- getHideCaret(): boolean;
942
- getHideScrollbars(): boolean;
943
- getHostApp(): string;
944
- getHostAppInfo(): string;
945
- getHostOS(): string;
946
- getHostOSInfo(): string;
947
- getIgnoreCaret(): boolean;
948
- getIsCutProviderExplicitlySet(): boolean;
949
- getIsDisabled(): boolean;
950
- getIsOpen(): boolean;
951
- getLogHandler(): LogHandler;
952
- getLogger(): Logger;
953
- getMatchLevel(): MatchLevel;
954
- getMatchTimeout(): number;
955
- getParentBranchName(): string;
956
- getProxy(): ProxySettings;
957
- getRotation(): ImageRotation;
958
- getRunner(): EyesRunner;
959
- getSaveDebugScreenshots(): boolean;
960
- getSaveDiffs(): boolean;
961
- getSaveNewTests(): boolean;
962
- getScaleRatio(): number;
963
- getScrollRootElement(): Element | EyesSelector<Selector>;
964
- getSendDom(): boolean;
965
- getServerUrl(): string;
966
- /**
967
- * @undocumented
968
- * @deprecated
969
- */
970
- getSessionEventHandlers(): SessionEventHandlers;
971
- getStitchMode(): StitchMode;
972
- getStitchOverlap(): number;
973
- getTestName(): string;
974
- getViewportSize(): Promise<RectangleSize>;
975
- getWaitBeforeScreenshots(): number;
976
- locate<TLocator extends string>(settings: VisualLocatorSettings<TLocator>): Promise<Record<TLocator, RegionPlain[]>>;
977
- /** @undocumented */
978
- off(event: string): void;
979
- /** @undocumented */
980
- off(handler: {(...args: any[]): any}): void;
981
- /** @undocumented */
982
- on(handler: {(event: string, data?: Record<string, any>): any}): {(): void};
983
- /** @undocumented */
984
- on(event: 'setSizeWillStart', handler: {(data: {viewportSize: RectangleSizePlain}): any}): {(): void};
985
- /** @undocumented */
986
- on(event: 'setSizeEnded', handler: {(): any}): {(): void};
987
- /** @undocumented */
988
- on(event: 'initStarted', handler: {(): any}): {(): void};
989
- /** @undocumented */
990
- on(event: 'initEnded', handler: {(): any}): {(): void};
991
- /** @undocumented */
992
- on(event: 'testStarted', handler: {(data: {sessionId: string}): any}): {(): void};
993
- /** @undocumented */
994
- on(
995
- event: 'validationWillStart',
996
- handler: {(data: {sessionId: string; validationInfo: ValidationInfoPlain}): any},
997
- ): {(): void};
998
- /** @undocumented */
999
- on(
1000
- event: 'validationEnded',
1001
- handler: {(data: {sessionId: string; validationId: number; validationResult: ValidationResultPlain}): any},
1002
- ): {(): void};
1003
- /** @undocumented */
1004
- on(event: 'testEnded', handler: {(data: {sessionId: string; testResults: TestResultsPlain}): any}): {(): void};
1005
- open(driver: Driver, config?: ConfigurationPlain): Promise<Driver>;
1006
- open(
1007
- driver: Driver,
1008
- appName?: string,
1009
- testName?: string,
1010
- viewportSize?: RectangleSizePlain,
1011
- sessionType?: SessionTypePlain,
1012
- ): Promise<Driver>;
1013
- /**
1014
- * @undocumented
1015
- * @deprecated
1016
- */
1017
- removeSessionEventHandler(handler: SessionEventHandler): void;
1018
- setApiKey(apiKey: string): void;
1019
- setAppName(appName: string): void;
1020
- setBaselineBranchName(baselineBranchName: string): void;
1021
- setBaselineEnvName(baselineEnvName: string): void;
1022
- /** @deprecated */
1023
- setBaselineName(baselineName: string): void;
1024
- setBatch(batch: BatchInfoPlain): void;
1025
- setBatch(name: string, id?: string, startedAt?: Date): void;
1026
- setBatch(name: string, id?: string, startedAt?: string): void;
1027
- setBranchName(branchName: string): void;
1028
- setConfiguration(config: ConfigurationPlain): void;
1029
- setCutProvider(cutProvider: CutProvider): void;
1030
- setDebugScreenshotsPath(path: string): void;
1031
- setDebugScreenshotsPrefix(prefix: string): void;
1032
- setDeviceInfo(deviceInfo: string): void;
1033
- setForceFullPageScreenshot(forceFullPageScreenshot: boolean): void;
1034
- setHideCaret(hideCaret: boolean): void;
1035
- setHideScrollbars(hideScrollbars: boolean): void;
1036
- setHostApp(hostApp: string): void;
1037
- setHostAppInfo(hostAppInfo: string): void;
1038
- setHostOS(hostOS: string): void;
1039
- setHostOSInfo(hostOSInfo: string): void;
1040
- setIgnoreCaret(ignoreCaret: boolean): void;
1041
- setImageCut(cutProvider: CutProvider): void;
1042
- setIsDisabled(isDisabled: boolean): void;
1043
- setLogHandler(handler: LogHandler): void;
1044
- setMatchLevel(matchLevel: MatchLevelPlain): void;
1045
- setMatchTimeout(matchTimeout: number): void;
1046
- setParentBranchName(parentBranchName: string): void;
1047
- setProxy(proxy: ProxySettingsPlain): void;
1048
- setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): void;
1049
- setProxy(isEnabled: false): void;
1050
- setRotation(rotation: ImageRotationPlain): void;
1051
- setRotation(rotation: ImageRotation): void;
1052
- setSaveDebugScreenshots(save: boolean): void;
1053
- setSaveDiffs(saveDiffs: boolean): void;
1054
- setSaveNewTests(saveNewTests: boolean): void;
1055
- setScaleRatio(scaleRatio: number): void;
1056
- setScrollRootElement(scrollRootElement: Element): void;
1057
- setScrollRootElement(scrollRootElement: EyesSelector<Selector>): void;
1058
- setSendDom(sendDom: boolean): void;
1059
- setServerUrl(serverUrl: string): void;
1060
- setStitchMode(stitchMode: StitchModePlain): void;
1061
- setStitchOverlap(stitchOverlap: number): void;
1062
- setTestName(testName: string): void;
1063
- setViewportSize(size: RectangleSizePlain): Promise<void>;
1064
- setWaitBeforeScreenshots(waitBeforeScreenshots: number): void;
1065
- }
1066
-
1067
- export class EyesError extends Error {}
1068
-
1069
- export abstract class EyesRunner {
1070
- constructor();
1071
- getAllTestResults(throwErr?: boolean): Promise<TestResultsSummary>;
845
+ constructor(settings: ExactMatchSettingsPlain);
846
+ get minDiffIntensity(): number;
847
+ set minDiffIntensity(minDiffIntensity: number);
848
+ getMinDiffIntensity(): number;
849
+ setMinDiffIntensity(value: number): void;
850
+ get minDiffWidth(): number;
851
+ set minDiffWidth(minDiffWidth: number);
852
+ getMinDiffWidth(): number;
853
+ setMinDiffWidth(value: number): void;
854
+ get minDiffHeight(): number;
855
+ set minDiffHeight(minDiffHeight: number);
856
+ getMinDiffHeight(): number;
857
+ setMinDiffHeight(value: number): void;
858
+ get matchThreshold(): number;
859
+ set matchThreshold(matchThreshold: number);
860
+ getMatchThreshold(): number;
861
+ setMatchThreshold(value: number): void;
1072
862
  }
1073
-
1074
- export class FileLogHandler extends LogHandler implements FileLogHandlerPlain {
1075
- constructor(verbose?: boolean, filename?: string, append?: boolean);
1076
- readonly append: boolean;
1077
- readonly filename: string;
1078
- readonly type: 'file';
1079
- close(): void;
1080
- onMessage(): void;
1081
- open(): void;
1082
- }
1083
-
1084
- export class FixedCutProvider extends CutProvider {}
1085
-
1086
- /** @undocumented */
863
+ export type FloatingMatchSettingsPlain = {
864
+ region: RegionPlain;
865
+ maxUpOffset?: number;
866
+ maxDownOffset?: number;
867
+ maxLeftOffset?: number;
868
+ maxRightOffset?: number;
869
+ };
1087
870
  export class FloatingMatchSettings implements Required<FloatingMatchSettingsPlain> {
1088
- constructor(settings: FloatingMatchSettingsPlain);
1089
- constructor(region: RegionPlain);
1090
- constructor(
1091
- x: number,
1092
- y: number,
1093
- width: number,
1094
- height: number,
1095
- maxUpOffset?: number,
1096
- maxDownOffset?: number,
1097
- maxLeftOffset?: number,
1098
- maxRightOffset?: number,
1099
- );
1100
- get maxDownOffset(): number;
1101
- set maxDownOffset(maxDownOffset: number);
1102
- get maxLeftOffset(): number;
1103
- set maxLeftOffset(maxLeftOffset: number);
1104
- get maxRightOffset(): number;
1105
- set maxRightOffset(maxRightOffset: number);
1106
- get maxUpOffset(): number;
1107
- set maxUpOffset(maxUpOffset: number);
1108
- get region(): RegionPlain;
1109
- set region(region: RegionPlain);
1110
- getHeight(): number;
1111
- getLeft(): number;
1112
- getMaxDownOffset(): number;
1113
- getMaxLeftOffset(): number;
1114
- getMaxRightOffset(): number;
1115
- getMaxUpOffset(): number;
1116
- getRegion(): Region;
1117
- getTop(): number;
1118
- getWidth(): number;
1119
- setHeight(height: number): void;
1120
- setLeft(left: number): void;
1121
- setMaxDownOffset(maxDownOffset: number): void;
1122
- setMaxLeftOffset(maxLeftOffset: number): void;
1123
- setMaxRightOffset(maxRightOffset: number): void;
1124
- setMaxUpOffset(maxUpOffset: number): void;
1125
- setRegion(region: RegionPlain): void;
1126
- setTop(top: number): void;
1127
- setWidth(width: number): void;
871
+ constructor(settings: FloatingMatchSettingsPlain);
872
+ constructor(region: RegionPlain);
873
+ constructor(x: number, y: number, width: number, height: number, maxUpOffset?: number, maxDownOffset?: number, maxLeftOffset?: number, maxRightOffset?: number);
874
+ get region(): RegionPlain;
875
+ set region(region: RegionPlain);
876
+ getRegion(): Region;
877
+ setRegion(region: RegionPlain): void;
878
+ getLeft(): number;
879
+ setLeft(left: number): void;
880
+ getTop(): number;
881
+ setTop(top: number): void;
882
+ getWidth(): number;
883
+ setWidth(width: number): void;
884
+ getHeight(): number;
885
+ setHeight(height: number): void;
886
+ get maxUpOffset(): number;
887
+ set maxUpOffset(maxUpOffset: number);
888
+ getMaxUpOffset(): number;
889
+ setMaxUpOffset(maxUpOffset: number): void;
890
+ get maxDownOffset(): number;
891
+ set maxDownOffset(maxDownOffset: number);
892
+ getMaxDownOffset(): number;
893
+ setMaxDownOffset(maxDownOffset: number): void;
894
+ get maxLeftOffset(): number;
895
+ set maxLeftOffset(maxLeftOffset: number);
896
+ getMaxLeftOffset(): number;
897
+ setMaxLeftOffset(maxLeftOffset: number): void;
898
+ get maxRightOffset(): number;
899
+ set maxRightOffset(maxRightOffset: number);
900
+ getMaxRightOffset(): number;
901
+ setMaxRightOffset(maxRightOffset: number): void;
1128
902
  }
1129
-
1130
- /** @undocumented */
903
+ export type ImageMatchSettingsPlain = {
904
+ exact?: ExactMatchSettingsPlain;
905
+ matchLevel?: MatchLevelPlain;
906
+ ignoreCaret?: boolean;
907
+ useDom?: boolean;
908
+ enablePatterns?: boolean;
909
+ ignoreDisplacements?: boolean;
910
+ ignoreRegions?: Array<RegionPlain>;
911
+ layoutRegions?: Array<RegionPlain>;
912
+ strictRegions?: Array<RegionPlain>;
913
+ contentRegions?: Array<RegionPlain>;
914
+ floatingRegions?: Array<FloatingMatchSettingsPlain | RegionPlain>;
915
+ accessibilityRegions?: Array<AccessibilityMatchSettingsPlain | RegionPlain>;
916
+ accessibilitySettings?: AccessibilitySettings;
917
+ };
1131
918
  export class ImageMatchSettings implements Required<ImageMatchSettingsPlain> {
1132
- constructor(settings?: ImageMatchSettingsPlain);
1133
- get accessibility(): (RegionPlain | AccessibilityMatchSettingsPlain)[];
1134
- set accessibility(accessibilityRegions: (RegionPlain | AccessibilityMatchSettingsPlain)[]);
1135
- get accessibilityRegions(): (RegionPlain | AccessibilityMatchSettingsPlain)[];
1136
- set accessibilityRegions(accessibilityRegions: (RegionPlain | AccessibilityMatchSettingsPlain)[]);
1137
- get accessibilitySettings(): AccessibilitySettings;
1138
- set accessibilitySettings(accessibilitySettings: AccessibilitySettings);
1139
- get content(): RegionPlain[];
1140
- set content(contentRegions: RegionPlain[]);
1141
- get contentRegions(): RegionPlain[];
1142
- set contentRegions(contentRegions: RegionPlain[]);
1143
- get enablePatterns(): boolean;
1144
- set enablePatterns(enablePatterns: boolean);
1145
- get exact(): ExactMatchSettingsPlain;
1146
- set exact(exact: ExactMatchSettingsPlain);
1147
- get floating(): (RegionPlain | FloatingMatchSettingsPlain)[];
1148
- set floating(floatingRegions: (RegionPlain | FloatingMatchSettingsPlain)[]);
1149
- get floatingRegions(): (RegionPlain | FloatingMatchSettingsPlain)[];
1150
- set floatingRegions(floatingRegions: (RegionPlain | FloatingMatchSettingsPlain)[]);
1151
- get ignoreCaret(): boolean;
1152
- set ignoreCaret(ignoreCaret: boolean);
1153
- get ignoreDisplacements(): boolean;
1154
- set ignoreDisplacements(ignoreDisplacements: boolean);
1155
- get ignoreRegions(): RegionPlain[];
1156
- set ignoreRegions(ignoreRegions: RegionPlain[]);
1157
- get layout(): RegionPlain[];
1158
- set layout(layoutRegions: RegionPlain[]);
1159
- get layoutRegions(): RegionPlain[];
1160
- set layoutRegions(layoutRegions: RegionPlain[]);
1161
- get matchLevel(): 'None' | 'Layout1' | 'Layout' | 'Layout2' | 'Content' | 'Strict' | 'Exact';
1162
- set matchLevel(matchLevel: 'None' | 'Layout1' | 'Layout' | 'Layout2' | 'Content' | 'Strict' | 'Exact');
1163
- get strict(): RegionPlain[];
1164
- set strict(strictRegions: RegionPlain[]);
1165
- get strictRegions(): RegionPlain[];
1166
- set strictRegions(strictRegions: RegionPlain[]);
1167
- get useDom(): boolean;
1168
- set useDom(useDom: boolean);
1169
- getAccessibilityRegions(): AccessibilityMatchSettings[];
1170
- getAccessibilitySettings(): AccessibilitySettings;
1171
- getContentRegions(): Region[];
1172
- getEnablePatterns(): boolean;
1173
- getExact(): ExactMatchSettings;
1174
- getFloatingRegions(): FloatingMatchSettings[];
1175
- getIgnoreCaret(): boolean;
1176
- getIgnoreDisplacements(): boolean;
1177
- getIgnoreRegions(): Region[];
1178
- getLayoutRegions(): Region[];
1179
- getMatchLevel(): MatchLevel;
1180
- getStrictRegions(): Region[];
1181
- getUseDom(): boolean;
1182
- setAccessibilityRegions(accessibilityRegions: AccessibilityMatchSettingsPlain[]): void;
1183
- setAccessibilitySettings(accessibilitySettings: AccessibilitySettings): void;
1184
- setContentRegions(contentRegions: RegionPlain[]): void;
1185
- setEnablePatterns(enablePatterns: boolean): void;
1186
- setExact(exact: ExactMatchSettingsPlain): void;
1187
- setFloatingRegions(floatingRegions: FloatingMatchSettingsPlain[]): void;
1188
- setIgnoreCaret(ignoreCaret: boolean): void;
1189
- setIgnoreDisplacements(ignoreDisplacements: boolean): void;
1190
- setIgnoreRegions(ignoreRegions: RegionPlain[]): void;
1191
- setLayoutRegions(layoutRegions: RegionPlain[]): void;
1192
- setMatchLevel(matchLevel: MatchLevelPlain): void;
1193
- setStrictRegions(strictRegions: RegionPlain[]): void;
1194
- setUseDom(useDom: boolean): void;
919
+ constructor(settings?: ImageMatchSettingsPlain);
920
+ get exact(): ExactMatchSettingsPlain;
921
+ set exact(exact: ExactMatchSettingsPlain);
922
+ getExact(): ExactMatchSettings;
923
+ setExact(exact: ExactMatchSettingsPlain): void;
924
+ get matchLevel(): MatchLevelPlain;
925
+ set matchLevel(matchLevel: MatchLevelPlain);
926
+ getMatchLevel(): MatchLevel;
927
+ setMatchLevel(matchLevel: MatchLevelPlain): void;
928
+ get ignoreCaret(): boolean;
929
+ set ignoreCaret(ignoreCaret: boolean);
930
+ getIgnoreCaret(): boolean;
931
+ setIgnoreCaret(ignoreCaret: boolean): void;
932
+ get useDom(): boolean;
933
+ set useDom(useDom: boolean);
934
+ getUseDom(): boolean;
935
+ setUseDom(useDom: boolean): void;
936
+ get enablePatterns(): boolean;
937
+ set enablePatterns(enablePatterns: boolean);
938
+ getEnablePatterns(): boolean;
939
+ setEnablePatterns(enablePatterns: boolean): void;
940
+ get ignoreDisplacements(): boolean;
941
+ set ignoreDisplacements(ignoreDisplacements: boolean);
942
+ getIgnoreDisplacements(): boolean;
943
+ setIgnoreDisplacements(ignoreDisplacements: boolean): void;
944
+ get ignoreRegions(): Array<RegionPlain>;
945
+ set ignoreRegions(ignoreRegions: Array<RegionPlain>);
946
+ getIgnoreRegions(): Array<Region>;
947
+ setIgnoreRegions(ignoreRegions: Array<RegionPlain>): void;
948
+ get layoutRegions(): Array<RegionPlain>;
949
+ set layoutRegions(layoutRegions: Array<RegionPlain>);
950
+ get layout(): Array<RegionPlain>;
951
+ set layout(layout: Array<RegionPlain>);
952
+ getLayoutRegions(): Array<Region>;
953
+ setLayoutRegions(layoutRegions: Array<RegionPlain>): void;
954
+ get strictRegions(): Array<RegionPlain>;
955
+ set strictRegions(strictRegions: Array<RegionPlain>);
956
+ get strict(): Array<RegionPlain>;
957
+ set strict(strict: Array<RegionPlain>);
958
+ getStrictRegions(): Array<Region>;
959
+ setStrictRegions(strictRegions: Array<RegionPlain>): void;
960
+ get contentRegions(): Array<RegionPlain>;
961
+ set contentRegions(contentRegions: Array<RegionPlain>);
962
+ get content(): Array<RegionPlain>;
963
+ set content(content: Array<RegionPlain>);
964
+ getContentRegions(): Array<Region>;
965
+ setContentRegions(contentRegions: Array<RegionPlain>): void;
966
+ get floatingRegions(): Array<FloatingMatchSettingsPlain | RegionPlain>;
967
+ set floatingRegions(floatingRegions: Array<FloatingMatchSettingsPlain | RegionPlain>);
968
+ get floating(): Array<FloatingMatchSettingsPlain | RegionPlain>;
969
+ set floating(floating: Array<FloatingMatchSettingsPlain | RegionPlain>);
970
+ getFloatingRegions(): Array<FloatingMatchSettings>;
971
+ setFloatingRegions(floatingRegions: Array<FloatingMatchSettingsPlain>): void;
972
+ get accessibilityRegions(): Array<AccessibilityMatchSettingsPlain | RegionPlain>;
973
+ set accessibilityRegions(accessibilityRegions: Array<AccessibilityMatchSettingsPlain | RegionPlain>);
974
+ get accessibility(): Array<AccessibilityMatchSettingsPlain | RegionPlain>;
975
+ set accessibility(accessibility: Array<AccessibilityMatchSettingsPlain | RegionPlain>);
976
+ getAccessibilityRegions(): Array<AccessibilityMatchSettings>;
977
+ setAccessibilityRegions(accessibilityRegions: Array<AccessibilityMatchSettingsPlain>): void;
978
+ get accessibilitySettings(): AccessibilitySettings;
979
+ set accessibilitySettings(accessibilitySettings: AccessibilitySettings);
980
+ getAccessibilitySettings(): AccessibilitySettings;
981
+ setAccessibilitySettings(accessibilitySettings: AccessibilitySettings): void;
1195
982
  }
1196
-
983
+ export type ImageRotationPlain = 0 | 270 | -270 | 180 | -180 | 90 | -90;
1197
984
  export class ImageRotation {
1198
- constructor(rotation: ImageRotationPlain);
1199
- get rotation(): ImageRotationPlain;
1200
- set rotation(rotation: ImageRotationPlain);
1201
- getRotation(): ImageRotationPlain;
1202
- setRotation(rotation: ImageRotationPlain): void;
985
+ constructor(rotation: ImageRotationPlain);
986
+ get rotation(): ImageRotationPlain;
987
+ set rotation(rotation: ImageRotationPlain);
988
+ getRotation(): ImageRotationPlain;
989
+ setRotation(rotation: ImageRotationPlain): void;
1203
990
  }
1204
-
991
+ export type LocationPlain = { x: number; y: number; };
1205
992
  export class Location implements Required<LocationPlain> {
1206
- constructor(location: LocationPlain);
1207
- constructor(x: number, y: number);
1208
- get x(): number;
1209
- set x(x: number);
1210
- get y(): number;
1211
- set y(y: number);
1212
- getX(): number;
1213
- getY(): number;
1214
- setX(x: number): void;
1215
- setY(y: number): void;
993
+ constructor(location: LocationPlain);
994
+ constructor(x: number, y: number);
995
+ get x(): number;
996
+ set x(x: number);
997
+ getX(): number;
998
+ setX(x: number): void;
999
+ get y(): number;
1000
+ set y(y: number);
1001
+ getY(): number;
1002
+ setY(y: number): void;
1216
1003
  }
1217
-
1004
+ export type LogHandlerPlain = CustomLogHandlerPlain | FileLogHandlerPlain | ConsoleLogHandlerPlain;
1005
+ export type CustomLogHandlerPlain = {
1006
+ log(message: any): void;
1007
+ warn?(message: any): void;
1008
+ error?(message: any): void;
1009
+ fatal?(message: any): void;
1010
+ open?(): void;
1011
+ close?(): void;
1012
+ };
1013
+ export type FileLogHandlerPlain = { type: "file"; filename?: string; append?: boolean; };
1014
+ export type ConsoleLogHandlerPlain = { type: "console"; };
1218
1015
  export abstract class LogHandler implements CustomLogHandlerPlain {
1219
- constructor(verbose?: boolean);
1220
- get verbose(): boolean;
1221
- set verbose(verbose: boolean);
1222
- abstract close(): void;
1223
- getIsVerbose(): boolean;
1224
- log(message: string): void;
1225
- abstract onMessage(message: string): void;
1226
- abstract open(): void;
1227
- setIsVerbose(verbose: boolean): void;
1228
- }
1229
-
1230
- export class Logger {
1231
- constructor(options?: {handler?: LogHandlerPlain; label?: string; show?: boolean});
1232
- constructor(show?: boolean);
1233
- close(): void;
1234
- error(...messages: any[]): void;
1235
- extend(label?: string, color?: string): Logger;
1236
- extend(label?: string, color?: string[]): Logger;
1237
- fatal(...messages: any[]): void;
1238
- getLogHandler(): LogHandler;
1239
- log(...messages: any[]): void;
1240
- open(): void;
1241
- setLogHandler(handler: LogHandlerPlain): void;
1242
- verbose(...messages: any[]): void;
1243
- warn(...messages: any[]): void;
1016
+ constructor(verbose?: boolean);
1017
+ get verbose(): boolean;
1018
+ set verbose(verbose: boolean);
1019
+ getIsVerbose(): boolean;
1020
+ setIsVerbose(verbose: boolean): void;
1021
+ log(message: string): void;
1022
+ abstract onMessage(message: string): void;
1023
+ abstract open(): void;
1024
+ abstract close(): void;
1244
1025
  }
1245
-
1246
- export class MatchResult implements Required<MatchResultPlain> {
1247
- get asExpected(): boolean;
1248
- get windowId(): number;
1249
- getAsExpected(): boolean;
1250
- getWindowId(): number;
1251
- /** @deprecated */
1252
- setAsExpected(asExpected: boolean): void;
1253
- /** @deprecated */
1254
- setWindowId(windowId: number): void;
1026
+ export class FileLogHandler extends LogHandler implements FileLogHandlerPlain {
1027
+ constructor(verbose?: boolean, filename?: string, append?: boolean);
1028
+ readonly type: "file";
1029
+ readonly filename: string;
1030
+ readonly append: boolean;
1031
+ onMessage(): void;
1032
+ open(): void;
1033
+ close(): void;
1255
1034
  }
1256
-
1257
- export class NewTestError extends TestFailedError {
1258
- constructor(message: string, results?: TestResultsPlain);
1259
- constructor(results: TestResultsPlain);
1035
+ export class ConsoleLogHandler extends LogHandler implements ConsoleLogHandlerPlain {
1036
+ readonly type: "console";
1037
+ onMessage(): void;
1038
+ open(): void;
1039
+ close(): void;
1260
1040
  }
1261
-
1262
1041
  export class NullLogHandler extends LogHandler {
1263
- close(): void;
1264
- onMessage(): void;
1265
- open(): void;
1042
+ onMessage(): void;
1043
+ open(): void;
1044
+ close(): void;
1266
1045
  }
1267
-
1046
+ export type OCRSettings<TPattern extends string = string> = { patterns: Array<TPattern>; ignoreCase?: boolean; firstOnly?: boolean; language?: string; };
1047
+ export type PropertyDataPlain = { name: string; value: string; };
1268
1048
  export class PropertyData implements Required<PropertyDataPlain> {
1269
- constructor(property: PropertyDataPlain);
1270
- constructor(name: string, value: string);
1271
- get name(): string;
1272
- set name(name: string);
1273
- get value(): string;
1274
- set value(value: string);
1275
- getName(): string;
1276
- getValue(): string;
1277
- setName(name: string): void;
1278
- setValue(value: string): void;
1049
+ constructor(property: PropertyDataPlain);
1050
+ constructor(name: string, value: string);
1051
+ get name(): string;
1052
+ set name(name: string);
1053
+ getName(): string;
1054
+ setName(name: string): void;
1055
+ get value(): string;
1056
+ set value(value: string);
1057
+ getValue(): string;
1058
+ setValue(value: string): void;
1279
1059
  }
1280
-
1060
+ export type ProxySettingsPlain = { url: string; username?: string; password?: string; isHttpOnly?: boolean; };
1281
1061
  export class ProxySettings implements Required<ProxySettingsPlain> {
1282
- constructor(proxy: ProxySettingsPlain);
1283
- constructor(url: string, username?: string, password?: string, isHttpOnly?: boolean);
1284
- get isHttpOnly(): boolean;
1285
- get password(): string;
1286
- get url(): string;
1287
- get username(): string;
1288
- getIsHttpOnly(): boolean;
1289
- getPassword(): string;
1290
- getUri(): string;
1291
- getUrl(): string;
1292
- getUsername(): string;
1062
+ constructor(proxy: ProxySettingsPlain);
1063
+ constructor(url: string, username?: string, password?: string, isHttpOnly?: boolean);
1064
+ get url(): string;
1065
+ getUri(): string;
1066
+ getUrl(): string;
1067
+ get username(): string;
1068
+ getUsername(): string;
1069
+ get password(): string;
1070
+ getPassword(): string;
1071
+ get isHttpOnly(): boolean;
1072
+ getIsHttpOnly(): boolean;
1293
1073
  }
1294
-
1074
+ export type RectangleSizePlain = { width: number; height: number; };
1295
1075
  export class RectangleSize implements Required<RectangleSizePlain> {
1296
- constructor(size: RectangleSizePlain);
1297
- constructor(width: number, height: number);
1298
- get height(): number;
1299
- set height(height: number);
1300
- get width(): number;
1301
- set width(width: number);
1302
- getHeight(): number;
1303
- getWidth(): number;
1304
- setHeight(height: number): void;
1305
- setWidth(width: number): void;
1076
+ constructor(size: RectangleSizePlain);
1077
+ constructor(width: number, height: number);
1078
+ get width(): number;
1079
+ set width(width: number);
1080
+ getWidth(): number;
1081
+ setWidth(width: number): void;
1082
+ get height(): number;
1083
+ set height(height: number);
1084
+ getHeight(): number;
1085
+ setHeight(height: number): void;
1306
1086
  }
1307
-
1087
+ export type RegionPlain = LocationPlain & RectangleSizePlain;
1088
+ export type LegacyRegionPlain = { left: number; top: number; width: number; height: number; };
1308
1089
  export class Region implements Required<RegionPlain> {
1309
- constructor(region: RegionPlain);
1310
- constructor(location: LocationPlain, size: RectangleSizePlain);
1311
- constructor(x: number, y: number, width: number, height: number);
1312
- get height(): number;
1313
- set height(height: number);
1314
- get left(): number;
1315
- set left(left: number);
1316
- get top(): number;
1317
- set top(top: number);
1318
- get width(): number;
1319
- set width(width: number);
1320
- get x(): number;
1321
- set x(x: number);
1322
- get y(): number;
1323
- set y(y: number);
1324
- getHeight(): number;
1325
- getLeft(): number;
1326
- getTop(): number;
1327
- getWidth(): number;
1328
- getX(): number;
1329
- getY(): number;
1330
- setHeight(height: number): void;
1331
- setLeft(left: number): void;
1332
- setTop(top: number): void;
1333
- setWidth(width: number): void;
1334
- setX(x: number): void;
1335
- setY(y: number): void;
1090
+ constructor(region: RegionPlain);
1091
+ constructor(location: LocationPlain, size: RectangleSizePlain);
1092
+ constructor(x: number, y: number, width: number, height: number);
1093
+ get x(): number;
1094
+ set x(x: number);
1095
+ get left(): number;
1096
+ set left(left: number);
1097
+ getX(): number;
1098
+ setX(x: number): void;
1099
+ getLeft(): number;
1100
+ setLeft(left: number): void;
1101
+ get y(): number;
1102
+ set y(y: number);
1103
+ get top(): number;
1104
+ set top(top: number);
1105
+ getY(): number;
1106
+ setY(y: number): void;
1107
+ getTop(): number;
1108
+ setTop(top: number): void;
1109
+ get width(): number;
1110
+ set width(width: number);
1111
+ getWidth(): number;
1112
+ setWidth(width: number): void;
1113
+ get height(): number;
1114
+ set height(height: number);
1115
+ getHeight(): number;
1116
+ setHeight(height: number): void;
1336
1117
  }
1337
-
1338
- /**
1339
- * @undocumented
1340
- * @deprecated
1341
- */
1342
- export class RemoteSessionEventHandler extends SessionEventHandler {
1343
- constructor(options: {accessKey?: string; serverUrl: string; timeout?: number});
1344
- constructor(serverUrl: string, accessKey?: string, timeout?: number);
1345
- get accessKey(): string;
1346
- set accessKey(accessKey: string);
1347
- get serverUrl(): string;
1348
- set serverUrl(serverUrl: string);
1349
- get timeout(): number;
1350
- set timeout(timeout: number);
1351
- getAccessKey(): string;
1352
- getServerUrl(): string;
1353
- getTimeout(): number;
1354
- initEnded(): void;
1355
- initStarted(): void;
1356
- setAccessKey(accessKey: string): void;
1357
- setServerUrl(serverUrl: string): void;
1358
- setSizeEnded(): void;
1359
- setSizeWillStart(): void;
1360
- setTimeout(timeout: number): void;
1361
- testEnded(): void;
1362
- testStarted(): void;
1363
- validationEnded(): void;
1364
- validationWillStart(): void;
1365
- }
1366
-
1367
- /** @deprecated */
1118
+ export type DesktopBrowserInfo = { name?: BrowserTypePlain; width: number; height: number; };
1119
+ export type ChromeEmulationInfo = { chromeEmulationInfo: { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }; };
1120
+ export type IOSDeviceInfo = { iosDeviceInfo: { deviceName: IosDeviceNamePlain; iosVersion?: IosVersionPlain; screenOrientation?: ScreenOrientationPlain; }; };
1121
+ export type RunnerOptionsPlain = { testConcurrency?: number; };
1368
1122
  export class RunnerOptionsFluent {
1369
- constructor();
1370
- testConcurrency(concurrency: number): this;
1123
+ testConcurrency(concurrency: number): RunnerOptionsFluent;
1371
1124
  }
1372
-
1373
- /** @deprecated */
1374
- export abstract class SessionEventHandler {
1375
- constructor();
1376
- abstract initEnded(): any;
1377
- abstract initStarted(): any;
1378
- abstract setSizeEnded(): any;
1379
- abstract setSizeWillStart(viewportSize: RectangleSize): any;
1380
- abstract testEnded(sessionId: string, testResults: TestResults): any;
1381
- abstract testStarted(sessionId: string): any;
1382
- abstract validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): any;
1383
- abstract validationWillStart(sessionId: string, validationInfo: ValidationInfo): any;
1125
+ export function RunnerOptions(): RunnerOptionsFluent;
1126
+ export type VisualLocatorSettings<TLocator extends string = string> = { locatorNames: Array<TLocator>; firstOnly: boolean; };
1127
+ export type ApiUrlsPlain = {
1128
+ readonly baselineImage?: string;
1129
+ readonly currentImage?: string;
1130
+ readonly checkpointImage?: string;
1131
+ readonly checkpointImageThumbnail?: string;
1132
+ readonly diffImage?: string;
1133
+ };
1134
+ export class ApiUrls implements Required<ApiUrlsPlain> {
1135
+ get baselineImage(): string;
1136
+ getBaselineImage(): string;
1137
+ setBaselineImage(setBaselineImage: string): void;
1138
+ get currentImage(): string;
1139
+ getCurrentImage(): string;
1140
+ setCurrentImage(currentImage: string): void;
1141
+ get checkpointImage(): string;
1142
+ getCheckpointImage(): string;
1143
+ setCheckpointImage(checkpointImage: string): void;
1144
+ get checkpointImageThumbnail(): string;
1145
+ getCheckpointImageThumbnail(): string;
1146
+ setCheckpointImageThumbnail(checkpointImageThumbnail: string): void;
1147
+ get diffImage(): string;
1148
+ getDiffImage(): string;
1149
+ setDiffImage(diffImage: string): void;
1384
1150
  }
1385
-
1386
- /** @deprecated */
1387
- export class SessionEventHandlers extends SessionEventHandler {
1388
- addEventHandler(handler: SessionEventHandler): void;
1389
- clearEventHandlers(): void;
1390
- initEnded(): void;
1391
- initStarted(): void;
1392
- removeEventHandler(handler: SessionEventHandler): void;
1393
- setSizeEnded(): void;
1394
- setSizeWillStart(viewportSize: RectangleSize): void;
1395
- testEnded(sessionId: string, testResults: TestResults): void;
1396
- testStarted(sessionId: string): void;
1397
- validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): void;
1398
- validationWillStart(sessionId: string, validationInfo: ValidationInfo): void;
1151
+ export type AppUrlsPlain = { readonly step?: string; readonly stepEditor?: string; };
1152
+ export class AppUrls implements Required<AppUrlsPlain> {
1153
+ get step(): string;
1154
+ getStep(): string;
1155
+ setStep(step: string): void;
1156
+ get stepEditor(): string;
1157
+ getStepEditor(): string;
1158
+ setStepEditor(stepEditor: string): void;
1159
+ }
1160
+ export type MatchResultPlain = { readonly asExpected?: boolean; readonly windowId?: number; };
1161
+ export class MatchResult implements Required<MatchResultPlain> {
1162
+ get asExpected(): boolean;
1163
+ getAsExpected(): boolean;
1164
+ setAsExpected(asExpected: boolean): void;
1165
+ get windowId(): number;
1166
+ getWindowId(): number;
1167
+ setWindowId(windowId: number): void;
1399
1168
  }
1400
-
1169
+ export type SessionUrlsPlain = { readonly batch?: string; readonly session?: string; };
1401
1170
  export class SessionUrls implements Required<SessionUrlsPlain> {
1402
- get batch(): string;
1403
- get session(): string;
1404
- getBatch(): string;
1405
- getSession(): string;
1406
- /** @deprecated */
1407
- setBatch(batch: string): void;
1408
- /** @deprecated */
1409
- setSession(session: string): void;
1171
+ get batch(): string;
1172
+ getBatch(): string;
1173
+ setBatch(batch: string): void;
1174
+ get session(): string;
1175
+ getSession(): string;
1176
+ setSession(session: string): void;
1410
1177
  }
1411
-
1178
+ export type StepInfoPlain = {
1179
+ readonly name?: string;
1180
+ readonly isDifferent?: boolean;
1181
+ readonly hasBaselineImage?: boolean;
1182
+ readonly hasCurrentImage?: boolean;
1183
+ readonly appUrls?: AppUrlsPlain;
1184
+ readonly apiUrls?: ApiUrlsPlain;
1185
+ readonly renderId?: Array<string>;
1186
+ };
1412
1187
  export class StepInfo implements Required<StepInfoPlain> {
1413
- get apiUrls(): ApiUrlsPlain;
1414
- get appUrls(): AppUrlsPlain;
1415
- get hasBaselineImage(): boolean;
1416
- get hasCurrentImage(): boolean;
1417
- get isDifferent(): boolean;
1418
- get name(): string;
1419
- get renderId(): string[];
1420
- getApiUrls(): ApiUrls;
1421
- getAppUrls(): AppUrls;
1422
- getHasBaselineImage(): boolean;
1423
- getHasCurrentImage(): boolean;
1424
- getIsDifferent(): boolean;
1425
- getName(): string;
1426
- getRenderId(): string[];
1427
- /** @deprecated */
1428
- setApiUrls(apiUrls: ApiUrlsPlain): void;
1429
- /** @deprecated */
1430
- setAppUrls(appUrls: AppUrlsPlain): void;
1431
- /** @deprecated */
1432
- setHasBaselineImage(value: boolean): void;
1433
- /** @deprecated */
1434
- setHasCurrentImage(hasCurrentImage: boolean): void;
1435
- /** @deprecated */
1436
- setIsDifferent(value: boolean): void;
1437
- /** @deprecated */
1438
- setName(value: string): void;
1439
- /** @deprecated */
1440
- setRenderId(renderId: string[]): void;
1188
+ get name(): string;
1189
+ getName(): string;
1190
+ setName(value: string): void;
1191
+ get isDifferent(): boolean;
1192
+ getIsDifferent(): boolean;
1193
+ setIsDifferent(value: boolean): void;
1194
+ get hasBaselineImage(): boolean;
1195
+ getHasBaselineImage(): boolean;
1196
+ setHasBaselineImage(value: boolean): void;
1197
+ get hasCurrentImage(): boolean;
1198
+ getHasCurrentImage(): boolean;
1199
+ setHasCurrentImage(hasCurrentImage: boolean): void;
1200
+ get appUrls(): AppUrlsPlain;
1201
+ getAppUrls(): AppUrls;
1202
+ setAppUrls(appUrls: AppUrlsPlain): void;
1203
+ get apiUrls(): ApiUrlsPlain;
1204
+ getApiUrls(): ApiUrls;
1205
+ setApiUrls(apiUrls: ApiUrlsPlain): void;
1206
+ get renderId(): Array<string>;
1207
+ getRenderId(): Array<string>;
1208
+ setRenderId(renderId: Array<string>): void;
1441
1209
  }
1442
-
1443
- export class TestFailedError extends EyesError {
1444
- constructor(message: string, results?: TestResultsPlain);
1445
- constructor(results: TestResultsPlain);
1446
- get testResults(): TestResultsPlain;
1447
- getTestResults(): TestResults;
1210
+ export type TestAccessibilityStatus = { readonly status: AccessibilityStatusPlain; readonly level: AccessibilityLevelPlain; readonly version: AccessibilityGuidelinesVersionPlain; };
1211
+ export type TestResultsPlain = {
1212
+ readonly id?: string;
1213
+ readonly name?: string;
1214
+ readonly secretToken?: string;
1215
+ readonly status?: TestResultsStatusPlain;
1216
+ readonly appName?: string;
1217
+ readonly batchId?: string;
1218
+ readonly batchName?: string;
1219
+ readonly branchName?: string;
1220
+ readonly hostOS?: string;
1221
+ readonly hostApp?: string;
1222
+ readonly hostDisplaySize?: RectangleSizePlain;
1223
+ readonly accessibilityStatus?: TestAccessibilityStatus;
1224
+ readonly startedAt?: string | Date;
1225
+ readonly duration?: number;
1226
+ readonly isNew?: boolean;
1227
+ readonly isDifferent?: boolean;
1228
+ readonly isAborted?: boolean;
1229
+ readonly appUrls?: SessionUrlsPlain;
1230
+ readonly apiUrls?: SessionUrlsPlain;
1231
+ readonly stepsInfo?: Array<StepInfoPlain>;
1232
+ readonly steps?: number;
1233
+ readonly matches?: number;
1234
+ readonly mismatches?: number;
1235
+ readonly missing?: number;
1236
+ readonly exactMatches?: number;
1237
+ readonly strictMatches?: number;
1238
+ readonly contentMatches?: number;
1239
+ readonly layoutMatches?: number;
1240
+ readonly noneMatches?: number;
1241
+ readonly url?: string;
1242
+ };
1243
+ export class TestResults implements Required<TestResultsPlain> {
1244
+ get id(): string;
1245
+ getId(): string;
1246
+ setId(id: string): void;
1247
+ get name(): string;
1248
+ getName(): string;
1249
+ setName(name: string): void;
1250
+ get secretToken(): string;
1251
+ getSecretToken(): string;
1252
+ setSecretToken(secretToken: string): void;
1253
+ get status(): TestResultsStatusPlain;
1254
+ getStatus(): TestResultsStatus;
1255
+ setStatus(status: TestResultsStatus): void;
1256
+ get appName(): string;
1257
+ getAppName(): string;
1258
+ setAppName(appName: string): void;
1259
+ get batchName(): string;
1260
+ getBatchName(): string;
1261
+ setBatchName(batchName: string): void;
1262
+ get batchId(): string;
1263
+ getBatchId(): string;
1264
+ setBatchId(batchId: string): void;
1265
+ get branchName(): string;
1266
+ getBranchName(): string;
1267
+ setBranchName(branchName: string): void;
1268
+ get hostOS(): string;
1269
+ getHostOS(): string;
1270
+ setHostOS(hostOS: string): void;
1271
+ get hostApp(): string;
1272
+ getHostApp(): string;
1273
+ setHostApp(hostApp: string): void;
1274
+ get hostDisplaySize(): RectangleSizePlain;
1275
+ getHostDisplaySize(): RectangleSize;
1276
+ setHostDisplaySize(hostDisplaySize: RectangleSizePlain): void;
1277
+ get accessibilityStatus(): TestAccessibilityStatus;
1278
+ getAccessibilityStatus(): TestAccessibilityStatus;
1279
+ setAccessibilityStatus(accessibilityStatus: TestAccessibilityStatus): void;
1280
+ get startedAt(): string | Date;
1281
+ getStartedAt(): Date;
1282
+ setStartedAt(startedAt: string | Date): void;
1283
+ get duration(): number;
1284
+ getDuration(): number;
1285
+ setDuration(duration: number): void;
1286
+ get isNew(): boolean;
1287
+ getIsNew(): boolean;
1288
+ setIsNew(isNew: boolean): void;
1289
+ get isDifferent(): boolean;
1290
+ getIsDifferent(): boolean;
1291
+ setIsDifferent(isDifferent: boolean): void;
1292
+ get isAborted(): boolean;
1293
+ getIsAborted(): boolean;
1294
+ setIsAborted(isAborted: boolean): void;
1295
+ get appUrls(): SessionUrlsPlain;
1296
+ getAppUrls(): SessionUrls;
1297
+ setAppUrls(appUrls: SessionUrlsPlain): void;
1298
+ get apiUrls(): SessionUrlsPlain;
1299
+ getApiUrls(): SessionUrls;
1300
+ setApiUrls(apiUrls: SessionUrlsPlain): void;
1301
+ get stepsInfo(): Array<StepInfoPlain>;
1302
+ getStepsInfo(): Array<StepInfo>;
1303
+ setStepsInfo(stepInfo: Array<StepInfoPlain>): void;
1304
+ get steps(): number;
1305
+ getSteps(): number;
1306
+ setSteps(steps: number): void;
1307
+ get matches(): number;
1308
+ getMatches(): number;
1309
+ setMatches(matches: number): void;
1310
+ get mismatches(): number;
1311
+ getMismatches(): number;
1312
+ setMismatches(mismatches: number): void;
1313
+ get missing(): number;
1314
+ getMissing(): number;
1315
+ setMissing(missing: number): void;
1316
+ get exactMatches(): number;
1317
+ getExactMatches(): number;
1318
+ setExactMatches(exactMatches: number): void;
1319
+ get strictMatches(): number;
1320
+ getStrictMatches(): number;
1321
+ setStrictMatches(strictMatches: number): void;
1322
+ get contentMatches(): number;
1323
+ getContentMatches(): number;
1324
+ setContentMatches(contentMatches: number): void;
1325
+ get layoutMatches(): number;
1326
+ getLayoutMatches(): number;
1327
+ setLayoutMatches(layoutMatches: number): void;
1328
+ get noneMatches(): number;
1329
+ getNoneMatches(): number;
1330
+ setNoneMatches(noneMatches: number): void;
1331
+ get url(): string;
1332
+ getUrl(): string;
1333
+ setUrl(url: string): void;
1334
+ isPassed(): boolean;
1335
+ delete(): Promise<void>;
1336
+ deleteSession(): Promise<void>;
1448
1337
  }
1449
-
1338
+ export type TestResultContainerPlain = { readonly exception: Error; readonly testResults: TestResultsPlain; };
1450
1339
  export class TestResultContainer implements Required<TestResultContainerPlain> {
1451
- get exception(): EyesError;
1452
- get testResults(): TestResultsPlain;
1453
- getException(): EyesError;
1454
- getTestResults(): TestResults;
1340
+ get testResults(): TestResultsPlain;
1341
+ getTestResults(): TestResults;
1342
+ get exception(): Error;
1343
+ getException(): Error;
1455
1344
  }
1456
-
1457
- export class TestResults implements Required<TestResultsPlain> {
1458
- get accessibilityStatus(): TestAccessibilityStatus;
1459
- get apiUrls(): SessionUrlsPlain;
1460
- get appName(): string;
1461
- get appUrls(): SessionUrlsPlain;
1462
- get batchId(): string;
1463
- get batchName(): string;
1464
- get branchName(): string;
1465
- get contentMatches(): number;
1466
- get duration(): number;
1467
- get exactMatches(): number;
1468
- get hostApp(): string;
1469
- get hostDisplaySize(): RectangleSizePlain;
1470
- get hostOS(): string;
1471
- get id(): string;
1472
- get isAborted(): boolean;
1473
- get isDifferent(): boolean;
1474
- get isNew(): boolean;
1475
- get layoutMatches(): number;
1476
- get matches(): number;
1477
- get mismatches(): number;
1478
- get missing(): number;
1479
- get name(): string;
1480
- get noneMatches(): number;
1481
- get secretToken(): string;
1482
- get startedAt(): string | Date;
1483
- get status(): 'Passed' | 'Failed' | 'Unresolved';
1484
- get steps(): number;
1485
- get stepsInfo(): StepInfoPlain[];
1486
- get strictMatches(): number;
1487
- get url(): string;
1488
- delete(): Promise<void>;
1489
- /** @deprecated */
1490
- deleteSession(): Promise<void>;
1491
- getAccessibilityStatus(): TestAccessibilityStatus;
1492
- getApiUrls(): SessionUrls;
1493
- getAppName(): string;
1494
- getAppUrls(): SessionUrls;
1495
- getBatchId(): string;
1496
- getBatchName(): string;
1497
- getBranchName(): string;
1498
- getContentMatches(): number;
1499
- getDuration(): number;
1500
- getExactMatches(): number;
1501
- getHostApp(): string;
1502
- getHostDisplaySize(): RectangleSize;
1503
- getHostOS(): string;
1504
- getId(): string;
1505
- getIsAborted(): boolean;
1506
- getIsDifferent(): boolean;
1507
- getIsNew(): boolean;
1508
- getLayoutMatches(): number;
1509
- getMatches(): number;
1510
- getMismatches(): number;
1511
- getMissing(): number;
1512
- getName(): string;
1513
- getNoneMatches(): number;
1514
- getSecretToken(): string;
1515
- getStartedAt(): Date;
1516
- getStatus(): TestResultsStatus;
1517
- getSteps(): number;
1518
- getStepsInfo(): StepInfo[];
1519
- getStrictMatches(): number;
1520
- getUrl(): string;
1521
- isPassed(): boolean;
1522
- /** @deprecated */
1523
- setAccessibilityStatus(accessibilityStatus: TestAccessibilityStatus): void;
1524
- /** @deprecated */
1525
- setApiUrls(apiUrls: SessionUrlsPlain): void;
1526
- /** @deprecated */
1527
- setAppName(appName: string): void;
1528
- /** @deprecated */
1529
- setAppUrls(appUrls: SessionUrlsPlain): void;
1530
- /** @deprecated */
1531
- setBatchId(batchId: string): void;
1532
- /** @deprecated */
1533
- setBatchName(batchName: string): void;
1534
- /** @deprecated */
1535
- setBranchName(branchName: string): void;
1536
- /** @deprecated */
1537
- setContentMatches(contentMatches: number): void;
1538
- /** @deprecated */
1539
- setDuration(duration: number): void;
1540
- /** @deprecated */
1541
- setExactMatches(exactMatches: number): void;
1542
- /** @deprecated */
1543
- setHostApp(hostApp: string): void;
1544
- /** @deprecated */
1545
- setHostDisplaySize(hostDisplaySize: RectangleSizePlain): void;
1546
- /** @deprecated */
1547
- setHostOS(hostOS: string): void;
1548
- /** @deprecated */
1549
- setId(id: string): void;
1550
- /** @deprecated */
1551
- setIsAborted(isAborted: boolean): void;
1552
- /** @deprecated */
1553
- setIsDifferent(isDifferent: boolean): void;
1554
- /** @deprecated */
1555
- setIsNew(isNew: boolean): void;
1556
- /** @deprecated */
1557
- setLayoutMatches(layoutMatches: number): void;
1558
- /** @deprecated */
1559
- setMatches(matches: number): void;
1560
- /** @deprecated */
1561
- setMismatches(mismatches: number): void;
1562
- /** @deprecated */
1563
- setMissing(missing: number): void;
1564
- /** @deprecated */
1565
- setName(name: string): void;
1566
- /** @deprecated */
1567
- setNoneMatches(noneMatches: number): void;
1568
- /** @deprecated */
1569
- setSecretToken(secretToken: string): void;
1570
- /** @deprecated */
1571
- setStartedAt(startedAt: Date): void;
1572
- /** @deprecated */
1573
- setStartedAt(startedAt: string): void;
1574
- /** @deprecated */
1575
- setStatus(status: TestResultsStatus): void;
1576
- /** @deprecated */
1577
- setSteps(steps: number): void;
1578
- /** @deprecated */
1579
- setStepsInfo(stepInfo: StepInfoPlain[]): void;
1580
- /** @deprecated */
1581
- setStrictMatches(strictMatches: number): void;
1582
- /** @deprecated */
1583
- setUrl(url: string): void;
1584
- }
1585
-
1345
+ export type TestResultsSummaryPlain = Iterable<TestResultContainerPlain>;
1586
1346
  export class TestResultsSummary implements TestResultsSummaryPlain {
1587
- [Symbol.iterator](): Iterator<TestResultContainer>;
1588
- getAllResults(): TestResultContainer[];
1347
+ getAllResults(): Array<TestResultContainer>;
1348
+ [Symbol.iterator](): Iterator<TestResultContainer, any, undefined>;
1589
1349
  }
1590
-
1591
- /** @undocumented */
1592
- export class UnscaledFixedCutProvider extends CutProvider {
1593
- scale(): UnscaledFixedCutProvider;
1594
- }
1595
-
1596
- /** @undocumented */
1350
+ export type TextRegion = {
1351
+ x: number;
1352
+ y: number;
1353
+ width: number;
1354
+ height: number;
1355
+ text: string;
1356
+ };
1357
+ export type ValidationInfoPlain = { readonly validationId: number; readonly tag: string; };
1597
1358
  export class ValidationInfo implements Required<ValidationInfoPlain> {
1598
- get tag(): string;
1599
- get validationId(): number;
1600
- getTag(): string;
1601
- getValidationId(): number;
1359
+ get validationId(): number;
1360
+ getValidationId(): number;
1361
+ get tag(): string;
1362
+ getTag(): string;
1602
1363
  }
1603
-
1604
- /** @undocumented */
1364
+ export type ValidationResultPlain = { readonly asExpected: boolean; };
1605
1365
  export class ValidationResult implements Required<ValidationResultPlain> {
1606
- get asExpected(): boolean;
1607
- getAsExpected(): boolean;
1366
+ get asExpected(): boolean;
1367
+ getAsExpected(): boolean;
1368
+ }
1369
+ export type EyesSelector<TSelector = never> = string | TSelector | { selector: string | TSelector; type?: string; shadow?: EyesSelector<TSelector>; frame?: EyesSelector<TSelector>; };
1370
+ export class Logger {
1371
+ constructor(options?: { show?: boolean; label?: string; handler?: LogHandlerPlain; });
1372
+ constructor(show?: boolean);
1373
+ getLogHandler(): LogHandler;
1374
+ setLogHandler(handler: LogHandlerPlain): void;
1375
+ verbose(...messages: Array<any>): void;
1376
+ log(...messages: Array<any>): void;
1377
+ warn(...messages: Array<any>): void;
1378
+ error(...messages: Array<any>): void;
1379
+ fatal(...messages: Array<any>): void;
1380
+ open(): void;
1381
+ close(): void;
1382
+ extend(label?: string, color?: string | Array<string>): Logger;
1383
+ }
1384
+ export function closeBatch(spec: { closeBatches(options: { settings: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }; }): Promise<void>; }): (options: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }) => Promise<void>;
1385
+ export abstract class EyesRunner {
1386
+ getAllTestResults(throwErr?: boolean): Promise<TestResultsSummary>;
1387
+ }
1388
+ export class ClassicRunner extends EyesRunner {
1608
1389
  }
1609
-
1610
1390
  export class VisualGridRunner extends EyesRunner {
1611
- constructor(options?: RunnerOptionsPlain);
1612
- /** @deprecated */
1613
- constructor(options?: RunnerOptionsFluent);
1614
- /** @deprecated */
1615
- constructor(legacyConcurrency?: number);
1616
- /** @deprecated */
1617
- get legacyConcurrency(): number;
1618
- get testConcurrency(): number;
1619
- /** @deprecated */
1620
- getConcurrentSessions(): number;
1391
+ constructor(options?: RunnerOptionsPlain);
1392
+ constructor(options?: RunnerOptionsFluent);
1393
+ constructor(legacyConcurrency?: number);
1394
+ get testConcurrency(): number;
1395
+ get legacyConcurrency(): number;
1396
+ getConcurrentSessions(): number;
1397
+ }
1398
+ export abstract class SessionEventHandler {
1399
+ abstract initStarted(): any;
1400
+ abstract initEnded(): any;
1401
+ abstract setSizeWillStart(viewportSize: RectangleSize): any;
1402
+ abstract setSizeEnded(): any;
1403
+ abstract testStarted(sessionId: string): any;
1404
+ abstract testEnded(sessionId: string, testResults: TestResults): any;
1405
+ abstract validationWillStart(sessionId: string, validationInfo: ValidationInfo): any;
1406
+ abstract validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): any;
1407
+ }
1408
+ export class SessionEventHandlers extends SessionEventHandler {
1409
+ addEventHandler(handler: SessionEventHandler): void;
1410
+ removeEventHandler(handler: SessionEventHandler): void;
1411
+ clearEventHandlers(): void;
1412
+ initStarted(): void;
1413
+ initEnded(): void;
1414
+ setSizeWillStart(viewportSize: RectangleSize): void;
1415
+ setSizeEnded(): void;
1416
+ testStarted(sessionId: string): void;
1417
+ testEnded(sessionId: string, testResults: TestResults): void;
1418
+ validationWillStart(sessionId: string, validationInfo: ValidationInfo): void;
1419
+ validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): void;
1420
+ }
1421
+ export class RemoteSessionEventHandler extends SessionEventHandler {
1422
+ constructor(options: { serverUrl: string; accessKey?: string; timeout?: number; });
1423
+ constructor(serverUrl: string, accessKey?: string, timeout?: number);
1424
+ get serverUrl(): string;
1425
+ set serverUrl(serverUrl: string);
1426
+ getServerUrl(): string;
1427
+ setServerUrl(serverUrl: string): void;
1428
+ get accessKey(): string;
1429
+ set accessKey(accessKey: string);
1430
+ getAccessKey(): string;
1431
+ setAccessKey(accessKey: string): void;
1432
+ get timeout(): number;
1433
+ set timeout(timeout: number);
1434
+ setTimeout(timeout: number): void;
1435
+ getTimeout(): number;
1436
+ initStarted(): void;
1437
+ initEnded(): void;
1438
+ setSizeWillStart(): void;
1439
+ setSizeEnded(): void;
1440
+ testStarted(): void;
1441
+ testEnded(): void;
1442
+ validationWillStart(): void;
1443
+ validationEnded(): void;
1621
1444
  }
1622
-
1623
- export type AccessibilityGuidelinesVersionPlain = 'WCAG_2_0' | 'WCAG_2_1';
1624
-
1625
- export type AccessibilityLevelPlain = 'AA' | 'AAA';
1626
-
1627
- export type AccessibilityMatchSettingsPlain = {region: RegionPlain; type?: AccessibilityRegionTypePlain};
1628
-
1629
- export type AccessibilityRegionTypePlain =
1630
- | 'BoldText'
1631
- | 'GraphicalObject'
1632
- | 'IgnoreContrast'
1633
- | 'LargeText'
1634
- | 'RegularText';
1635
-
1636
- export type AccessibilitySettings = {
1637
- guidelinesVersion?: AccessibilityGuidelinesVersionPlain;
1638
- level?: AccessibilityLevelPlain;
1639
- };
1640
-
1641
- export type AccessibilityStatusPlain = 'Failed' | 'Passed';
1642
-
1643
- export type ApiUrlsPlain = {
1644
- readonly baselineImage?: string;
1645
- readonly checkpointImage?: string;
1646
- readonly checkpointImageThumbnail?: string;
1647
- readonly currentImage?: string;
1648
- readonly diffImage?: string;
1649
- };
1650
-
1651
- export type AppUrlsPlain = {readonly step?: string; readonly stepEditor?: string};
1652
-
1653
- export type BatchInfoPlain = {
1654
- id?: string;
1655
- name?: string;
1656
- notifyOnCompletion?: boolean;
1657
- properties?: PropertyDataPlain[];
1658
- sequenceName?: string;
1659
- startedAt?: Date | string;
1660
- };
1661
-
1662
- export type BrowserTypePlain =
1663
- | 'chrome'
1664
- | 'chrome-one-version-back'
1665
- | 'chrome-two-versions-back'
1666
- | 'edge'
1667
- | 'edgechromium'
1668
- | 'edgechromium-one-version-back'
1669
- | 'edgechromium-two-versions-back'
1670
- | 'edgelegacy'
1671
- | 'firefox'
1672
- | 'firefox-one-version-back'
1673
- | 'firefox-two-versions-back'
1674
- | 'ie10'
1675
- | 'ie'
1676
- | 'safari'
1677
- | 'safari-earlyaccess'
1678
- | 'safari-one-version-back'
1679
- | 'safari-two-versions-back';
1680
-
1681
- export type CheckSettingsPlain = {
1682
- name?: string;
1683
- region?: RegionPlain | Element | EyesSelector<Selector>;
1684
- frames?: (
1685
- | {frame: Element | EyesSelector<Selector> | string | number; scrollRootElement?: Element | EyesSelector<Selector>}
1686
- | Element
1687
- | EyesSelector<Selector>
1688
- | string
1689
- | number
1690
- )[];
1691
- scrollRootElement?: Element | EyesSelector<Selector>;
1692
- fully?: boolean;
1693
- matchLevel?: MatchLevelPlain;
1694
- useDom?: boolean;
1695
- sendDom?: boolean;
1696
- enablePatterns?: boolean;
1697
- ignoreDisplacements?: boolean;
1698
- ignoreCaret?: boolean;
1699
- ignoreRegions?: (RegionPlain | Element | EyesSelector<Selector>)[];
1700
- layoutRegions?: (RegionPlain | Element | EyesSelector<Selector>)[];
1701
- strictRegions?: (RegionPlain | Element | EyesSelector<Selector>)[];
1702
- contentRegions?: (RegionPlain | Element | EyesSelector<Selector>)[];
1703
- floatingRegions?: (
1704
- | {
1705
- region: RegionPlain | Element | EyesSelector<Selector>;
1706
- maxUpOffset?: number;
1707
- maxDownOffset?: number;
1708
- maxLeftOffset?: number;
1709
- maxRightOffset?: number;
1710
- }
1711
- | RegionPlain
1712
- | Element
1713
- | EyesSelector<Selector>
1714
- )[];
1715
- accessibilityRegions?: (
1716
- | {region: RegionPlain | Element | EyesSelector<Selector>; type?: AccessibilityRegionTypePlain}
1717
- | RegionPlain
1718
- | Element
1719
- | EyesSelector<Selector>
1720
- )[];
1721
- disableBrowserFetching?: boolean;
1722
- layoutBreakpoints?: boolean | number[];
1723
- visualGridOptions?: {[key: string]: any};
1724
- hooks?: {beforeCaptureScreenshot: string};
1725
- renderId?: string;
1726
- variationGroupId?: string;
1727
- timeout?: number;
1728
- waitBeforeCapture?: number;
1729
- };
1730
-
1731
- export type ChromeEmulationInfo = {
1732
- chromeEmulationInfo: {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain};
1733
- };
1734
-
1735
- export type ConfigurationPlain = {
1736
- /** @undocumented */ logs?: LogHandlerPlain /** @undocumented */;
1737
- debugScreenshots?: {save: boolean; path?: string; prefix?: string};
1738
- agentId?: string;
1739
- apiKey?: string;
1740
- serverUrl?: string;
1741
- proxy?: ProxySettingsPlain;
1742
- isDisabled?: boolean /** @undocumented */;
1743
- connectionTimeout?: number /** @undocumented */;
1744
- removeSession?: boolean /** @undocumented */;
1745
- remoteEvents?: {serverUrl: string; accessKey?: string; timeout?: number};
1746
- } & {
1747
- appName?: string;
1748
- testName?: string;
1749
- displayName?: string;
1750
- viewportSize?: RectangleSizePlain;
1751
- sessionType?: SessionTypePlain;
1752
- properties?: PropertyDataPlain[];
1753
- batch?: BatchInfoPlain;
1754
- defaultMatchSettings?: ImageMatchSettingsPlain;
1755
- hostApp?: string;
1756
- hostOS?: string;
1757
- hostAppInfo?: string;
1758
- hostOSInfo?: string;
1759
- deviceInfo?: string;
1760
- baselineEnvName?: string;
1761
- environmentName?: string;
1762
- branchName?: string;
1763
- parentBranchName?: string;
1764
- baselineBranchName?: string;
1765
- compareWithParentBranch?: boolean;
1766
- ignoreBaseline?: boolean;
1767
- saveFailedTests?: boolean;
1768
- saveNewTests?: boolean;
1769
- saveDiffs?: boolean /** @undocumented */;
1770
- dontCloseBatches?: boolean;
1771
- } & {sendDom?: boolean; matchTimeout?: number; forceFullPageScreenshot?: boolean} & {
1772
- waitBeforeScreenshots?: number;
1773
- stitchMode?: StitchModePlain;
1774
- hideScrollbars?: boolean;
1775
- hideCaret?: boolean;
1776
- stitchOverlap?: number;
1777
- scrollRootElement?: Element | EyesSelector<Selector>;
1778
- cut?: CutProviderPlain;
1779
- rotation?: ImageRotationPlain;
1780
- scaleRatio?: number;
1781
- waitBeforeCapture?: number;
1782
- } & {
1783
- /** @undocumented */ concurrentSessions?: number;
1784
- browsersInfo?: (DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo)[];
1785
- visualGridOptions?: Record<string, any>;
1786
- layoutBreakpoints?: boolean | number[];
1787
- disableBrowserFetching?: boolean;
1788
- waitBeforeCapture?: number;
1789
- };
1790
-
1791
- export type ConsoleLogHandlerPlain = {type: 'console'};
1792
-
1793
- export type CorsIframeHandlePlain = 'BLANK' | 'KEEP' | 'SNAPSHOT';
1794
-
1795
- export type CustomLogHandlerPlain = {
1796
- log(message: any): void;
1797
- warn?(message: any): void;
1798
- error?(message: any): void;
1799
- fatal?(message: any): void;
1800
- open?(): void;
1801
- close?(): void;
1802
- };
1803
-
1804
- export type CutProviderPlain =
1805
- | {top: number; right: number; bottom: number; left: number}
1806
- | {x: number; y: number; width: number; height: number};
1807
-
1808
- export type DesktopBrowserInfo = {height: number; name?: BrowserTypePlain; width: number};
1809
-
1810
- export type DeviceNamePlain =
1811
- | 'BlackBerry Z30'
1812
- | 'Blackberry PlayBook'
1813
- | 'Galaxy A5'
1814
- | 'Galaxy Note 10'
1815
- | 'Galaxy Note 10 Plus'
1816
- | 'Galaxy Note 2'
1817
- | 'Galaxy Note 3'
1818
- | 'Galaxy Note 4'
1819
- | 'Galaxy Note 8'
1820
- | 'Galaxy Note 9'
1821
- | 'Galaxy S10'
1822
- | 'Galaxy S10 Plus'
1823
- | 'Galaxy S20'
1824
- | 'Galaxy S3'
1825
- | 'Galaxy S5'
1826
- | 'Galaxy S8'
1827
- | 'Galaxy S8 Plus'
1828
- | 'Galaxy S9'
1829
- | 'Galaxy S9 Plus'
1830
- | 'Kindle Fire HDX'
1831
- | 'LG G6'
1832
- | 'LG Optimus L70'
1833
- | 'Laptop with HiDPI screen'
1834
- | 'Laptop with MDPI screen'
1835
- | 'Laptop with touch'
1836
- | 'Microsoft Lumia 550'
1837
- | 'Microsoft Lumia 950'
1838
- | 'Nexus 10'
1839
- | 'Nexus 4'
1840
- | 'Nexus 5'
1841
- | 'Nexus 5X'
1842
- | 'Nexus 6'
1843
- | 'Nexus 6P'
1844
- | 'Nexus 7'
1845
- | 'Nokia Lumia 520'
1846
- | 'Nokia N9'
1847
- | 'OnePlus 7T'
1848
- | 'OnePlus 7T Pro'
1849
- | 'Pixel 2'
1850
- | 'Pixel 2 XL'
1851
- | 'Pixel 3'
1852
- | 'Pixel 3 XL'
1853
- | 'Pixel 4'
1854
- | 'Pixel 4 XL'
1855
- | 'Pixel 5'
1856
- | 'iPad'
1857
- | 'iPad 6th Gen'
1858
- | 'iPad 7th Gen'
1859
- | 'iPad Air 2'
1860
- | 'iPad Mini'
1861
- | 'iPad Pro'
1862
- | 'iPhone 11'
1863
- | 'iPhone 11 Pro'
1864
- | 'iPhone 11 Pro Max'
1865
- | 'iPhone 4'
1866
- | 'iPhone 5/SE'
1867
- | 'iPhone 6/7/8'
1868
- | 'iPhone 6/7/8 Plus'
1869
- | 'iPhone X'
1870
- | 'iPhone XR'
1871
- | 'iPhone XS'
1872
- | 'iPhone XS Max';
1873
-
1874
- export type Driver = import('selenium-webdriver').WebDriver;
1875
-
1876
- export type Element = import('selenium-webdriver').WebElement;
1877
-
1878
- /** @undocumented */
1879
- export type ExactMatchSettingsPlain = {
1880
- matchThreshold: number;
1881
- minDiffHeight: number;
1882
- minDiffIntensity: number;
1883
- minDiffWidth: number;
1884
- };
1885
-
1886
- export type EyesSelector<TSelector = never> =
1887
- | TSelector
1888
- | string
1889
- | {frame?: EyesSelector<TSelector>; selector: TSelector | string; shadow?: EyesSelector<TSelector>; type?: string};
1890
-
1891
- export type FailureReportPlain = 'IMMEDIATE' | 'ON_CLOSE';
1892
-
1893
- export type FileLogHandlerPlain = {type: 'file'; filename?: string; append?: boolean};
1894
-
1895
- /** @undocumented */
1896
- export type FloatingMatchSettingsPlain = {
1897
- maxDownOffset?: number;
1898
- maxLeftOffset?: number;
1899
- maxRightOffset?: number;
1900
- maxUpOffset?: number;
1901
- region: RegionPlain;
1902
- };
1903
-
1904
- export type IOSDeviceInfo = {
1905
- iosDeviceInfo: {
1906
- deviceName: IosDeviceNamePlain;
1907
- iosVersion?: IosVersionPlain;
1908
- screenOrientation?: ScreenOrientationPlain;
1909
- };
1910
- };
1911
-
1912
- /** @undocumented */
1913
- export type ImageMatchSettingsPlain = {
1914
- accessibilityRegions?: (RegionPlain | AccessibilityMatchSettingsPlain)[];
1915
- accessibilitySettings?: AccessibilitySettings;
1916
- contentRegions?: RegionPlain[];
1917
- enablePatterns?: boolean;
1918
- exact?: ExactMatchSettingsPlain;
1919
- floatingRegions?: (RegionPlain | FloatingMatchSettingsPlain)[];
1920
- ignoreCaret?: boolean;
1921
- ignoreDisplacements?: boolean;
1922
- ignoreRegions?: RegionPlain[];
1923
- layoutRegions?: RegionPlain[];
1924
- matchLevel?: MatchLevelPlain;
1925
- strictRegions?: RegionPlain[];
1926
- useDom?: boolean;
1927
- };
1928
-
1929
- export type ImageRotationPlain = -270 | -180 | -90 | 0 | 90 | 180 | 270;
1930
-
1931
- export type IosDeviceNamePlain =
1932
- | 'iPad (7th generation)'
1933
- | 'iPad (9th generation)'
1934
- | 'iPad Air (2nd generation)'
1935
- | 'iPad Pro (12.9-inch) (3rd generation)'
1936
- | 'iPhone 11'
1937
- | 'iPhone 11 Pro'
1938
- | 'iPhone 11 Pro Max'
1939
- | 'iPhone 12'
1940
- | 'iPhone 12 Pro'
1941
- | 'iPhone 12 Pro Max'
1942
- | 'iPhone 12 mini'
1943
- | 'iPhone 13'
1944
- | 'iPhone 13 Pro'
1945
- | 'iPhone 13 Pro Max'
1946
- | 'iPhone 7'
1947
- | 'iPhone 8'
1948
- | 'iPhone X'
1949
- | 'iPhone XR'
1950
- | 'iPhone Xs';
1951
-
1952
- export type IosVersionPlain = 'latest' | 'latest-1';
1953
-
1954
- /** @deprecated */
1955
- export type LegacyRegionPlain = {height: number; left: number; top: number; width: number};
1956
-
1957
- export type LocationPlain = {x: number; y: number};
1958
-
1959
- export type LogHandlerPlain = CustomLogHandlerPlain | FileLogHandlerPlain | ConsoleLogHandlerPlain;
1960
-
1961
- export type MatchLevelPlain = 'Content' | 'Exact' | 'Layout' | 'Layout2' | 'Layout1' | 'None' | 'Strict';
1962
-
1963
- export type MatchResultPlain = {readonly asExpected?: boolean; readonly windowId?: number};
1964
-
1965
- export type OCRRegion = {
1966
- target: RegionPlain | Element | EyesSelector<Selector>;
1967
- hint?: string;
1968
- minMatch?: number;
1969
- language?: string;
1970
- };
1971
-
1972
- export type OCRSettings<TPattern extends string = string> = {
1973
- firstOnly?: boolean;
1974
- ignoreCase?: boolean;
1975
- language?: string;
1976
- patterns: TPattern[];
1977
- };
1978
-
1979
- export type PropertyDataPlain = {name: string; value: string};
1980
-
1981
- export type ProxySettingsPlain = {isHttpOnly?: boolean; password?: string; url: string; username?: string};
1982
-
1983
- export type RectangleSizePlain = {height: number; width: number};
1984
-
1985
- export type RegionPlain = LocationPlain & RectangleSizePlain;
1986
-
1987
- export type RunnerOptionsPlain = {testConcurrency?: number};
1988
-
1989
- export type ScreenOrientationPlain = 'landscape' | 'portrait';
1990
-
1991
- export type Selector = import('selenium-webdriver').Locator | {using: string; value: string};
1992
-
1993
- export type SessionTypePlain = 'PROGRESSION' | 'SEQUENTIAL';
1994
-
1995
- export type SessionUrlsPlain = {readonly batch?: string; readonly session?: string};
1996
-
1997
- export type StepInfoPlain = {
1998
- readonly apiUrls?: ApiUrlsPlain;
1999
- readonly appUrls?: AppUrlsPlain;
2000
- readonly hasBaselineImage?: boolean;
2001
- readonly hasCurrentImage?: boolean;
2002
- readonly isDifferent?: boolean;
2003
- readonly name?: string;
2004
- readonly renderId?: string[];
2005
- };
2006
-
2007
- export type StitchModePlain = 'CSS' | 'Scroll';
2008
-
2009
- export type TestAccessibilityStatus = {
2010
- readonly level: AccessibilityLevelPlain;
2011
- readonly status: AccessibilityStatusPlain;
2012
- readonly version: AccessibilityGuidelinesVersionPlain;
2013
- };
2014
-
2015
- export type TestResultContainerPlain = {readonly exception: EyesError; readonly testResults: TestResultsPlain};
2016
-
2017
- export type TestResultsPlain = {
2018
- readonly accessibilityStatus?: TestAccessibilityStatus;
2019
- readonly apiUrls?: SessionUrlsPlain;
2020
- readonly appName?: string;
2021
- readonly appUrls?: SessionUrlsPlain;
2022
- readonly batchId?: string;
2023
- readonly batchName?: string;
2024
- readonly branchName?: string;
2025
- readonly contentMatches?: number;
2026
- readonly duration?: number;
2027
- readonly exactMatches?: number;
2028
- readonly hostApp?: string;
2029
- readonly hostDisplaySize?: RectangleSizePlain;
2030
- readonly hostOS?: string;
2031
- readonly id?: string;
2032
- readonly isAborted?: boolean;
2033
- readonly isDifferent?: boolean;
2034
- readonly isNew?: boolean;
2035
- readonly layoutMatches?: number;
2036
- readonly matches?: number;
2037
- readonly mismatches?: number;
2038
- readonly missing?: number;
2039
- readonly name?: string;
2040
- readonly noneMatches?: number;
2041
- readonly secretToken?: string;
2042
- readonly startedAt?: Date | string;
2043
- readonly status?: TestResultsStatusPlain;
2044
- readonly steps?: number;
2045
- readonly stepsInfo?: StepInfoPlain[];
2046
- readonly strictMatches?: number;
2047
- readonly url?: string;
2048
- };
2049
-
2050
- export type TestResultsStatusPlain = 'Failed' | 'Passed' | 'Unresolved';
2051
-
2052
- export type TestResultsSummaryPlain = Iterable<TestResultContainerPlain>;
2053
-
2054
- export type TextRegion = {height: number; text: string; width: number; x: number; y: number};
2055
-
2056
- /** @undocumented */
2057
- export type ValidationInfoPlain = {readonly tag: string; readonly validationId: number};
2058
-
2059
- /** @undocumented */
2060
- export type ValidationResultPlain = {readonly asExpected: boolean};
2061
-
2062
- export type VisualLocatorSettings<TLocator extends string = string> = {firstOnly: boolean; locatorNames: TLocator[]};
2063
-
2064
- export const Target: {
2065
- window(): CheckSettings;
2066
- region(region: RegionPlain): CheckSettings;
2067
- region(region: Element): CheckSettings;
2068
- region(region: EyesSelector<Selector>): CheckSettings;
2069
- region(region: LegacyRegionPlain): CheckSettings;
2070
- frame(context: {
2071
- frame: Element | EyesSelector<Selector> | string | number;
2072
- scrollRootElement?: Element | EyesSelector<Selector>;
2073
- }): CheckSettings;
2074
- frame(frame: Element, scrollRootElement?: Element): CheckSettings;
2075
- frame(frame: Element, scrollRootElement?: EyesSelector<Selector>): CheckSettings;
2076
- frame(frame: EyesSelector<Selector>, scrollRootElement?: Element): CheckSettings;
2077
- frame(frame: EyesSelector<Selector>, scrollRootElement?: EyesSelector<Selector>): CheckSettings;
2078
- frame(frame: string, scrollRootElement?: Element): CheckSettings;
2079
- frame(frame: string, scrollRootElement?: EyesSelector<Selector>): CheckSettings;
2080
- frame(frame: number, scrollRootElement?: Element): CheckSettings;
2081
- frame(frame: number, scrollRootElement?: EyesSelector<Selector>): CheckSettings;
2082
- shadow(selector: EyesSelector<Selector>): CheckSettings;
2083
- };
2084
-
2085
- /** @deprecated */
2086
- export function RunnerOptions(): RunnerOptionsFluent;
2087
-
2088
- export function closeBatch(spec: {
2089
- closeBatches(options: {
2090
- settings: {batchIds: string[]; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain};
2091
- }): Promise<void>;
2092
- }): {(options: {batchIds: string[]; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain}): Promise<void>};