@wdio/image-comparison-core 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (416) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/LICENSE +21 -0
  3. package/README.md +12 -0
  4. package/assets/ios/ipadair4th.ipadair5th-bottom.png +0 -0
  5. package/assets/ios/ipadair4th.ipadair5th-top.png +0 -0
  6. package/assets/ios/ipadmini6th-bottom.png +0 -0
  7. package/assets/ios/ipadmini6th-top.png +0 -0
  8. package/assets/ios/ipadpro11-bottom.png +0 -0
  9. package/assets/ios/ipadpro11-top.png +0 -0
  10. package/assets/ios/ipadpro129-bottom.png +0 -0
  11. package/assets/ios/ipadpro129-top.png +0 -0
  12. package/assets/ios/iphone11promax-bottom.png +0 -0
  13. package/assets/ios/iphone11promax-top.png +0 -0
  14. package/assets/ios/iphone12.iphone12pro-top.png +0 -0
  15. package/assets/ios/iphone12.iphone12pro.iphone13.iphone13pro.iphone14-bottom.png +0 -0
  16. package/assets/ios/iphone12mini-top.png +0 -0
  17. package/assets/ios/iphone12mini.iphone13mini-bottom.png +0 -0
  18. package/assets/ios/iphone12promax-top.png +0 -0
  19. package/assets/ios/iphone12promax.iphone13promax.iphone14plus-bottom.png +0 -0
  20. package/assets/ios/iphone13.iphone13pro.iphone14-top.png +0 -0
  21. package/assets/ios/iphone13mini-top.png +0 -0
  22. package/assets/ios/iphone13promax.iphone14plus-top.png +0 -0
  23. package/assets/ios/iphone14pro-bottom.png +0 -0
  24. package/assets/ios/iphone14pro-top.png +0 -0
  25. package/assets/ios/iphone14promax-bottom.png +0 -0
  26. package/assets/ios/iphone14promax-top.png +0 -0
  27. package/assets/ios/iphone15-bottom.png +0 -0
  28. package/assets/ios/iphone15-top.png +0 -0
  29. package/assets/ios/iphonex.iphonexs.iphone11pro-bottom.png +0 -0
  30. package/assets/ios/iphonex.iphonexs.iphone11pro-top.png +0 -0
  31. package/assets/ios/iphonexr.iphone11-bottom.png +0 -0
  32. package/assets/ios/iphonexr.iphone11-top.png +0 -0
  33. package/assets/ios/iphonexsmax-bottom.png +0 -0
  34. package/assets/ios/iphonexsmax-top.png +0 -0
  35. package/dist/base.d.ts +18 -0
  36. package/dist/base.d.ts.map +1 -0
  37. package/dist/base.interfaces.d.ts +200 -0
  38. package/dist/base.interfaces.d.ts.map +1 -0
  39. package/dist/base.interfaces.js +1 -0
  40. package/dist/base.js +58 -0
  41. package/dist/base.test.d.ts +2 -0
  42. package/dist/base.test.d.ts.map +1 -0
  43. package/dist/base.test.js +45 -0
  44. package/dist/clientSideScripts/checkMetaTag.d.ts +2 -0
  45. package/dist/clientSideScripts/checkMetaTag.d.ts.map +1 -0
  46. package/dist/clientSideScripts/checkMetaTag.js +9 -0
  47. package/dist/clientSideScripts/checkMetaTag.test.d.ts +2 -0
  48. package/dist/clientSideScripts/checkMetaTag.test.d.ts.map +1 -0
  49. package/dist/clientSideScripts/checkMetaTag.test.js +25 -0
  50. package/dist/clientSideScripts/customCss.interfaces.d.ts +8 -0
  51. package/dist/clientSideScripts/customCss.interfaces.d.ts.map +1 -0
  52. package/dist/clientSideScripts/customCss.interfaces.js +1 -0
  53. package/dist/clientSideScripts/drawTabbableOnCanvas.d.ts +8 -0
  54. package/dist/clientSideScripts/drawTabbableOnCanvas.d.ts.map +1 -0
  55. package/dist/clientSideScripts/drawTabbableOnCanvas.interfaces.d.ts +4 -0
  56. package/dist/clientSideScripts/drawTabbableOnCanvas.interfaces.d.ts.map +1 -0
  57. package/dist/clientSideScripts/drawTabbableOnCanvas.interfaces.js +1 -0
  58. package/dist/clientSideScripts/drawTabbableOnCanvas.js +275 -0
  59. package/dist/clientSideScripts/drawTabbableOnCanvas.test.d.ts +2 -0
  60. package/dist/clientSideScripts/drawTabbableOnCanvas.test.d.ts.map +1 -0
  61. package/dist/clientSideScripts/drawTabbableOnCanvas.test.js +251 -0
  62. package/dist/clientSideScripts/elementPosition.interfaces.d.ts +3 -0
  63. package/dist/clientSideScripts/elementPosition.interfaces.d.ts.map +1 -0
  64. package/dist/clientSideScripts/elementPosition.interfaces.js +1 -0
  65. package/dist/clientSideScripts/getBoundingClientRect.d.ts +6 -0
  66. package/dist/clientSideScripts/getBoundingClientRect.d.ts.map +1 -0
  67. package/dist/clientSideScripts/getBoundingClientRect.js +12 -0
  68. package/dist/clientSideScripts/getBoundingClientRect.test.d.ts +2 -0
  69. package/dist/clientSideScripts/getBoundingClientRect.test.d.ts.map +1 -0
  70. package/dist/clientSideScripts/getBoundingClientRect.test.js +28 -0
  71. package/dist/clientSideScripts/getDocumentScrollHeight.d.ts +5 -0
  72. package/dist/clientSideScripts/getDocumentScrollHeight.d.ts.map +1 -0
  73. package/dist/clientSideScripts/getDocumentScrollHeight.js +48 -0
  74. package/dist/clientSideScripts/getDocumentScrollHeight.test.d.ts +2 -0
  75. package/dist/clientSideScripts/getDocumentScrollHeight.test.d.ts.map +1 -0
  76. package/dist/clientSideScripts/getDocumentScrollHeight.test.js +30 -0
  77. package/dist/clientSideScripts/getElementPositionTopDom.d.ts +6 -0
  78. package/dist/clientSideScripts/getElementPositionTopDom.d.ts.map +1 -0
  79. package/dist/clientSideScripts/getElementPositionTopDom.js +11 -0
  80. package/dist/clientSideScripts/getElementPositionTopDom.test.d.ts +2 -0
  81. package/dist/clientSideScripts/getElementPositionTopDom.test.d.ts.map +1 -0
  82. package/dist/clientSideScripts/getElementPositionTopDom.test.js +11 -0
  83. package/dist/clientSideScripts/getElementPositionTopScreenNativeMobile.d.ts +14 -0
  84. package/dist/clientSideScripts/getElementPositionTopScreenNativeMobile.d.ts.map +1 -0
  85. package/dist/clientSideScripts/getElementPositionTopScreenNativeMobile.js +19 -0
  86. package/dist/clientSideScripts/getElementPositionTopScreenNativeMobile.test.d.ts +2 -0
  87. package/dist/clientSideScripts/getElementPositionTopScreenNativeMobile.test.d.ts.map +1 -0
  88. package/dist/clientSideScripts/getElementPositionTopScreenNativeMobile.test.js +52 -0
  89. package/dist/clientSideScripts/getMobileWebviewClickAndDimensions.d.ts +6 -0
  90. package/dist/clientSideScripts/getMobileWebviewClickAndDimensions.d.ts.map +1 -0
  91. package/dist/clientSideScripts/getMobileWebviewClickAndDimensions.js +17 -0
  92. package/dist/clientSideScripts/getMobileWebviewClickAndDimensions.test.d.ts +2 -0
  93. package/dist/clientSideScripts/getMobileWebviewClickAndDimensions.test.d.ts.map +1 -0
  94. package/dist/clientSideScripts/getMobileWebviewClickAndDimensions.test.js +47 -0
  95. package/dist/clientSideScripts/getScreenDimensions.d.ts +6 -0
  96. package/dist/clientSideScripts/getScreenDimensions.d.ts.map +1 -0
  97. package/dist/clientSideScripts/getScreenDimensions.js +104 -0
  98. package/dist/clientSideScripts/getScreenDimensions.test.d.ts +2 -0
  99. package/dist/clientSideScripts/getScreenDimensions.test.d.ts.map +1 -0
  100. package/dist/clientSideScripts/getScreenDimensions.test.js +161 -0
  101. package/dist/clientSideScripts/hideRemoveElements.d.ts +8 -0
  102. package/dist/clientSideScripts/hideRemoveElements.d.ts.map +1 -0
  103. package/dist/clientSideScripts/hideRemoveElements.js +60 -0
  104. package/dist/clientSideScripts/hideRemoveElements.test.d.ts +2 -0
  105. package/dist/clientSideScripts/hideRemoveElements.test.d.ts.map +1 -0
  106. package/dist/clientSideScripts/hideRemoveElements.test.js +199 -0
  107. package/dist/clientSideScripts/hideScrollbars.d.ts +9 -0
  108. package/dist/clientSideScripts/hideScrollbars.d.ts.map +1 -0
  109. package/dist/clientSideScripts/hideScrollbars.js +15 -0
  110. package/dist/clientSideScripts/hideScrollbars.test.d.ts +2 -0
  111. package/dist/clientSideScripts/hideScrollbars.test.d.ts.map +1 -0
  112. package/dist/clientSideScripts/hideScrollbars.test.js +12 -0
  113. package/dist/clientSideScripts/injectWebviewOverlay.d.ts +5 -0
  114. package/dist/clientSideScripts/injectWebviewOverlay.d.ts.map +1 -0
  115. package/dist/clientSideScripts/injectWebviewOverlay.js +35 -0
  116. package/dist/clientSideScripts/injectWebviewOverlay.test.d.ts +2 -0
  117. package/dist/clientSideScripts/injectWebviewOverlay.test.d.ts.map +1 -0
  118. package/dist/clientSideScripts/injectWebviewOverlay.test.js +74 -0
  119. package/dist/clientSideScripts/removeElementFromDom.d.ts +5 -0
  120. package/dist/clientSideScripts/removeElementFromDom.d.ts.map +1 -0
  121. package/dist/clientSideScripts/removeElementFromDom.js +9 -0
  122. package/dist/clientSideScripts/removeElementFromDom.test.d.ts +2 -0
  123. package/dist/clientSideScripts/removeElementFromDom.test.d.ts.map +1 -0
  124. package/dist/clientSideScripts/removeElementFromDom.test.js +43 -0
  125. package/dist/clientSideScripts/screenDimensions.interfaces.d.ts +96 -0
  126. package/dist/clientSideScripts/screenDimensions.interfaces.d.ts.map +1 -0
  127. package/dist/clientSideScripts/screenDimensions.interfaces.js +1 -0
  128. package/dist/clientSideScripts/scrollElementIntoView.d.ts +5 -0
  129. package/dist/clientSideScripts/scrollElementIntoView.d.ts.map +1 -0
  130. package/dist/clientSideScripts/scrollElementIntoView.js +31 -0
  131. package/dist/clientSideScripts/scrollElementIntoView.test.d.ts +2 -0
  132. package/dist/clientSideScripts/scrollElementIntoView.test.d.ts.map +1 -0
  133. package/dist/clientSideScripts/scrollElementIntoView.test.js +79 -0
  134. package/dist/clientSideScripts/scrollToPosition.d.ts +5 -0
  135. package/dist/clientSideScripts/scrollToPosition.d.ts.map +1 -0
  136. package/dist/clientSideScripts/scrollToPosition.js +25 -0
  137. package/dist/clientSideScripts/scrollToPosition.test.d.ts +2 -0
  138. package/dist/clientSideScripts/scrollToPosition.test.d.ts.map +1 -0
  139. package/dist/clientSideScripts/scrollToPosition.test.js +72 -0
  140. package/dist/clientSideScripts/setCustomCss.d.ts +6 -0
  141. package/dist/clientSideScripts/setCustomCss.d.ts.map +1 -0
  142. package/dist/clientSideScripts/setCustomCss.js +36 -0
  143. package/dist/clientSideScripts/setCustomCss.test.d.ts +2 -0
  144. package/dist/clientSideScripts/setCustomCss.test.d.ts.map +1 -0
  145. package/dist/clientSideScripts/setCustomCss.test.js +68 -0
  146. package/dist/clientSideScripts/statusAddressToolBarOffsets.interfaces.d.ts +11 -0
  147. package/dist/clientSideScripts/statusAddressToolBarOffsets.interfaces.d.ts.map +1 -0
  148. package/dist/clientSideScripts/statusAddressToolBarOffsets.interfaces.js +1 -0
  149. package/dist/clientSideScripts/toggleTextTransparency.d.ts +5 -0
  150. package/dist/clientSideScripts/toggleTextTransparency.d.ts.map +1 -0
  151. package/dist/clientSideScripts/toggleTextTransparency.js +16 -0
  152. package/dist/clientSideScripts/toggleTextTransparency.test.d.ts +2 -0
  153. package/dist/clientSideScripts/toggleTextTransparency.test.d.ts.map +1 -0
  154. package/dist/clientSideScripts/toggleTextTransparency.test.js +35 -0
  155. package/dist/clientSideScripts/waitForFonts.d.ts +8 -0
  156. package/dist/clientSideScripts/waitForFonts.d.ts.map +1 -0
  157. package/dist/clientSideScripts/waitForFonts.js +20 -0
  158. package/dist/clientSideScripts/waitForFonts.test.d.ts +2 -0
  159. package/dist/clientSideScripts/waitForFonts.test.d.ts.map +1 -0
  160. package/dist/clientSideScripts/waitForFonts.test.js +37 -0
  161. package/dist/commands/check.interfaces.d.ts +35 -0
  162. package/dist/commands/check.interfaces.d.ts.map +1 -0
  163. package/dist/commands/check.interfaces.js +1 -0
  164. package/dist/commands/checkAppElement.d.ts +7 -0
  165. package/dist/commands/checkAppElement.d.ts.map +1 -0
  166. package/dist/commands/checkAppElement.js +44 -0
  167. package/dist/commands/checkAppElement.test.d.ts +2 -0
  168. package/dist/commands/checkAppElement.test.d.ts.map +1 -0
  169. package/dist/commands/checkAppElement.test.js +241 -0
  170. package/dist/commands/checkAppScreen.d.ts +7 -0
  171. package/dist/commands/checkAppScreen.d.ts.map +1 -0
  172. package/dist/commands/checkAppScreen.js +73 -0
  173. package/dist/commands/checkAppScreen.test.d.ts +2 -0
  174. package/dist/commands/checkAppScreen.test.d.ts.map +1 -0
  175. package/dist/commands/checkAppScreen.test.js +295 -0
  176. package/dist/commands/checkElement.d.ts +7 -0
  177. package/dist/commands/checkElement.d.ts.map +1 -0
  178. package/dist/commands/checkElement.js +10 -0
  179. package/dist/commands/checkElement.test.d.ts +2 -0
  180. package/dist/commands/checkElement.test.d.ts.map +1 -0
  181. package/dist/commands/checkElement.test.js +66 -0
  182. package/dist/commands/checkFullPageScreen.d.ts +7 -0
  183. package/dist/commands/checkFullPageScreen.d.ts.map +1 -0
  184. package/dist/commands/checkFullPageScreen.js +56 -0
  185. package/dist/commands/checkFullPageScreen.test.d.ts +2 -0
  186. package/dist/commands/checkFullPageScreen.test.d.ts.map +1 -0
  187. package/dist/commands/checkFullPageScreen.test.js +259 -0
  188. package/dist/commands/checkScreen.d.ts +7 -0
  189. package/dist/commands/checkScreen.d.ts.map +1 -0
  190. package/dist/commands/checkScreen.js +10 -0
  191. package/dist/commands/checkScreen.test.d.ts +2 -0
  192. package/dist/commands/checkScreen.test.d.ts.map +1 -0
  193. package/dist/commands/checkScreen.test.js +62 -0
  194. package/dist/commands/checkTabbablePage.d.ts +7 -0
  195. package/dist/commands/checkTabbablePage.d.ts.map +1 -0
  196. package/dist/commands/checkTabbablePage.js +28 -0
  197. package/dist/commands/checkTabbablePage.test.d.ts +2 -0
  198. package/dist/commands/checkTabbablePage.test.d.ts.map +1 -0
  199. package/dist/commands/checkTabbablePage.test.js +200 -0
  200. package/dist/commands/checkWebElement.d.ts +7 -0
  201. package/dist/commands/checkWebElement.d.ts.map +1 -0
  202. package/dist/commands/checkWebElement.js +52 -0
  203. package/dist/commands/checkWebElement.test.d.ts +2 -0
  204. package/dist/commands/checkWebElement.test.d.ts.map +1 -0
  205. package/dist/commands/checkWebElement.test.js +278 -0
  206. package/dist/commands/checkWebScreen.d.ts +7 -0
  207. package/dist/commands/checkWebScreen.d.ts.map +1 -0
  208. package/dist/commands/checkWebScreen.js +50 -0
  209. package/dist/commands/checkWebScreen.test.d.ts +2 -0
  210. package/dist/commands/checkWebScreen.test.d.ts.map +1 -0
  211. package/dist/commands/checkWebScreen.test.js +227 -0
  212. package/dist/commands/element.interfaces.d.ts +27 -0
  213. package/dist/commands/element.interfaces.d.ts.map +1 -0
  214. package/dist/commands/element.interfaces.js +1 -0
  215. package/dist/commands/fullPage.interfaces.d.ts +38 -0
  216. package/dist/commands/fullPage.interfaces.d.ts.map +1 -0
  217. package/dist/commands/fullPage.interfaces.js +1 -0
  218. package/dist/commands/save.interfaces.d.ts +27 -0
  219. package/dist/commands/save.interfaces.d.ts.map +1 -0
  220. package/dist/commands/save.interfaces.js +1 -0
  221. package/dist/commands/saveAppElement.d.ts +7 -0
  222. package/dist/commands/saveAppElement.d.ts.map +1 -0
  223. package/dist/commands/saveAppElement.js +30 -0
  224. package/dist/commands/saveAppElement.test.d.ts +2 -0
  225. package/dist/commands/saveAppElement.test.d.ts.map +1 -0
  226. package/dist/commands/saveAppElement.test.js +199 -0
  227. package/dist/commands/saveAppScreen.d.ts +7 -0
  228. package/dist/commands/saveAppScreen.d.ts.map +1 -0
  229. package/dist/commands/saveAppScreen.js +43 -0
  230. package/dist/commands/saveAppScreen.test.d.ts +2 -0
  231. package/dist/commands/saveAppScreen.test.d.ts.map +1 -0
  232. package/dist/commands/saveAppScreen.test.js +221 -0
  233. package/dist/commands/saveElement.d.ts +7 -0
  234. package/dist/commands/saveElement.d.ts.map +1 -0
  235. package/dist/commands/saveElement.js +10 -0
  236. package/dist/commands/saveElement.test.d.ts +2 -0
  237. package/dist/commands/saveElement.test.d.ts.map +1 -0
  238. package/dist/commands/saveElement.test.js +62 -0
  239. package/dist/commands/saveFullPageScreen.d.ts +7 -0
  240. package/dist/commands/saveFullPageScreen.d.ts.map +1 -0
  241. package/dist/commands/saveFullPageScreen.js +60 -0
  242. package/dist/commands/saveFullPageScreen.test.d.ts +2 -0
  243. package/dist/commands/saveFullPageScreen.test.d.ts.map +1 -0
  244. package/dist/commands/saveFullPageScreen.test.js +293 -0
  245. package/dist/commands/saveScreen.d.ts +7 -0
  246. package/dist/commands/saveScreen.d.ts.map +1 -0
  247. package/dist/commands/saveScreen.js +10 -0
  248. package/dist/commands/saveScreen.test.d.ts +2 -0
  249. package/dist/commands/saveScreen.test.d.ts.map +1 -0
  250. package/dist/commands/saveScreen.test.js +47 -0
  251. package/dist/commands/saveTabbablePage.d.ts +7 -0
  252. package/dist/commands/saveTabbablePage.d.ts.map +1 -0
  253. package/dist/commands/saveTabbablePage.js +20 -0
  254. package/dist/commands/saveTabbablePage.test.d.ts +2 -0
  255. package/dist/commands/saveTabbablePage.test.d.ts.map +1 -0
  256. package/dist/commands/saveTabbablePage.test.js +74 -0
  257. package/dist/commands/saveWebElement.d.ts +7 -0
  258. package/dist/commands/saveWebElement.d.ts.map +1 -0
  259. package/dist/commands/saveWebElement.js +53 -0
  260. package/dist/commands/saveWebElement.test.d.ts +2 -0
  261. package/dist/commands/saveWebElement.test.d.ts.map +1 -0
  262. package/dist/commands/saveWebElement.test.js +253 -0
  263. package/dist/commands/saveWebScreen.d.ts +7 -0
  264. package/dist/commands/saveWebScreen.d.ts.map +1 -0
  265. package/dist/commands/saveWebScreen.js +48 -0
  266. package/dist/commands/saveWebScreen.test.d.ts +2 -0
  267. package/dist/commands/saveWebScreen.test.d.ts.map +1 -0
  268. package/dist/commands/saveWebScreen.test.js +222 -0
  269. package/dist/commands/screen.interfaces.d.ts +16 -0
  270. package/dist/commands/screen.interfaces.d.ts.map +1 -0
  271. package/dist/commands/screen.interfaces.js +1 -0
  272. package/dist/commands/tabbable.interfaces.d.ts +29 -0
  273. package/dist/commands/tabbable.interfaces.d.ts.map +1 -0
  274. package/dist/commands/tabbable.interfaces.js +1 -0
  275. package/dist/helpers/afterScreenshot.d.ts +7 -0
  276. package/dist/helpers/afterScreenshot.d.ts.map +1 -0
  277. package/dist/helpers/afterScreenshot.interfaces.d.ts +46 -0
  278. package/dist/helpers/afterScreenshot.interfaces.d.ts.map +1 -0
  279. package/dist/helpers/afterScreenshot.interfaces.js +1 -0
  280. package/dist/helpers/afterScreenshot.js +55 -0
  281. package/dist/helpers/afterScreenshot.test.d.ts +2 -0
  282. package/dist/helpers/afterScreenshot.test.d.ts.map +1 -0
  283. package/dist/helpers/afterScreenshot.test.js +241 -0
  284. package/dist/helpers/beforeScreenshot.d.ts +6 -0
  285. package/dist/helpers/beforeScreenshot.d.ts.map +1 -0
  286. package/dist/helpers/beforeScreenshot.interfaces.d.ts +15 -0
  287. package/dist/helpers/beforeScreenshot.interfaces.d.ts.map +1 -0
  288. package/dist/helpers/beforeScreenshot.interfaces.js +1 -0
  289. package/dist/helpers/beforeScreenshot.js +79 -0
  290. package/dist/helpers/beforeScreenshot.test.d.ts +2 -0
  291. package/dist/helpers/beforeScreenshot.test.d.ts.map +1 -0
  292. package/dist/helpers/beforeScreenshot.test.js +261 -0
  293. package/dist/helpers/compare.interfaces.d.ts +16 -0
  294. package/dist/helpers/compare.interfaces.d.ts.map +1 -0
  295. package/dist/helpers/compare.interfaces.js +1 -0
  296. package/dist/helpers/constants.d.ts +108 -0
  297. package/dist/helpers/constants.d.ts.map +1 -0
  298. package/dist/helpers/constants.interfaces.d.ts +30 -0
  299. package/dist/helpers/constants.interfaces.d.ts.map +1 -0
  300. package/dist/helpers/constants.interfaces.js +11 -0
  301. package/dist/helpers/constants.js +436 -0
  302. package/dist/helpers/options.d.ts +64 -0
  303. package/dist/helpers/options.d.ts.map +1 -0
  304. package/dist/helpers/options.interfaces.d.ts +363 -0
  305. package/dist/helpers/options.interfaces.d.ts.map +1 -0
  306. package/dist/helpers/options.interfaces.js +1 -0
  307. package/dist/helpers/options.js +184 -0
  308. package/dist/helpers/options.test.d.ts +2 -0
  309. package/dist/helpers/options.test.d.ts.map +1 -0
  310. package/dist/helpers/options.test.js +428 -0
  311. package/dist/helpers/utils.d.ts +134 -0
  312. package/dist/helpers/utils.d.ts.map +1 -0
  313. package/dist/helpers/utils.interfaces.d.ts +254 -0
  314. package/dist/helpers/utils.interfaces.d.ts.map +1 -0
  315. package/dist/helpers/utils.interfaces.js +1 -0
  316. package/dist/helpers/utils.js +566 -0
  317. package/dist/helpers/utils.test.d.ts +2 -0
  318. package/dist/helpers/utils.test.d.ts.map +1 -0
  319. package/dist/helpers/utils.test.js +900 -0
  320. package/dist/index.d.ts +26 -0
  321. package/dist/index.d.ts.map +1 -0
  322. package/dist/index.js +18 -0
  323. package/dist/methods/compareReport.interfaces.d.ts +109 -0
  324. package/dist/methods/compareReport.interfaces.d.ts.map +1 -0
  325. package/dist/methods/compareReport.interfaces.js +1 -0
  326. package/dist/methods/createCompareReport.d.ts +7 -0
  327. package/dist/methods/createCompareReport.d.ts.map +1 -0
  328. package/dist/methods/createCompareReport.js +61 -0
  329. package/dist/methods/createCompareReport.test.d.ts +2 -0
  330. package/dist/methods/createCompareReport.test.d.ts.map +1 -0
  331. package/dist/methods/createCompareReport.test.js +236 -0
  332. package/dist/methods/elementPosition.d.ts +18 -0
  333. package/dist/methods/elementPosition.d.ts.map +1 -0
  334. package/dist/methods/elementPosition.interfaces.d.ts +14 -0
  335. package/dist/methods/elementPosition.interfaces.d.ts.map +1 -0
  336. package/dist/methods/elementPosition.interfaces.js +1 -0
  337. package/dist/methods/elementPosition.js +34 -0
  338. package/dist/methods/images.d.ts +69 -0
  339. package/dist/methods/images.d.ts.map +1 -0
  340. package/dist/methods/images.executeImageCompare.test.d.ts +2 -0
  341. package/dist/methods/images.executeImageCompare.test.d.ts.map +1 -0
  342. package/dist/methods/images.executeImageCompare.test.js +770 -0
  343. package/dist/methods/images.interfaces.d.ts +214 -0
  344. package/dist/methods/images.interfaces.d.ts.map +1 -0
  345. package/dist/methods/images.interfaces.js +1 -0
  346. package/dist/methods/images.js +428 -0
  347. package/dist/methods/images.test.d.ts +2 -0
  348. package/dist/methods/images.test.d.ts.map +1 -0
  349. package/dist/methods/images.test.js +1465 -0
  350. package/dist/methods/instanceData.d.ts +6 -0
  351. package/dist/methods/instanceData.d.ts.map +1 -0
  352. package/dist/methods/instanceData.interfaces.d.ts +57 -0
  353. package/dist/methods/instanceData.interfaces.d.ts.map +1 -0
  354. package/dist/methods/instanceData.interfaces.js +1 -0
  355. package/dist/methods/instanceData.js +42 -0
  356. package/dist/methods/instanceData.test.d.ts +2 -0
  357. package/dist/methods/instanceData.test.d.ts.map +1 -0
  358. package/dist/methods/instanceData.test.js +224 -0
  359. package/dist/methods/processDiffPixels.d.ts +59 -0
  360. package/dist/methods/processDiffPixels.d.ts.map +1 -0
  361. package/dist/methods/processDiffPixels.js +242 -0
  362. package/dist/methods/processDiffPixels.test.d.ts +2 -0
  363. package/dist/methods/processDiffPixels.test.d.ts.map +1 -0
  364. package/dist/methods/processDiffPixels.test.js +122 -0
  365. package/dist/methods/rectangles.d.ts +51 -0
  366. package/dist/methods/rectangles.d.ts.map +1 -0
  367. package/dist/methods/rectangles.interfaces.d.ts +146 -0
  368. package/dist/methods/rectangles.interfaces.d.ts.map +1 -0
  369. package/dist/methods/rectangles.interfaces.js +1 -0
  370. package/dist/methods/rectangles.js +266 -0
  371. package/dist/methods/rectangles.test.d.ts +2 -0
  372. package/dist/methods/rectangles.test.d.ts.map +1 -0
  373. package/dist/methods/rectangles.test.js +853 -0
  374. package/dist/methods/screenshots.d.ts +37 -0
  375. package/dist/methods/screenshots.d.ts.map +1 -0
  376. package/dist/methods/screenshots.interfaces.d.ts +203 -0
  377. package/dist/methods/screenshots.interfaces.d.ts.map +1 -0
  378. package/dist/methods/screenshots.interfaces.js +1 -0
  379. package/dist/methods/screenshots.js +394 -0
  380. package/dist/methods/screenshots.test.d.ts +2 -0
  381. package/dist/methods/screenshots.test.d.ts.map +1 -0
  382. package/dist/methods/screenshots.test.js +656 -0
  383. package/dist/methods/takeElementScreenshots.d.ts +3 -0
  384. package/dist/methods/takeElementScreenshots.d.ts.map +1 -0
  385. package/dist/methods/takeElementScreenshots.js +104 -0
  386. package/dist/methods/takeElementScreenshots.test.d.ts +2 -0
  387. package/dist/methods/takeElementScreenshots.test.d.ts.map +1 -0
  388. package/dist/methods/takeElementScreenshots.test.js +314 -0
  389. package/dist/methods/takeFullPageScreenshots.d.ts +3 -0
  390. package/dist/methods/takeFullPageScreenshots.d.ts.map +1 -0
  391. package/dist/methods/takeFullPageScreenshots.js +56 -0
  392. package/dist/methods/takeFullPageScreenshots.test.d.ts +2 -0
  393. package/dist/methods/takeFullPageScreenshots.test.d.ts.map +1 -0
  394. package/dist/methods/takeFullPageScreenshots.test.js +72 -0
  395. package/dist/methods/takeWebScreenshots.d.ts +3 -0
  396. package/dist/methods/takeWebScreenshots.d.ts.map +1 -0
  397. package/dist/methods/takeWebScreenshots.js +41 -0
  398. package/dist/methods/takeWebScreenshots.test.d.ts +2 -0
  399. package/dist/methods/takeWebScreenshots.test.d.ts.map +1 -0
  400. package/dist/methods/takeWebScreenshots.test.js +149 -0
  401. package/dist/mocks/image.d.ts +4 -0
  402. package/dist/mocks/image.d.ts.map +1 -0
  403. package/dist/mocks/image.js +3 -0
  404. package/dist/mocks/mocks.d.ts +745 -0
  405. package/dist/mocks/mocks.d.ts.map +1 -0
  406. package/dist/mocks/mocks.js +392 -0
  407. package/dist/resemble/compare.interfaces.d.ts +136 -0
  408. package/dist/resemble/compare.interfaces.d.ts.map +1 -0
  409. package/dist/resemble/compare.interfaces.js +1 -0
  410. package/dist/resemble/compareImages.d.ts +3 -0
  411. package/dist/resemble/compareImages.d.ts.map +1 -0
  412. package/dist/resemble/compareImages.js +21 -0
  413. package/dist/resemble/resemble.jimp.cjs +981 -0
  414. package/dist/resemble/resemble.jimp.d.cts +46 -0
  415. package/dist/resemble/resemble.jimp.d.cts.map +1 -0
  416. package/package.json +47 -0
@@ -0,0 +1,253 @@
1
+ import { describe, it, expect, vi, afterEach } from 'vitest';
2
+ import saveWebElement from './saveWebElement.js';
3
+ import { takeElementScreenshot } from '../methods/takeElementScreenshots.js';
4
+ import afterScreenshot from '../helpers/afterScreenshot.js';
5
+ import { canUseBidiScreenshot } from '../helpers/utils.js';
6
+ import { createBeforeScreenshotOptions, buildAfterScreenshotOptions } from '../helpers/options.js';
7
+ import { createBaseOptions, createMethodOptions, createBeforeScreenshotMock } from '../mocks/mocks.js';
8
+ vi.mock('../methods/takeElementScreenshots.js', () => ({
9
+ takeElementScreenshot: vi.fn().mockResolvedValue({
10
+ base64Image: 'element-screenshot-data',
11
+ isWebDriverElementScreenshot: false
12
+ })
13
+ }));
14
+ vi.mock('../helpers/beforeScreenshot.js', () => ({
15
+ default: vi.fn().mockResolvedValue({
16
+ browserName: 'chrome',
17
+ browserVersion: '120.0.0',
18
+ deviceName: 'desktop',
19
+ dimensions: {
20
+ window: {
21
+ devicePixelRatio: 2,
22
+ innerHeight: 900,
23
+ isEmulated: false,
24
+ isLandscape: false,
25
+ outerHeight: 1000,
26
+ outerWidth: 1200,
27
+ screenHeight: 1080,
28
+ screenWidth: 1920,
29
+ },
30
+ },
31
+ initialDevicePixelRatio: 2,
32
+ isAndroid: false,
33
+ isAndroidChromeDriverScreenshot: false,
34
+ isAndroidNativeWebScreenshot: false,
35
+ isIOS: false,
36
+ isMobile: false,
37
+ isTestInBrowser: true,
38
+ isTestInMobileBrowser: false,
39
+ addressBarShadowPadding: 0,
40
+ toolBarShadowPadding: 0,
41
+ appName: '',
42
+ logName: 'chrome',
43
+ name: 'chrome',
44
+ platformName: 'desktop',
45
+ platformVersion: '120.0.0',
46
+ })
47
+ }));
48
+ vi.mock('../helpers/afterScreenshot.js', () => ({
49
+ default: vi.fn().mockResolvedValue({
50
+ devicePixelRatio: 2,
51
+ fileName: 'test-element.png'
52
+ })
53
+ }));
54
+ vi.mock('../helpers/utils.js', () => ({
55
+ canUseBidiScreenshot: vi.fn().mockReturnValue(false),
56
+ getMethodOrWicOption: vi.fn().mockImplementation((method, wic, option) => method[option] ?? wic[option])
57
+ }));
58
+ vi.mock('../helpers/options.js', async (importOriginal) => {
59
+ const actual = await importOriginal();
60
+ return {
61
+ ...actual,
62
+ createBeforeScreenshotOptions: vi.fn().mockReturnValue({
63
+ instanceData: { test: 'data' },
64
+ addressBarShadowPadding: 6,
65
+ toolBarShadowPadding: 6,
66
+ disableBlinkingCursor: false,
67
+ disableCSSAnimation: false,
68
+ enableLayoutTesting: false,
69
+ hideElements: [],
70
+ noScrollBars: true,
71
+ removeElements: [],
72
+ waitForFontsLoaded: false,
73
+ }),
74
+ buildAfterScreenshotOptions: vi.fn().mockReturnValue({
75
+ actualFolder: '/test/actual',
76
+ base64Image: 'element-screenshot-data',
77
+ disableBlinkingCursor: false,
78
+ disableCSSAnimation: false,
79
+ enableLayoutTesting: false,
80
+ filePath: {
81
+ browserName: 'chrome',
82
+ deviceName: 'desktop',
83
+ isMobile: false,
84
+ savePerInstance: false,
85
+ },
86
+ fileName: {
87
+ browserName: 'chrome',
88
+ browserVersion: '120.0.0',
89
+ deviceName: 'desktop',
90
+ devicePixelRatio: 2,
91
+ formatImageName: '{tag}-{browserName}-{width}x{height}',
92
+ isMobile: false,
93
+ isTestInBrowser: true,
94
+ logName: 'chrome',
95
+ name: 'chrome',
96
+ outerHeight: 1000,
97
+ outerWidth: 1200,
98
+ platformName: 'desktop',
99
+ platformVersion: '120.0.0',
100
+ screenHeight: 1080,
101
+ screenWidth: 1920,
102
+ tag: 'test-element'
103
+ },
104
+ hideElements: [],
105
+ hideScrollBars: true,
106
+ isLandscape: false,
107
+ isNativeContext: false,
108
+ platformName: 'desktop',
109
+ removeElements: [],
110
+ })
111
+ };
112
+ });
113
+ describe('saveWebElement', () => {
114
+ const takeElementScreenshotSpy = vi.mocked(takeElementScreenshot);
115
+ const afterScreenshotSpy = vi.mocked(afterScreenshot);
116
+ const canUseBidiScreenshotSpy = vi.mocked(canUseBidiScreenshot);
117
+ const createBeforeScreenshotOptionsSpy = vi.mocked(createBeforeScreenshotOptions);
118
+ const buildAfterScreenshotOptionsSpy = vi.mocked(buildAfterScreenshotOptions);
119
+ const baseOptions = {
120
+ ...createBaseOptions('element'),
121
+ element: { elementId: 'test-element' },
122
+ browserInstance: {
123
+ isAndroid: false,
124
+ isMobile: false
125
+ }
126
+ };
127
+ const createTestOptions = (methodOptions = {}) => ({
128
+ ...baseOptions,
129
+ saveElementOptions: {
130
+ ...baseOptions.saveElementOptions,
131
+ method: createMethodOptions(methodOptions)
132
+ }
133
+ });
134
+ afterEach(() => {
135
+ vi.clearAllMocks();
136
+ });
137
+ it('should call takeElementScreenshot with correct options when BiDi is available', async () => {
138
+ canUseBidiScreenshotSpy.mockReturnValueOnce(true);
139
+ const result = await saveWebElement(baseOptions);
140
+ expect(result).toMatchSnapshot();
141
+ expect(createBeforeScreenshotOptionsSpy.mock.calls[0]).toMatchSnapshot();
142
+ expect(takeElementScreenshotSpy.mock.calls[0]).toMatchSnapshot();
143
+ expect(buildAfterScreenshotOptionsSpy.mock.calls[0][0]).toMatchSnapshot();
144
+ expect(afterScreenshotSpy.mock.calls[0][1]).toMatchSnapshot();
145
+ });
146
+ it('should call takeElementScreenshot with BiDi disabled when not available', async () => {
147
+ canUseBidiScreenshotSpy.mockReturnValueOnce(false);
148
+ const result = await saveWebElement(baseOptions);
149
+ expect(result).toMatchSnapshot();
150
+ expect(takeElementScreenshotSpy.mock.calls[0]).toMatchSnapshot();
151
+ expect(buildAfterScreenshotOptionsSpy.mock.calls[0][0]).toMatchSnapshot();
152
+ expect(afterScreenshotSpy.mock.calls[0][1]).toMatchSnapshot();
153
+ });
154
+ it('should call takeElementScreenshot with BiDi disabled when mobile device', async () => {
155
+ canUseBidiScreenshotSpy.mockReturnValueOnce(true);
156
+ const beforeScreenshotMock = createBeforeScreenshotMock({ isMobile: true });
157
+ vi.mocked((await import('../helpers/beforeScreenshot.js')).default).mockResolvedValueOnce(beforeScreenshotMock);
158
+ const result = await saveWebElement(baseOptions);
159
+ expect(result).toMatchSnapshot();
160
+ expect(takeElementScreenshotSpy.mock.calls[0]).toMatchSnapshot();
161
+ expect(buildAfterScreenshotOptionsSpy.mock.calls[0][0]).toMatchSnapshot();
162
+ });
163
+ it('should call takeElementScreenshot with BiDi disabled when legacy method enabled', async () => {
164
+ canUseBidiScreenshotSpy.mockReturnValueOnce(true);
165
+ const options = createTestOptions({
166
+ enableLegacyScreenshotMethod: true
167
+ });
168
+ const result = await saveWebElement(options);
169
+ expect(result).toMatchSnapshot();
170
+ expect(takeElementScreenshotSpy.mock.calls[0]).toMatchSnapshot();
171
+ });
172
+ it('should pass autoElementScroll option correctly', async () => {
173
+ const options = createTestOptions({
174
+ wic: {
175
+ ...baseOptions.saveElementOptions.wic,
176
+ autoElementScroll: true
177
+ }
178
+ });
179
+ const result = await saveWebElement(options);
180
+ expect(result).toMatchSnapshot();
181
+ expect(takeElementScreenshotSpy.mock.calls[0]).toMatchSnapshot();
182
+ });
183
+ it('should pass resizeDimensions option correctly', async () => {
184
+ const customResizeDimensions = { top: 10, right: 15, bottom: 20, left: 25 };
185
+ const options = createTestOptions({
186
+ resizeDimensions: customResizeDimensions
187
+ });
188
+ const result = await saveWebElement(options);
189
+ expect(result).toMatchSnapshot();
190
+ expect(takeElementScreenshotSpy.mock.calls[0]).toMatchSnapshot();
191
+ });
192
+ it('should handle NaN dimension values correctly', async () => {
193
+ const nanDimensions = createBeforeScreenshotMock({
194
+ dimensions: {
195
+ window: {
196
+ devicePixelRatio: NaN,
197
+ innerHeight: NaN,
198
+ isEmulated: false,
199
+ isLandscape: false,
200
+ outerHeight: NaN,
201
+ outerWidth: NaN,
202
+ screenHeight: NaN,
203
+ screenWidth: NaN,
204
+ },
205
+ },
206
+ devicePixelRatio: NaN,
207
+ initialDevicePixelRatio: NaN
208
+ });
209
+ vi.mocked((await import('../helpers/beforeScreenshot.js')).default).mockResolvedValueOnce(nanDimensions);
210
+ buildAfterScreenshotOptionsSpy.mockReturnValueOnce({
211
+ actualFolder: '/test/actual',
212
+ base64Image: 'element-screenshot-data',
213
+ disableBlinkingCursor: false,
214
+ disableCSSAnimation: false,
215
+ enableLayoutTesting: false,
216
+ filePath: {
217
+ browserName: 'chrome',
218
+ deviceName: 'desktop',
219
+ isMobile: false,
220
+ savePerInstance: false,
221
+ },
222
+ fileName: {
223
+ browserName: 'chrome',
224
+ browserVersion: '120.0.0',
225
+ deviceName: 'desktop',
226
+ devicePixelRatio: NaN,
227
+ formatImageName: '{tag}-{browserName}-{width}x{height}',
228
+ isMobile: false,
229
+ isTestInBrowser: true,
230
+ logName: 'chrome',
231
+ name: 'chrome',
232
+ outerHeight: NaN,
233
+ outerWidth: NaN,
234
+ platformName: 'desktop',
235
+ platformVersion: '120.0.0',
236
+ screenHeight: NaN,
237
+ screenWidth: NaN,
238
+ tag: 'test-element'
239
+ },
240
+ hideElements: [],
241
+ hideScrollBars: true,
242
+ isLandscape: false,
243
+ isNativeContext: false,
244
+ platformName: 'desktop',
245
+ removeElements: [],
246
+ });
247
+ const result = await saveWebElement(baseOptions);
248
+ expect(result).toMatchSnapshot();
249
+ expect(takeElementScreenshotSpy.mock.calls[0]).toMatchSnapshot();
250
+ expect(buildAfterScreenshotOptionsSpy.mock.calls[0][0]).toMatchSnapshot();
251
+ expect(afterScreenshotSpy.mock.calls[0][1]).toMatchSnapshot();
252
+ });
253
+ });
@@ -0,0 +1,7 @@
1
+ import type { ScreenshotOutput } from '../helpers/afterScreenshot.interfaces.js';
2
+ import type { InternalSaveScreenMethodOptions } from './save.interfaces.js';
3
+ /**
4
+ * Saves an image of the viewport of the screen
5
+ */
6
+ export default function saveWebScreen({ browserInstance, instanceData, folders, tag, saveScreenOptions, isNativeContext, }: InternalSaveScreenMethodOptions): Promise<ScreenshotOutput>;
7
+ //# sourceMappingURL=saveWebScreen.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"saveWebScreen.d.ts","sourceRoot":"","sources":["../../src/commands/saveWebScreen.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAChF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AAK3E;;GAEG;AACH,wBAA8B,aAAa,CACvC,EACI,eAAe,EACf,YAAY,EACZ,OAAO,EACP,GAAG,EACH,iBAAiB,EACjB,eAAuB,GAC1B,EAAE,+BAA+B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CA4D3B"}
@@ -0,0 +1,48 @@
1
+ import { takeWebScreenshot } from '../methods/takeWebScreenshots.js';
2
+ import beforeScreenshot from '../helpers/beforeScreenshot.js';
3
+ import afterScreenshot from '../helpers/afterScreenshot.js';
4
+ import { canUseBidiScreenshot, getMethodOrWicOption } from '../helpers/utils.js';
5
+ import { createBeforeScreenshotOptions, buildAfterScreenshotOptions } from '../helpers/options.js';
6
+ /**
7
+ * Saves an image of the viewport of the screen
8
+ */
9
+ export default async function saveWebScreen({ browserInstance, instanceData, folders, tag, saveScreenOptions, isNativeContext = false, }) {
10
+ // 1. Set some variables
11
+ const { addIOSBezelCorners, formatImageName, savePerInstance } = saveScreenOptions.wic;
12
+ const enableLegacyScreenshotMethod = getMethodOrWicOption(saveScreenOptions.method, saveScreenOptions.wic, 'enableLegacyScreenshotMethod');
13
+ // 2. Prepare the screenshot
14
+ const beforeOptions = createBeforeScreenshotOptions(instanceData, saveScreenOptions.method, saveScreenOptions.wic);
15
+ const enrichedInstanceData = await beforeScreenshot(browserInstance, beforeOptions);
16
+ const { deviceName, dimensions: { window: { devicePixelRatio, innerHeight, innerWidth, isEmulated, isLandscape, }, }, initialDevicePixelRatio, isAndroid, isAndroidChromeDriverScreenshot, isAndroidNativeWebScreenshot, isIOS, isMobile, } = enrichedInstanceData;
17
+ // 3. Take the screenshot
18
+ const shouldUseBidi = canUseBidiScreenshot(browserInstance) && !isMobile && !enableLegacyScreenshotMethod;
19
+ const webScreenshotOptions = {
20
+ addIOSBezelCorners,
21
+ deviceName,
22
+ devicePixelRatio: devicePixelRatio || 1,
23
+ enableLegacyScreenshotMethod,
24
+ innerHeight,
25
+ innerWidth,
26
+ initialDevicePixelRatio,
27
+ isAndroid,
28
+ isAndroidChromeDriverScreenshot,
29
+ isAndroidNativeWebScreenshot,
30
+ isEmulated,
31
+ isIOS,
32
+ isLandscape,
33
+ isMobile,
34
+ };
35
+ const { base64Image } = await takeWebScreenshot(browserInstance, webScreenshotOptions, shouldUseBidi);
36
+ // 4. Return the data
37
+ const afterOptions = buildAfterScreenshotOptions({
38
+ base64Image,
39
+ folders,
40
+ tag,
41
+ isNativeContext,
42
+ instanceData,
43
+ enrichedInstanceData,
44
+ beforeOptions,
45
+ wicOptions: { formatImageName, savePerInstance }
46
+ });
47
+ return afterScreenshot(browserInstance, afterOptions);
48
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=saveWebScreen.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"saveWebScreen.test.d.ts","sourceRoot":"","sources":["../../src/commands/saveWebScreen.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,222 @@
1
+ import { describe, it, expect, vi, afterEach } from 'vitest';
2
+ import saveWebScreen from './saveWebScreen.js';
3
+ import { takeWebScreenshot } from '../methods/takeWebScreenshots.js';
4
+ import afterScreenshot from '../helpers/afterScreenshot.js';
5
+ import { canUseBidiScreenshot } from '../helpers/utils.js';
6
+ import { createBeforeScreenshotOptions } from '../helpers/options.js';
7
+ import { BASE_CHECK_OPTIONS, BEFORE_SCREENSHOT_OPTIONS, createMethodOptions, createTestOptions, createBeforeScreenshotMock } from '../mocks/mocks.js';
8
+ import { DEVICE_RECTANGLES } from '../helpers/constants.js';
9
+ vi.mock('../methods/takeWebScreenshots.js', () => ({
10
+ takeWebScreenshot: vi.fn().mockResolvedValue({
11
+ base64Image: 'web-screenshot-data'
12
+ })
13
+ }));
14
+ vi.mock('../helpers/beforeScreenshot.js', () => ({
15
+ default: vi.fn().mockResolvedValue({
16
+ browserName: 'chrome',
17
+ browserVersion: '120.0.0',
18
+ deviceName: 'desktop',
19
+ dimensions: {
20
+ body: {
21
+ scrollHeight: 1000,
22
+ offsetHeight: 1000
23
+ },
24
+ html: {
25
+ clientWidth: 1200,
26
+ scrollWidth: 1200,
27
+ clientHeight: 900,
28
+ scrollHeight: 1000,
29
+ offsetHeight: 1000
30
+ },
31
+ window: {
32
+ devicePixelRatio: 2,
33
+ innerHeight: 900,
34
+ innerWidth: 1200,
35
+ isEmulated: false,
36
+ isLandscape: false,
37
+ outerHeight: 1000,
38
+ outerWidth: 1200,
39
+ screenHeight: 1080,
40
+ screenWidth: 1920,
41
+ },
42
+ },
43
+ isAndroid: false,
44
+ isAndroidChromeDriverScreenshot: false,
45
+ isAndroidNativeWebScreenshot: false,
46
+ isIOS: false,
47
+ isMobile: false,
48
+ isTestInBrowser: true,
49
+ isTestInMobileBrowser: false,
50
+ addressBarShadowPadding: 0,
51
+ toolBarShadowPadding: 0,
52
+ appName: '',
53
+ logName: 'chrome',
54
+ name: 'chrome',
55
+ platformName: 'desktop',
56
+ platformVersion: '120.0.0',
57
+ devicePixelRatio: 2,
58
+ deviceRectangles: {
59
+ bottomBar: { height: 0, width: 0, x: 0, y: 0 },
60
+ homeBar: { height: 0, width: 0, x: 0, y: 0 },
61
+ leftSidePadding: { height: 0, width: 0, x: 0, y: 0 },
62
+ rightSidePadding: { height: 0, width: 0, x: 0, y: 0 },
63
+ screenSize: { height: 0, width: 0 },
64
+ statusBar: { height: 0, width: 0, x: 0, y: 0 },
65
+ statusBarAndAddressBar: { height: 0, width: 0, x: 0, y: 0 },
66
+ viewport: { height: 0, width: 0, x: 0, y: 0 }
67
+ },
68
+ initialDevicePixelRatio: 2,
69
+ nativeWebScreenshot: false
70
+ })
71
+ }));
72
+ vi.mock('../helpers/afterScreenshot.js', () => ({
73
+ default: vi.fn().mockResolvedValue({
74
+ devicePixelRatio: 2,
75
+ fileName: 'test-screen.png'
76
+ })
77
+ }));
78
+ vi.mock('../helpers/utils.js', () => ({
79
+ canUseBidiScreenshot: vi.fn().mockReturnValue(false),
80
+ getMethodOrWicOption: vi.fn().mockImplementation((method, wic, option) => method[option] ?? wic[option])
81
+ }));
82
+ vi.mock('../helpers/options.js', async (importOriginal) => {
83
+ const actual = await importOriginal();
84
+ return {
85
+ ...actual,
86
+ createBeforeScreenshotOptions: vi.fn().mockReturnValue({
87
+ instanceData: { test: 'data' },
88
+ addressBarShadowPadding: 6,
89
+ toolBarShadowPadding: 6,
90
+ disableBlinkingCursor: false,
91
+ disableCSSAnimation: false,
92
+ enableLayoutTesting: false,
93
+ hideElements: [],
94
+ noScrollBars: true,
95
+ removeElements: [],
96
+ waitForFontsLoaded: false,
97
+ }),
98
+ };
99
+ });
100
+ describe('saveWebScreen', () => {
101
+ const takeWebScreenshotSpy = vi.mocked(takeWebScreenshot);
102
+ const afterScreenshotSpy = vi.mocked(afterScreenshot);
103
+ const canUseBidiScreenshotSpy = vi.mocked(canUseBidiScreenshot);
104
+ const createBeforeScreenshotOptionsSpy = vi.mocked(createBeforeScreenshotOptions);
105
+ const baseOptions = {
106
+ browserInstance: { isAndroid: false, isMobile: false },
107
+ folders: BASE_CHECK_OPTIONS.folders,
108
+ instanceData: {
109
+ ...BEFORE_SCREENSHOT_OPTIONS.instanceData,
110
+ deviceRectangles: {
111
+ ...DEVICE_RECTANGLES,
112
+ screenSize: {
113
+ width: 1920,
114
+ height: 1080
115
+ }
116
+ }
117
+ },
118
+ isNativeContext: false,
119
+ saveScreenOptions: {
120
+ wic: BASE_CHECK_OPTIONS.wic,
121
+ method: createMethodOptions({
122
+ disableBlinkingCursor: false,
123
+ disableCSSAnimation: false,
124
+ enableLayoutTesting: false,
125
+ enableLegacyScreenshotMethod: false,
126
+ hideScrollBars: true,
127
+ hideElements: [],
128
+ removeElements: [],
129
+ waitForFontsLoaded: true,
130
+ })
131
+ },
132
+ tag: 'test-screen'
133
+ };
134
+ afterEach(() => {
135
+ vi.clearAllMocks();
136
+ });
137
+ it('should call takeWebScreenshot with correct options when BiDi is available', async () => {
138
+ canUseBidiScreenshotSpy.mockReturnValueOnce(true);
139
+ const result = await saveWebScreen(baseOptions);
140
+ expect(result).toMatchSnapshot();
141
+ expect(createBeforeScreenshotOptionsSpy).toHaveBeenCalledWith(baseOptions.instanceData, baseOptions.saveScreenOptions.method, baseOptions.saveScreenOptions.wic);
142
+ expect(takeWebScreenshotSpy.mock.calls[0]).toMatchSnapshot();
143
+ expect(afterScreenshotSpy.mock.calls[0]).toMatchSnapshot();
144
+ });
145
+ it('should call takeWebScreenshot with BiDi disabled when not available', async () => {
146
+ canUseBidiScreenshotSpy.mockReturnValueOnce(false);
147
+ const result = await saveWebScreen(baseOptions);
148
+ expect(result).toMatchSnapshot();
149
+ expect(takeWebScreenshotSpy.mock.calls[0]).toMatchSnapshot();
150
+ expect(afterScreenshotSpy.mock.calls[0]).toMatchSnapshot();
151
+ });
152
+ it('should call takeWebScreenshot with BiDi disabled when mobile device', async () => {
153
+ canUseBidiScreenshotSpy.mockReturnValueOnce(true);
154
+ const beforeScreenshotMock = createBeforeScreenshotMock({ isMobile: true });
155
+ vi.mocked((await import('../helpers/beforeScreenshot.js')).default).mockResolvedValueOnce(beforeScreenshotMock);
156
+ const result = await saveWebScreen(baseOptions);
157
+ expect(result).toMatchSnapshot();
158
+ expect(takeWebScreenshotSpy.mock.calls[0]).toMatchSnapshot();
159
+ });
160
+ it('should call takeWebScreenshot with BiDi disabled when legacy method enabled', async () => {
161
+ canUseBidiScreenshotSpy.mockReturnValueOnce(true);
162
+ const options = createTestOptions(baseOptions, {
163
+ saveScreenOptions: {
164
+ ...baseOptions.saveScreenOptions,
165
+ method: createMethodOptions({
166
+ enableLegacyScreenshotMethod: true
167
+ })
168
+ }
169
+ });
170
+ const result = await saveWebScreen(options);
171
+ expect(result).toMatchSnapshot();
172
+ expect(takeWebScreenshotSpy.mock.calls[0]).toMatchSnapshot();
173
+ });
174
+ it('should pass iOS configuration correctly', async () => {
175
+ const beforeScreenshotMock = createBeforeScreenshotMock({
176
+ isIOS: true,
177
+ deviceName: 'iPhone 14 Pro',
178
+ dimensions: {
179
+ window: {
180
+ isLandscape: true
181
+ }
182
+ }
183
+ });
184
+ vi.mocked((await import('../helpers/beforeScreenshot.js')).default).mockResolvedValueOnce(beforeScreenshotMock);
185
+ const options = createTestOptions(baseOptions, {
186
+ saveScreenOptions: {
187
+ ...baseOptions.saveScreenOptions,
188
+ wic: {
189
+ ...baseOptions.saveScreenOptions.wic,
190
+ addIOSBezelCorners: true
191
+ }
192
+ }
193
+ });
194
+ const result = await saveWebScreen(options);
195
+ expect(result).toMatchSnapshot();
196
+ expect(takeWebScreenshotSpy.mock.calls[0]).toMatchSnapshot();
197
+ });
198
+ it('should handle NaN dimension values correctly', async () => {
199
+ const nanDimensions = createBeforeScreenshotMock({
200
+ dimensions: {
201
+ window: {
202
+ devicePixelRatio: NaN,
203
+ innerHeight: NaN,
204
+ innerWidth: NaN,
205
+ isEmulated: false,
206
+ isLandscape: false,
207
+ outerHeight: NaN,
208
+ outerWidth: NaN,
209
+ screenHeight: NaN,
210
+ screenWidth: NaN,
211
+ },
212
+ },
213
+ devicePixelRatio: NaN,
214
+ initialDevicePixelRatio: NaN
215
+ });
216
+ vi.mocked((await import('../helpers/beforeScreenshot.js')).default).mockResolvedValueOnce(nanDimensions);
217
+ const result = await saveWebScreen(baseOptions);
218
+ expect(result).toMatchSnapshot();
219
+ expect(takeWebScreenshotSpy.mock.calls[0]).toMatchSnapshot();
220
+ expect(afterScreenshotSpy.mock.calls[0]).toMatchSnapshot();
221
+ });
222
+ });
@@ -0,0 +1,16 @@
1
+ import type { BaseMobileWebScreenshotOptions, BaseWebScreenshotOptions, Folders } from '../base.interfaces.js';
2
+ import type { DefaultOptions } from '../helpers/options.interfaces.js';
3
+ import type { CheckMethodOptions } from './check.interfaces.js';
4
+ export interface SaveScreenOptions {
5
+ wic: DefaultOptions;
6
+ method: SaveScreenMethodOptions;
7
+ }
8
+ export interface SaveScreenMethodOptions extends Partial<Folders>, BaseWebScreenshotOptions, BaseMobileWebScreenshotOptions {
9
+ }
10
+ export interface CheckScreenMethodOptions extends SaveScreenMethodOptions, CheckMethodOptions {
11
+ }
12
+ export interface CheckScreenOptions {
13
+ wic: DefaultOptions;
14
+ method: CheckScreenMethodOptions;
15
+ }
16
+ //# sourceMappingURL=screen.interfaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"screen.interfaces.d.ts","sourceRoot":"","sources":["../../src/commands/screen.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC9G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,uBAAuB,CAAC;CACnC;AAED,MAAM,WAAW,uBAAwB,SAAQ,OAAO,CAAC,OAAO,CAAC,EAAE,wBAAwB,EAAE,8BAA8B;CAC1H;AAED,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB,EAAE,kBAAkB;CAAI;AAEjG,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,wBAAwB,CAAC;CACpC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,29 @@
1
+ import type { DefaultOptions } from '../helpers/options.interfaces.js';
2
+ import type { CheckFullPageMethodOptions, SaveFullPageMethodOptions } from './fullPage.interfaces.js';
3
+ export interface SaveTabbableOptions {
4
+ wic: DefaultOptions;
5
+ method: SaveFullPageMethodOptions;
6
+ }
7
+ export interface CheckTabbableOptions {
8
+ wic: DefaultOptions;
9
+ method: CheckFullPageMethodOptions;
10
+ }
11
+ export interface TabbableOptions {
12
+ circle?: CircleOptions;
13
+ line?: LineOptions;
14
+ }
15
+ export interface CircleOptions {
16
+ backgroundColor?: string;
17
+ borderColor?: string;
18
+ borderWidth?: number;
19
+ fontColor?: string;
20
+ fontFamily?: string;
21
+ fontSize?: number;
22
+ size?: number;
23
+ showNumber?: boolean;
24
+ }
25
+ export interface LineOptions {
26
+ color?: string;
27
+ width?: number;
28
+ }
29
+ //# sourceMappingURL=tabbable.interfaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tabbable.interfaces.d.ts","sourceRoot":"","sources":["../../src/commands/tabbable.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAErG,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,yBAAyB,CAAC;CACrC;AACD,MAAM,WAAW,oBAAoB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,0BAA0B,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,WAAW,CAAC;CACtB;AACD,MAAM,WAAW,aAAa;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,7 @@
1
+ import type { AfterScreenshotOptions, ScreenshotOutput } from './afterScreenshot.interfaces.js';
2
+ /**
3
+ * Methods that need to be executed after a screenshot has been taken
4
+ * to set all back to the original state
5
+ */
6
+ export default function afterScreenshot(browserInstance: WebdriverIO.Browser, options: AfterScreenshotOptions): Promise<ScreenshotOutput>;
7
+ //# sourceMappingURL=afterScreenshot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"afterScreenshot.d.ts","sourceRoot":"","sources":["../../src/helpers/afterScreenshot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAM/F;;;GAGG;AACH,wBAA8B,eAAe,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+D9I"}
@@ -0,0 +1,46 @@
1
+ export interface ScreenshotOutput {
2
+ devicePixelRatio: number;
3
+ fileName: string;
4
+ isLandscape: boolean;
5
+ path: string;
6
+ }
7
+ export interface AfterScreenshotOptions {
8
+ actualFolder: string;
9
+ base64Image: string;
10
+ disableBlinkingCursor?: boolean;
11
+ disableCSSAnimation?: boolean;
12
+ enableLayoutTesting?: boolean;
13
+ hideScrollBars?: boolean;
14
+ filePath: ScreenshotFilePathOptions;
15
+ fileName: ScreenshotFileNameOptions;
16
+ hideElements?: (HTMLElement | HTMLElement[])[];
17
+ isLandscape: boolean;
18
+ isNativeContext: boolean;
19
+ platformName: string;
20
+ removeElements?: (HTMLElement | HTMLElement[])[];
21
+ }
22
+ export interface ScreenshotFilePathOptions {
23
+ browserName: string;
24
+ deviceName: string;
25
+ isMobile: boolean;
26
+ savePerInstance: boolean;
27
+ }
28
+ export interface ScreenshotFileNameOptions {
29
+ browserName: string;
30
+ browserVersion: string;
31
+ deviceName: string;
32
+ devicePixelRatio: number;
33
+ formatImageName: string;
34
+ isMobile: boolean;
35
+ isTestInBrowser: boolean;
36
+ logName: string;
37
+ name: string;
38
+ outerHeight?: number;
39
+ outerWidth?: number;
40
+ platformName: string;
41
+ platformVersion: string;
42
+ screenHeight: number;
43
+ screenWidth: number;
44
+ tag: string;
45
+ }
46
+ //# sourceMappingURL=afterScreenshot.interfaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"afterScreenshot.interfaces.d.ts","sourceRoot":"","sources":["../../src/helpers/afterScreenshot.interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAE7B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,QAAQ,EAAE,MAAM,CAAC;IAEjB,WAAW,EAAE,OAAO,CAAC;IAErB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IAEnC,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW,EAAE,MAAM,CAAC;IAEpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,QAAQ,EAAE,yBAAyB,CAAC;IAEpC,QAAQ,EAAE,yBAAyB,CAAC;IAEpC,YAAY,CAAC,EAAE,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,EAAE,CAAC;IAE/C,WAAW,EAAE,OAAO,CAAC;IAErB,eAAe,EAAE,OAAO,CAAC;IAEzB,YAAY,EAAE,MAAM,CAAC;IAErB,cAAc,CAAC,EAAE,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,yBAAyB;IAEtC,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,OAAO,CAAC;IAElB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IAEtC,WAAW,EAAE,MAAM,CAAC;IAEpB,cAAc,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,eAAe,EAAE,MAAM,CAAC;IAExB,QAAQ,EAAE,OAAO,CAAC;IAElB,eAAe,EAAE,OAAO,CAAC;IAEzB,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,YAAY,EAAE,MAAM,CAAC;IAErB,eAAe,EAAE,MAAM,CAAC;IAExB,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW,EAAE,MAAM,CAAC;IAEpB,GAAG,EAAE,MAAM,CAAC;CACf"}
@@ -0,0 +1 @@
1
+ export {};