{"_id":"@flexn/graybox","_rev":"172-0cf74f123176a230758d2ba3388a9f76","name":"@flexn/graybox","dist-tags":{"alpha":"0.21.2-alpha.16","latest":"1.0.0","feat":"1.0.0-feat.12"},"versions":{"0.8.0-alpha.4":{"name":"@flexn/graybox","version":"0.8.0-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1"},"gitHead":"c78e31ef886f573cc96b1ee9b9f9138fe01a5da2","_id":"@flexn/graybox@0.8.0-alpha.4","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-Klg903CY2NktMXK6t763mD/DNkcBxLWLf8xbPHhFr7Hz3dDQotF84TkiLLptJ7vlBB61/V5wxwyGmfVKHGX+yg==","shasum":"b28ccdd3ae69e7b349b4b47c842f68e328408f48","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.8.0-alpha.4.tgz","fileCount":43,"unpackedSize":54395,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh9R8nCRA9TVsSAnZWagAAv7EQAJiInz/fiJX4AW76eDsZ\nNG1rXmmo19ISQVRpuE2toz9UadNPlYvK5dcJv7n5SHVDnGDwibWL4R2i3YMP\nLeOYt0MST0+NyEpLpcyowCqFtZUFu7NAnI5lgYzZ92241rOwJxsu5Dg1YDIZ\njPKUCVQppogkhmZJOUr0SGxzomSYKqZNQy62p73Fc2Ydm2eJFMM+5HBh9ld7\nrNa6S7iv0rhEJkCw2QDt7Ov6wHGwl2QdBIXwg/MWSXcZnblXMe2+xm1jJkFf\n9BFGObVtvxKPGPUiDowfzoxoSXtPmaEq80FYwvW9VGpO4JPEWnZkoaALO7Jp\nQgw2eyqHJ2lk8BRf6lhaGopWtDbYxyn+bGr5xgMdyPTvDotuOHfNHdJP4YX9\nQWkKxp+P6Ymg6PMxh7wpvadB5p8gwOaT/sOhYi5dmPhOb3moizu+HL0nW7tU\nUFhTc894zFn6S3+4BgS5e9A+AM0sa+K6ge5TJCCmYHyk48DMV9Oo9/K+N60d\nuFqo4JcEGuAhNh+zfSrheEFLAP++U9t4avF7dDt3GLya75UUbbTcth/TKUJW\n+7jdVyP+6ay4iiTor7gANaAZ2pI2xGK3hu5enmXQbQfb7RP70vKApl0iLduz\n6NQTTOsFjIKwpGzcx9uVOSoDrcN3u1i8EOkm+pB3Ld1tD5jMEYL83qhopPY7\nwhJQ\r\n=rj++\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDZjbG1eiG2nkIYkvOHXdhk2f/RbKyOZeHnCrzR6IOcRgIhAL5Dwf0HvyPK726hDlkijRF6g6GukHk8RILSfp0hXvtk"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.8.0-alpha.4_1643454247393_0.4761668212472041"},"_hasShrinkwrap":false},"0.9.0-alpha.0":{"name":"@flexn/graybox","version":"0.9.0-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1"},"gitHead":"0fc5fc8d8b13a7df087137d2d65adb4707a945b8","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.9.0-alpha.0","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-UVB/NCVZURwY8kOhBSGL3Qp4rgS6KcH6uJf5LjL/JSmM4ygOPI6SGnEOxKx0uX553lEtiNy9XyB6jv3ZWzkuBg==","shasum":"126a6269e5dea92c958ca41850c33d9bf6afe650","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.0-alpha.0.tgz","fileCount":43,"unpackedSize":54395,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh9UL9CRA9TVsSAnZWagAAsQAQAJxVMCNyVUsOH6g+254p\ncQilPW3oeRJ5MxsNL9V9Eo3yKxNMFLdGbjhEl02kRGgeNhVCMBwxkNVk/WyF\nJchEKN8Bj30U6Adf1HE/GZOMM8B6jK9q06MlZQ+9VuFSHoJhiroM8zzfsXhj\nlCuBQs+s/55xF9iQmgqIkOgglbUcffrcr9YKg9wq/fat9BPgJ99RJ5Q1UscI\nrHGpJbf2DO4XKlMdDsVS4yR+zw7jnFBnDrBps6kkYMtPw4svlG8dwj0ef9WH\ndbMTgs4x2Ve6v1ZjHdD98W/JLSuW3bmbX75dQRz6FcGmPKDfate/Y6lAjKKJ\nozvzhqH35atrV3a5uxhkUSIS9L+RTE19JFkkTzxAM1n3SVPNcT8jTieudHNW\nrusDahmjVm33H2M5r0axFKAGJ2f8Fxl9XvOeKtW3CdJfURkce6R4dXl7UcPn\n8Ttbf/30qOGWGbsL+IvuIdbXS+QDuKTwlVQo6pOG4E5hTUOWpEPCVbpJ9KRv\nP4dogrsczLyfkJK7fwOoEJGitYg/bmDN+bKyuWEtW76YXuw12zaagdc69mG8\na4JFHk3LoeeJHmpmJIXYS+Dbd6GPCXT6QsFmB5XzkZY4ZtOXTgAQfgA5nJ1L\nryyKsCA1ff3Uf3gENkgqTvoYSx6mPOti6hUyBRVZ3Z6e8NdMS5zrBPrxADjh\nf4G7\r\n=ujKt\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIG0Edl2p3DEQq7jIX95+sT9mLCwqQ5GCRBApvi5MBTfQAiAx1Ftiz5O3BE+NOo+QTU5TjEJefDfKtvdG7F4WdHjfLQ=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.0-alpha.0_1643463421678_0.7281210238151532"},"_hasShrinkwrap":false},"0.9.0-alpha.1":{"name":"@flexn/graybox","version":"0.9.0-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1"},"gitHead":"41a512d0e0331a32bc6fb1f6360e661430957f16","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.9.0-alpha.1","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-DvqHGrPLBjzg+eivil46APkOjLCzd+IPVEgg7q4yOLZv+9ANd+BF82iRuNjAxLtpx2HQ6K3wo2IYbxU8jfxISQ==","shasum":"c006d5ae6ccf81cfd5d0b628813e0e0f8d61b294","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.0-alpha.1.tgz","fileCount":43,"unpackedSize":79270,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh9u12CRA9TVsSAnZWagAACmoP/jhBizkRKwJedEoLX0hW\nLUXodXjR0zDBuIAPbs4sglVVcLN1eRRaZtUWjCcFnnbhf9YJaDbC4DYSOZdy\ngr7p+FyL55kDWi/f3HsQtMIS1236mtCD/AeuDmyck3sJ6f1dRsCy4PAkfsl3\nSLHtic6bmt6YwqMIBog9+dLQyRWxisJj3ZVXPVpREPsjQgX1GD688o5ouFWA\nCVBkuBTjqpA6Y36cMeCeHIQ3b8E0mOuaiYKJhi8G3djIUTgD/gXGsU+n4Gkl\ne2gRaXiaht79/FD7YnP9SAuNXqCeG8a1bLrOcj4WWXrE4lX3jENlTWZvQRVr\nUygyY/cbRsdIZx+KMHL8cRgyv1f7t9G0wja6qzlqswvzw2y2eNHwtCpd7B0Q\nNfizm7zHirOuZi+kPBfCQjvu71JDOyaY7atZEoE/dTt/EFT9EZONoClfrIVv\nX49WEwWxKJb1PuRGRe/Pz2iuwIYQBsuXThXFy4sP15zhrK4CN2QABV0EBKGa\nmGxoRz49E6tnM9fHafBZCDG0vSFI1wPn+7uLKbtyckUZ34u4of+qTFdAmM3H\nV4B/wRlMiOEYijiHNLpWRi/bg8Xvu9aJhMDRV5+c6dpGIV2OM6glaasW/q/J\n+OhRSSIxVu9orhF77nusARFUbdfGyPzb2NLlrda7tCW1MpkmOeGSBsNsAPKo\nFl9V\r\n=RyV5\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIERdzAsn1rpfzb+4530mCwTCHbrc10S5shXfV8QDRci0AiEA6kPFJHWVVWnWvbV+Ot+KmqfyVf7zdb0EGi0hQrzntBw="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.0-alpha.1_1643572598367_0.13448570973081697"},"_hasShrinkwrap":false},"0.9.0-alpha.2":{"name":"@flexn/graybox","version":"0.9.0-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1"},"gitHead":"d9fb7f20ab925a1072c80f01456a7127b757b0bf","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.9.0-alpha.2","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-S92e50hUSXLbUW6Ew1okF4rV+RbgPD1TiYljGDsl4PYgMdXGWYFPwTDQ7wTMN6UZRW09DZUouy5fWm6/zOv4xQ==","shasum":"fbfc3a4165498cd3fa75e7dd9f1a20e8953abfce","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.0-alpha.2.tgz","fileCount":43,"unpackedSize":79270,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh95BLCRA9TVsSAnZWagAA5gkQAJzzwomnWrozJWYQoOap\nGnhWj5mk17f9AGsUOEz18BAPrD5vP7Uyi71YzHXnNaG5QZRDG795MOiXPQt1\n2ZQo62cSYAbLWU97vCFDlXtbJ+4I75XUb6PbWim0g5pUZZ9orHpflXH/57L4\n+gqCgfnjBYIHc0GKVk6GeIusy1evYvTiBATq1BTOuFtGQ46B0mLV99mzr23q\nlcECdODAP89B+NUv3WtgE/kTmeIv9I2YQ5nEj0TdMpEPVA5NsfotXRr5AH9D\nNNyaHVLaq7Xo3+83uEv8wnwCCGSPKVVd/KptS5xf3VH5y9gMHNeJ0G9WbbMj\nrv7ICb8gRJ4mx0CvOlAM7oRFC2GKSBcc33sPd2d0CVmyDZFhf7ZIx9K5T0RZ\nyELUX1tK7WxVom1Kxn+wwKPGWRqR2M3QwMg0u1CkUsSQFHQQBzJgWeDF0NYH\nR42+ZunRCmxh7mX7asCOpwkDC15mOHz2m5euNKdc07KCIOkvFA93seMpjsR0\nXXKr9OGTwOAgcpbtnH7ki20BEVyAYJL4SvPX8Mwwd+wO2b1ICS190sdpyw96\nh2Y2G1xQDBfwgsE6R8zS54mUSv0agmVxEZ/gTTsQ1gLbe3ZSXvVtH+w3JZzN\nQvRq+wm4zck4uEPaIVPPitPzNQCKTMROTuvTxL7PFhVFmNEb5FkFpTq0CN+C\nGDe/\r\n=W2x3\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCoRtT0q36mucoV+kCBsOKcottoolaa5BYI22EqrST8vgIhAJDTulkSmnGHyMntQ/BMC2lSWEMWCJFT2yvYcpTHShLN"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.0-alpha.2_1643614282896_0.3107481057101229"},"_hasShrinkwrap":false},"0.9.0-feat.0":{"name":"@flexn/graybox","version":"0.9.0-feat.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/appium-service":"^7.8.0","appium":"^1.21.0","@wdio/cli":"^7.9.1","@wdio/allure-reporter":"^7.10.0","allure-commandline":"^2.13.8","@wdio/spec-reporter":"^7.9.0","@wdio/selenium-standalone-service":"^7.10.1","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","gitHead":"c25a8032524d30661a54bde811888a64e3db2f8e","_id":"@flexn/graybox@0.9.0-feat.0","_nodeVersion":"16.12.0","_npmVersion":"8.1.0","dist":{"integrity":"sha512-meMYPEWigaJ8bCaYqeJqH8qWJ8JgMZlJRcstjSvLd0iPQZZ/Nmx9saRsV4tCvsQ6yoHUleRXAeo9tPVAje9TFA==","shasum":"a654e2fce4ea8b945a8584ae84e7b587d811dfe2","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.0-feat.0.tgz","fileCount":43,"unpackedSize":79574,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh+AaCCRA9TVsSAnZWagAAsLAP/2QcQgBbagfqJbUvC7f5\n5yfDKfYtHSKZHIYIio62IuisEIhcq2g1aDOwhPAodWgG1jKo+4fG3A/V0iae\nOrtHWIit7xsFcZibtSmgy64+A/fRAo4Lm//pfbcgdwvv0/mOmNdKW7WxntvN\n30Ef1fJJq8x5WTxUbr2vjQBxbQhlSxMVCk5ybD2pB69qb0WGh6h1z87L+2kh\n7wvrH5XAfgX8rdMOB/FaMHZo5MCp5L+B6BtjzBgszghky1SUMWxUtxJgZQHj\n/mvnoansYF6tQ9w6zzJ9oe6FuNlpkn3G51EEi2C8pwu0ceod5GWjDLlNFJej\necpRpB84hRjwkefM4wOnUdJWkJdjK8hhhsrnO2+y31Pmd8vJPU1YmBH9fzDO\naGmMxyaFH++1uYh/y93y9J7TdnwZR3EhPL4euf8HhacZaahUKnneMYNet1sW\nVVjg3foaB7phTeBq2gH/Mapb9eDNHPC3xTa1RKqUcigIgjDe1G1tTbuTc9DH\nul+EVq2NeJQdIWhcdZFzut/wckXleVqIJQTZEQAX6tnRTPYMWy4J/V+79dLE\n2xXGiljjtZcmU0H4FMKmNtE6ONQTLNX+hWhQn1jxHc11BG6RBlMjHTWDISNa\nRu1GSxbLCKfW1oVFUHni5tPM/2/LFakXz5+nFBKD/Rq/uowuoTxz1FUxSo7h\n7kD7\r\n=hCUg\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCMQZHRJeh0Gpwh+CSP7LiX5vEEkN4+Sv5xOLDwCqgQNgIhAP8KTHE8bDd/mCBq2O3FiYTvxwVUrvMyQh7i3EP5l3Ep"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.0-feat.0_1643644546185_0.9768502696439256"},"_hasShrinkwrap":false},"0.9.0-alpha.3":{"name":"@flexn/graybox","version":"0.9.0-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1"},"gitHead":"48070f5696b8c05de715aafd3440f5d17c78fb84","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.9.0-alpha.3","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-hbKwuw9etyOl9fgdOxoKYlbiKbvYHmFOLpo2HTFePEQGTWcZUM+UNVmMM6HuDV4Od2qoTbP8wXtPCBlNHGxPHQ==","shasum":"564542e5a423940a348f94161300113b4943bc75","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.0-alpha.3.tgz","fileCount":43,"unpackedSize":79270,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh+RppCRA9TVsSAnZWagAAnLoP/22BvZH2WPhDIemDnN1+\nY5q3HYKCz/YSk9ay4qgJxunDkjtLl6G3l+sugqrxUClPScCXJZEb/Tl+wosq\n6t/3Bdt1u/jv4t67SetCJhf+u7Zv9AKYPpkZtRaJ81SQcXZITipvXf1DTR1l\nBRb6E969+BOYFHlyUgC+QSRRc0x2KLGeLqRrupxkBHsa6pGNEUuSrSLg951M\nDidgIT9BKOUCLR/Bd/V18D6DhGYXIMnrWgk+SzQuyeXP8zmqS7hVwxpQJ8hD\nRFq2TA4KXTTIrPmctrw9jl1qJyzwwx3qfGPsmb2C78feyFRExag9oxlMxE9y\nSyXan9EuSiGmUy5+LKW3+WYpTQZDx0r7BpzwSnSD8gILrnarcWXygabqApAu\neQTs1t6Dcydnp4Vl+KF4s8tTLUALKTWQBAmLypwlCR1ACQGEdvppfEkrBLaR\n5CDBw/NT0yOehZgocpGqZF/QSMHgVg7MjS29CjDQCHa0lfWkuAAU24JwaeCK\n0xGmDkAjnoUIENX08bl0YJ9rpNrqmIqywOIWTSKl2qOuxBmxogAxXVNgt2wG\n9BFMOwFXEbf2B6OjNfhIqUrokXOd75CT4BM3+19HKSA3hS/mzgjd8ICdDv8y\nvew+AgFCtJ1tQYYqgh5QinrlYlO2BYr/uQenO9J6nlN9Hf9c2/nD6zlGS2fB\n74cl\r\n=oydX\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDDGiuHOKrpkpc0isr2Yg4uzMkVVfuJ5pQb+Rz5JHHwIwIgM4gCJ3w2RjTie9BpVzJcYdG9NGU1yW/abTGwAiBASo8="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.0-alpha.3_1643715177618_0.660310430528011"},"_hasShrinkwrap":false},"0.9.0-alpha.4":{"name":"@flexn/graybox","version":"0.9.0-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1"},"gitHead":"ea6430d72928ba84a1f6f6f6aa6854c5680451e5","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.9.0-alpha.4","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-KO/ZhgQoB9/ictrVpd74vvo2fBKRfFYaUbTifk0WV8XA7u11DKbN801ASXhj0JRnfx51z4xQOrJzMV1yA5FiAw==","shasum":"daaf5e83a001e680d294454f7ed6942822c9bc33","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.0-alpha.4.tgz","fileCount":43,"unpackedSize":79270,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh+Zy0CRA9TVsSAnZWagAAp5YP+QEC6yoR8Vovw4zV+PKu\naCWIdzjKp+PPMX6bji6aVFbFqvwqN15LgayNX1HsXwST3k/q0nkAq/rCyBJO\nvyadD+1zzgDkPMe+cAGBsPc9a/xbf8T4W/2mVI0aeFkDjigWD3O85sTRRN1i\ntcyRyleI6h2W87nn2WpE0Sxjhpz5FiXDpRmJd06yZ5aaGq+pQRQbwEsKjtfm\ngF6u7GCK9PT3B/dMjskIg4ZePP7K9LwKqmOctSyV8onpwPh49aBI0xvSOL9d\nrL305JiYE2MK27XEbUIAXAjNpXY7J/orAVqCLUOdTbhqKqmQO5jhRfgHCfko\nYRhRwVDZDOkHwhjfoXlhxfanjqw3ra0C69AME55L3KrlJR6sCfl4euZusSG6\n70B3xpwih8TbvuW6ZRRZeloT9nhOYUKwnxUe93tvK18I8Nb4mS58L1DYSj1T\nGdczUxJNFs+R+Zhquqo6JsSx5F19dIPRsd809M+iZJAiVD54uzWkj68nry2G\n5UEZC47SqbJx9+By2ex+V8s2yqZ5TfERXSjURj4z4g1EhWG7Or7t9VkCwA06\n3gdTMToJL5N9Ovt2WxHAg3A6lScsGX0kYk0gjabx/iPhF+MQJMGo5BOZgsTj\nYFnL2vMczxQNmx5KjntabadRZWCwFDjPXlDFCONNxqz1IDoCakW1p4mhGDia\ncI1s\r\n=t+3N\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDKL8dYdKLuIp9vohgecZWCSzTwYfX7G7CPRDCzYph3wAIgDVRg9tEG9TEIpumTDBJ7rWF/evuqVdviNuWQx69X71I="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.0-alpha.4_1643748531999_0.1258464542662172"},"_hasShrinkwrap":false},"0.8.0":{"name":"@flexn/graybox","version":"0.8.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"e8841d69aafdf82298c150ee10a77cc53de83619","_id":"@flexn/graybox@0.8.0","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-AWPExemUEcAfetC9jjnY3PcvR+Qit7XtHoVJOkPt+JqlLUvmrgS4ICyws1mH57IRpFcBQBGNgNr4LzuLF1sTxg==","shasum":"ce6792d4ed905a398b1d21b45f8ef310de8ec729","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.8.0.tgz","fileCount":43,"unpackedSize":79626,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh/Uj7CRA9TVsSAnZWagAAowoP/2JDXkDX85+FaIrEl66R\nehMOTtvB/PoCbkwrOGac7iNNBxbWHChd9+RWQ4Uez3+sNVbYPe6xd7AF8GQJ\nTg43QiBVmEHGK0rkXRdesk+4jmfkpZSqqX5B1mekVTTr2hMoAlr37rcE+eJF\nnl91FhWyQa7k8pUvSoc7bfVTXaDke9OA0dq83yJrbKxKnSn9UDEPmGRaPhaV\nVaPvX5+wsFAZcwFrRJ4wB2BLHtWHWAdS4dKXkvRinjAeqiDhjqYX/3zhKl+W\n/3hqXjN5qUGrEhXon5FJtAC8uGoMnh6jsUV1T16sF9vmItrj8n4yt7L9TC8w\nYarsRe+zv/WFvSVyAuLwAYaynpwQWEuJfpBDMFtpzykzrQgIyqq+CRSXlvCn\nWg7TUZepZQxZgJw0OqRSH1pbUTa5upDGBlP4Jxjk41Af6VQxGgwUCop1imuz\npk9xsvsH4tTMbF9TMc7nsnwY1CG0u06ks0DEntcDOAllHWAU0KqFMDfu2yRK\nCCt6HNOPGwFMgACAAGFB5kjdaCsuSxNagjWamJldkiiIQ3BxhJx4yYR9NBbE\nxtb96OqlCG3LExb7VYCiOaoWgGJDZldQwNOnh8Jm2bvMWBSqXSlmDq2KjGa8\n6mfnyIEy1xj3DwTLnd//y81RTuw9iAtRQDIuwz1UnrjEhaDl6c6RmxgG8Wrv\nIUvz\r\n=a3eu\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCAvqHfl/WDMI1TIkWGvGYL+8uK6J/2nPx9JlAziOdiKwIhAMRvYhC6Yg4B5EmZuUkdCjS880v6+/nNR1y2T2A51bSM"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.8.0_1643989242976_0.3577711276465032"},"_hasShrinkwrap":false},"0.8.1":{"name":"@flexn/graybox","version":"0.8.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"c16338d6fd1def6902e8243220b50ba3f9505298","_id":"@flexn/graybox@0.8.1","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-WayDPC3EamuCzDzJKmCVRJFPCR2C/gXtZMp8WfiE+ibMR8e+EBl7vqaRaj6e5KpENTH+xJ6v0w2p4RIA78bprg==","shasum":"de0438d999aef34a0223dc29fa012d820de9b219","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.8.1.tgz","fileCount":43,"unpackedSize":79626,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJiAOquCRA9TVsSAnZWagAAhukP/17KtDxUbcHbT4qgkAs7\nJcLFsfkV+KzhWT+TD3sEBShGJu6FyYiK10z2bPFuKQb/IxyZTr+hHjKnbSlN\ngLKK75NYFpQ8v69lh05rAKts91hCYiJK/TK2EtZG/DTDO5SNkwgC1qlicix1\ncUOZpw/Hbwojmb3bQSH7i0HT/H22fU4wSovlnTWZn/msy+fpL4KC76s5PeSK\n18d6GtVBMumKbppSeZ5LBH+pMACiAHceAHRZGzAF+T7EoPeJ1qy7wr+1jDtF\nGoFsVDIb495tHszFyaYqKPkjRf+Cji8z6qEvJv5O5JAN/JD0WeS45n91fxMt\nONw6rgFnUxQk5rYeKwkqZ9QApih7kOBvexp4yosxvFyDsC7M+mi6YWjn5yHi\nl+Ra3cCc8Ayi+oGdLkiObrL9qSAEMdEu3JxQlXWTN5Ip0wn0dwRsEbvZqQER\nkzXfnrib2Y9LIFt7faUjofaD6gGqOXqAHIdZLk4xCZ1eGfiBXjIND5UKmjuh\naOdQJF2Ru8FbXEm8fYPKrxFW6jrWwomyASriwUhX2QdENBBBP/aek+ECajkb\nC1E8Co03yIt4/EoTIzYH7/GMIJv+kIie6tVN+vRG43HU0GR+Jhrz06yDU9ZH\nNwJNFXixCvWoBnLNg5EZBi6lI9YwEJfd+2JKZ4NgpyUtykTgx2d8iadUaLly\nu/8R\r\n=RJzk\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCu7zWk18E/kZHIrcystx9tMm8r9MGq/9eVG9IksgVKBAIgPBoXsBszPoIANwcxa5i/k48dXzRUFu9KFL5klxpCEcA="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.8.1_1644227246411_0.21581903454298224"},"_hasShrinkwrap":false},"0.9.0":{"name":"@flexn/graybox","version":"0.9.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"2bb1f329808fc449337580373a1e429c56357760","_id":"@flexn/graybox@0.9.0","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-UmN/WCoqb3BVEhzlmvN05MB6EKG05Zel45Myz0m8WzEfg+ouiXkG3GZIQrCKcc/JrKg/LjhnJbPzMwH89Ht7Rw==","shasum":"22e775fee541fa61ef5e514d025265d0c81dc936","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.0.tgz","fileCount":43,"unpackedSize":79626,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJiAh0iCRA9TVsSAnZWagAAZV4P/1Rjtl/EJ3R+jaDh547Y\n5dlP+aFciexrh8JwqtMTy3eJqJPhI6AsKk9zff8AE+U2Ke4oiiDZF6u1QnpR\ndd5avbBxsoa3fqIQH7UbewwBEBLAK84qqafRzpXvLfVJdpmZ0aZJjM7GalWX\nbFszW6sKakVQeMPJe3iHMqy1tqk22ASfr4rGIfyUgPoi9Ya1om9LxgAyhyh2\n3IenX5jssKyWDupfZYNESegOQiQTIW+kypovnLwJxbMk2+YXSs95XWmU5Fxa\nncqqLvJf1Guo5ayE78I73ZZbL95AykGOvg8XQKO2Fah4dXxNnqXlbOxTjLPD\npKjzn0qj9ynFvp76mZOTWnqBWA68tV6QSdKtsBCu7W076N2gNbKpNPYwMjko\nBFPtTOXfexl657ubL6YVTxBj3k4GkLWualDV9AlgUiKBJkvtXV8akVEZAajN\nkVIDH7rrOjcfw96wcytR4TTwUdS3evOUZKA+W/mwSPVvdj/Jt0pqDzrDLA2G\nAvnoNg79UqpOn5GIn87cdoVvhIVHzYnN9/f0fTDl6LRPyp0VUFTpzqpBdTYx\nwM6yPfpdbu0uSH5IghrQq85YYnl9pQf3KTCq+npVnTJGHBvlJ1ImvhQTddgB\nVbV9KcX3xIxXvUAtj3k8S3q5aMSGa0q06YDYC7OxFeaEtWTmIO+S4Pu28cew\nK8I8\r\n=Jauh\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIH172xy5OPLehVms2p2fyz5oO0V/uQRoGdFPfSg+mRgwAiEAqIiGD1mXdHJxbbgU+dkE8GywBLkoUZofD1G+aOF/JNY="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.0_1644305698205_0.29945663765705977"},"_hasShrinkwrap":false},"0.9.1-alpha.0":{"name":"@flexn/graybox","version":"0.9.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"8298851ea515fb27e6ccbd11eb8c04c07a0845d3","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.9.1-alpha.0","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-SGrIvKp6euvul5UY/qY6VadMm9VoHBXYpWMq4yMmX3FdYdEpkcVe3rO+eulaAXgnMqOBv5EZ++M3ox4oDu/ysA==","shasum":"20d2b1da4ec312a7785a9de05cceb8a8515edaa4","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.1-alpha.0.tgz","fileCount":43,"unpackedSize":79634,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJiBYHLCRA9TVsSAnZWagAA0o8P/2oxYIZuIU3U9zJAjdTx\nUOXuKwRMV53/dSCSWJ8btGOtCXMra7EEY0bQ1FJL4bfU9Bn4zovQd9zB4E9w\nEEuXrnvYJpa0kqLourG8KLyL0d7f5VgPMpIqbVj6t9/HajUtdF03qIGS0lGS\nngIoaYRMaGv8aQ4eaZsaHeAowRoS+0oGqSGGzU3CLWrUmtqRtUEuBKa24Io9\n+3yx/uHRtuLuTGUf0nLjemOajOJGYkGzuCMDlRT6Fs9bY8cWJ5dMHphx2dVY\nC51NswCb5VPq/VrVtyyi26EnAHFcfB6FszwShmgq4KXM521omA8oAPM1XQgV\n2k1rVtgOXyesLYLMNMld5aCujTOr3nXheliOAW/U5dT+VZApTxRGvbaf2KVD\n4obLLltgT+uEvkMfuYsyoPA2/K+VKpnAXjwDZ6+vl1i2RhGZq8FZDQGH1ed2\nwf2CDnFbSqxT4AZfghwwchDEAEmOe3fsfzvSkJ/r7xcb0ls+E+PlOMhET6If\ntIuVcpfGEeQGt4UUO3OlT5SefFlWepu1xXLqwCzI7dA2ilSyoj4R4Eftukou\nMl2PrG0cRawLf+/q3ssy9OHpEKR4Jf1kTPYrYPKSo9jp1dSN2EJj3yY31f2V\nBhLpvupUHUou0RuRLIS8AJP5RyIG8R53n+C2Qw6y7Lp8fOJBW6emSQuq8gxr\nK+PX\r\n=7N1N\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBT5opJlVnszQPib/mPMv0bFg6hSSf4QE88MyR0c/MTIAiAVG0iXrWCojKwBjqrcX7ffkSh95qruhTNeqP7VkHHC4A=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.1-alpha.0_1644528075731_0.15847531332360365"},"_hasShrinkwrap":false},"0.9.1-alpha.1":{"name":"@flexn/graybox","version":"0.9.1-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"7490cdc652ee88cd2e8925dff2c61199dd51edfb","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n ...(process.env.SCHEME === 'prod' && {\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n }),\n ...(process.env.SCHEME === 'alpha' && {\n appPackage: 'my.appPackage.alpha',\n appActivity: 'my.appActivity.alpha',\n }),\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n ...(process.env.SCHEME === 'prod' && { bundleId: 'my.bundleId' }),\n ...(process.env.SCHEME === 'alpha' && { bundleId: 'my.bundleId.alpha' }),\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Run the application on simulators you specified previously in wdio.capabilities.js\n7. Run test command in testable project's root folder. `` must be replaced with either `prod` or `alpha`\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios-`\n2. tvos: `yarn e2e:tvos-`\n3. android: `yarn e2e:android-`\n4. androidtv: `yarn e2e:androidtv-`\n5. macos: `yarn e2e:macos-`\n6. web: `yarn e2e:web-`\n7. all above: `yarn e2e:all-`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.9.1-alpha.1","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-ZjvPFQ87cGOVsB44WJzr24paanz9tEFajvZlj7q9iBLpnzb43bCc9UJB+ZYQ0fX4kIA8HyJUDq3Y9JYXV3l0lg==","shasum":"9fbac0b018e2e397a0f83b42333362efd9cbc110","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.9.1-alpha.1.tgz","fileCount":43,"unpackedSize":79634,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJiBh8GCRA9TVsSAnZWagAAQZ4P/jHibjgyDV7Ml7eo4DEg\nZVzcQYZKUf47tVsiEoBqyV+1jSNyVqSg60rDEAKkFjgrPdipI93l8io646MD\nHukTY/857sOShdyRyGxrkNjK1qnIPQ/TtqkZOK3ZkYRAtVTMrwRJyTKN+dn1\nESJowaRQG4OCCPmQD4J3SmbZ7KMNQDO5X2VNygyKRW6F+pHm+8B86YjhjTFM\nAtFQc9XYMpXmsDciwhiUfwVqMZUAJ2/Ao43nS/+C7px2kKDVGS+5+gu+XuVa\nw8bRgXMSA25OhxHG3XqSk9WuLkIUNJOkeYOuSKB6BAUUAC16Frn5moGKX2PJ\n8TdHPVEIgyETH+hURBrKCnUM+s7jHWDPhbYBkImXnUiaODh4j+J4tEV8J8XI\nH6rYbz1Nv151SstbplbcbVa9I47a6tNLfJvloLzVKOP0KnIBvpRvDLEq7qyt\nWGDT/+VF6QTvcoYmEJVwMVlNU3fkgLV0Y+6QME5dnJmtdCNuuq0G8bzYdicu\nPavjg/2cq7SrWKmQEBxx5AEVdl8OTe6pPlN+9w0yCm/aRDlZxVOSRgoxztVt\n4ORMkY1gwpVyVXGWJH3F0b04izWpzQQsL63jxgMYhCsf1XuOsOaZ/yh9j6gs\nhWPTdk3bQyaZOv5il/pdA94NYcxUSnkurNxD3NJy+vXgunpDpyu6Zp9sWiDD\n1WW7\r\n=wS5+\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICTkewVL6qWAgIgsUejaWzUvJGas59fuxRwqL0blRMieAiBRO4N1JXB2SkOMg5XJLLfa/fYFwHNanrIxTeOE6R5Tzg=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.9.1-alpha.1_1644568325998_0.9512535141412239"},"_hasShrinkwrap":false},"0.10.0":{"name":"@flexn/graybox","version":"0.10.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"073231e232a4b9d036f9d7fc3efe643bd10af2cf","_id":"@flexn/graybox@0.10.0","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-gAUdw+wk3Px3j/YuJQcldSQVWWqzKHq0WEi7/5JX0QgPoOw3gSKEhhKNo8HoLLkGjSoXPcLfVT4TqDkLKfWfSA==","shasum":"3b5b827acf4b7dddab1f2470abc752b57878b1ab","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.10.0.tgz","fileCount":43,"unpackedSize":78739,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJiCVOPCRA9TVsSAnZWagAAIPYP/jJQdSNfomQjpJm3ziGZ\nEXbR25qHyPJRDHcyXIsbPt+MgeRBtISzzv29l4jL3pO0Vn3eHtqt7ljL4Fed\nElC16VU5S12eXo1Sjf/Kpo/qgoY0tqdrtkOoCCfdV2w+tWOrEO9Lxs5GZb93\nGne3yreabWSG95R/Q+Vssq6K2ryoXOWSswic+jZ5go+k6cUSFckVlNvAIaXL\nYEt54geACr2rrsv1G4Neeofkf4cpdVxJGeNeUpmowKzgWHP2oBvUwJJelvqR\nJJnfSseAjPXjbiz7qIPeemAnsDg9JRpeMVgAcKsnJWuB2O+F6tnkgWNWtpGe\nVw5aUYMQ8tEQxqA+VF46L5N9g406R7I+wpQeSwkV5GldKvwQHUvifiYi6O6o\nrljCfBvo4Q1rOy8Jn9P5Jjsmy5nfl8Z11FjL5mzo3W5Ya9L3tMbkmlW2HIQR\niLTjaCqN05OZVwrRzAivR1ORpSTFxMjg2R2lnm4HG6JrUKnCmOGo0x22eB4V\nhn8hgMRw/CAifHj0f1n07Q9tsozWrXryyNh+Qe/4K8xkfm/rZhLBZ9c3cuze\nOC41vKnmWnPiU/O1CRdtiVRnD5Mirv4kIui4vtT+1vgiCMY0P+o/RJBfb9ts\nWccL8eQ5hAYdYQcXl81owBUYV0q+ZK9Rg5oLjER+QvqgjPKqZMZtKFi1INfx\nKMxf\r\n=nS2x\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCHwSymKQjHKnJnyLigONp2Yu3oSjqS62S2BUKbIY/rfcCIQDShYQ+Go3n4Ek6zmuN4DJ20z+1hTGawLlyjgNTAIicpQ=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.10.0_1644778383676_0.23416944067641654"},"_hasShrinkwrap":false},"0.10.1-alpha.0":{"name":"@flexn/graybox","version":"0.10.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"a7eae2a63ea9b90141eec7ff503b77886f9e1bde","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.10.1-alpha.0","_nodeVersion":"14.17.0","_npmVersion":"lerna/4.0.0/node@v14.17.0+x64 (darwin)","dist":{"integrity":"sha512-9tm4Ti3etjHoU4SDhDPUtibCj89Jm/D4+0Nj87QRnQXvA7Nbf65LIZf4tCbs/xqBPTMyalF4UkSvow+2VwzzXw==","shasum":"865818398e61c22e1f0ef7da5eaaef9efb998502","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.10.1-alpha.0.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJiCnaRCRA9TVsSAnZWagAAYgMP/18IteXoeg/ZNZqFnxWK\nhbgz0LMye2WSQwSDHlLDG5ak5y+Ff6O1H/4+r1JFfviraEN3coxHUZ89VwAT\neXz6HwHKKSGo+yp3d5Ic9XMWQDrZSc1LDOmAd52sSs+Hn3b/xRxeTdIFVDoU\nbc/5xmzG05p2HgTEDAmq+6qpGB3ZQ/PM7h86PHjTEgKHA+uzYWbufIXv7qba\n+75xoZTcKMBXAWP8oIAeQNPKe//XhSBor0kz8lCDtlkWd0huthNiayuVetcR\nHFNGpZw5jBhCHyjjb2GTp87dcuybPLB64iBYuSCkXmY5g32Na5DTTPuv1sXG\n0ff9Yrzsi7wHU86RVeF/gUYo4HrTVhhhSarAWo+KED7yoGOqbe2zF6DlnfDP\njyO8jtkvUNOI5sHzZmNnwxXaxRJjXYeujgk0EPzs5TP4clV4jY9H34AnCJxS\nTEeqFXLI2pKzebe21tXbdrq1MqsfNUQ6nvTClhBfP8jsrIk86YW8hfYY+rwP\nZOt5km7lxoXiAEA1pcfgXX628Ibi0u2cxU5/CKhHFg8VKlx9nocXzg7r3Zmk\n+Dd8UBGHfW7QyjVu6RndWvzfbvbYXiMOfSv/leaTjEk8U/kZGenvO3MX7S1p\nJRGpoFUKUaMzym73R/uVLfWd1jTsRayDnjXinVApHeQbn7yFNj8fz9Z6gmeq\nXIlf\r\n=XS03\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCLxo78DXuepUeCLNPDFUxejwZJOaXhoPv8rTmbqqiCegIhAI4qVynZSXn2BRuOECo3Ey4EuvCGDUP60fFHHsEvLjc6"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.10.1-alpha.0_1644852881167_0.009804421875616143"},"_hasShrinkwrap":false},"0.10.1-alpha.1":{"name":"@flexn/graybox","version":"0.10.1-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"6a263e5862ce7ac498abf23155c82e5d38837d92","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.10.1-alpha.1","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-LcFFjut40Rf301sozKaMLQzcWjDCtiYT5kBJlwPqr0o1Xtoa3OD+U/dU7kTi3uXLixUEHhYqjAGAVwWCxt47fQ==","shasum":"c183089afc39392bdecb8a98d0b8ba66dee6071b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.10.1-alpha.1.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJiDVBzCRA9TVsSAnZWagAAaloP/3wA5yFjWJ5JzJz46rKi\nRSknIb+jlORpl9MMzsoPdmKOlvdZwBH/7OKDbq16Xm3Wm68XXC7uWAosDHp8\nzMgyqR8dFyRHC0BaXSl0r598EMIHm4eaevMN78xeWwSnNBb+ROKPwhCta9iX\nHmJHzPjfhMBJSeRBV/vCeb2/AWegMsu09V5HCAUR20tyQbVRTNDyBuYvsJjm\nK9aNJFKqYBrioPppRytyrSDLYz6cORmW1uuGOC2rE1pMNiDqaCPVmuIrxb6Q\niDB0qBi18SnCj+5NPHNKbadYj43fJb+wnge0ixMN+VPPunbP1XH1s3Gm4V4F\ntFVsM8HXoKdAzkWIFd6AN++0qqTZ4bQynDvLNkjqN9J3pCRJnHJnf54KHXvw\nV9S+s1qpO7mgV/Ki4HdNsDgUdZ/15UTE6LQHUG8ZqWo+8ozlab4vTABcCXc4\nkuGSm2AP23uqAoHIyoJtBi7UEiZ2kgQ9ymzoNwK3/Hg9fbu85/eTm5WRYbZ+\nahuoYQlO+2tvDQsP/LRh7KYrJ5Zt7Mu7oo2RCLXzac5YJcwchiYZyizkXOF9\nrPgAY3nm3mCd23S4KeUzbcyYEXsFQyFPlQX+hYfcPTvvRh+2DSf1oyY6f8f0\ncApYu2LteZhGcwO0GnbQr980mdADgbu/Fnjz+3eRxSP3jWUQtJqF+EXoweVS\nRkly\r\n=dQpS\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHloQiLlBYkz0X1/POuAl7zdIrIG5ibjHIukKLOxmZrLAiEA6yBdJAYxq5+501goRQeWv6UAMMKt6RIhVHWZHg41H28="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.10.1-alpha.1_1645039731167_0.7187941368708215"},"_hasShrinkwrap":false},"0.10.1-alpha.2":{"name":"@flexn/graybox","version":"0.10.1-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"9fdbd2de71125df5e2e25cd3c05f0fd784e722c3","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.10.1-alpha.2","_nodeVersion":"14.17.0","_npmVersion":"lerna/4.0.0/node@v14.17.0+x64 (darwin)","dist":{"integrity":"sha512-yBY3pER0mrGcH4pEMxNaZsEY7iYEiPA3CUpmmvVDLsmXPzWbVoO2wJi5k482Bguqs9FLxK9YlroPXcvhb4fotQ==","shasum":"8c24dcb44008ed3b6b6bafa97f559075d547293b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.10.1-alpha.2.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiDfHDACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpQfg//TAEQXn3hn0YKu6HDeHjyXpQPzNWaK1tSaraSYA01xn6Nnsxq\r\nm/zorRhJUDWXbuS784Et5hCKb1Dl0E6KltertwIWDYxBr+x5s3VHWRbfiENO\r\n8Dj430bhdp7EzVeyjeP4VnwPISOADYc2Og5dUq6sbjJbnc2OYIfAEb9AyVYE\r\nqxBThNLEvbEaU44UyEi2+WDKQCvMo9rA/tdJyvebZhMizpe8FuKhu58dfs9M\r\no6kPxoluSBbrr57nVfNYcrLOCBTyHvc8zTqh6J41kK4D//FV0k/aB4/BaXo1\r\nXSu3cAu72AziGPlBKE3TUlcTy3kH80/GSaJjUMMg+sFIDtJTg98va4qEELXG\r\n7TTbUHYstjILZA5HRmB0pZx6MikGiVMmSB/znmeTbekKC/mqg9olHpKLJpQ0\r\ndVtE72b+3wo30IzSvNTqac2XeYYx5mqXecDPGxCxVkmZJgBq37PBKGg5pqJb\r\nQHhPjOuUaBel4yOAdHc0JY7jLomVCCYBIut+B6RG8QAY4SVvrYzAbxRy368T\r\nAbeozj1MqlP/kOfWje/fPZBbBN1RpjEVur6C2a7X6A2XMYhkFJbzqeLgVReT\r\n8n/4rzMgiIxuL3Y4W+JYeB5GVCve69Rk2AWRC5ZcQ+9z3bxWPJa3w7T87bo8\r\n7ptbpYrXVTy7BQT/NjUJqfkhdQNIf+SlMYU=\r\n=5BEa\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCyMzfK1YkEnLIxhxqMQTMdoAKOYv5GSCCijovfqZuMjQIgHGQ3G4XcA6GD8PyZdEr1mw4zyf16bQ20lqo9vpLkJAM="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.10.1-alpha.2_1645081027230_0.9838179929510138"},"_hasShrinkwrap":false},"0.10.1-alpha.3":{"name":"@flexn/graybox","version":"0.10.1-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"7b86a3c72dfae56dc336db84e1f8ab65ecbd0c85","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.10.1-alpha.3","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-tDTQlNVeQDnlmxOqbjWn28q9yDtw5INW6LC1VStnRf6AWcOmo2rN7IeOZCTlXuyMLq4kLP6lqLUavFhIJLUpSg==","shasum":"a2e0658ab6e3ff1638d1e9256d59bc5d64bee643","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.10.1-alpha.3.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiDgYtACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpEaQ/9GjK1E6qq2PvzZxLAM7sk4viWV+LyBzGbwG+n5zR9QZW685iZ\r\n7DUz6/WY6Iref8P4TsZcwaPI3ofn02fCpSz1Zs1nhM1WnYRiddntVbCJPWGj\r\nTwmPYC4mJKzNIipS1d2E+uT++i3gYaQ9ueaDR3ODe0XnW0j4kxRp6cWfz4yR\r\n9Vw/sZ71hlslU/rBb68pIy6zSMmmMzLa906SBcrwNPUYESVaNAhDh0bFCT0+\r\nRRYlNZqLQJnTby+0mO1gwXo+jmsCEOQUcfBWiMJLpniST8XkvEdHB0zunT2u\r\njj1NjIoEppBiUdGO+wpmm0J5hWhd3cieHHAz7/RbJmVLeNoS+J7Ztfwqb+fB\r\nV51cgCFJUZA9HPTfRK7XVmYjJBG5AyP8NgLOL0+EaZfVqlLo0dHKb4OM7aA7\r\nZhIfr7dJh9ua3E2PDxVnpeLepM4x1vOArfC0UAc3L2atvkz6kxg6gURcygT2\r\n4NlhuS5MoQ7GMbUdHOZz569a3eILHEDeXQivlnFjRMyEI+a/bKvTX58YM61o\r\nNKR09N3GI6FAehleAgWwip3wFKMnaQLSMmaWsYzwUH4Nyy0MZ+SNz395CLAZ\r\nb88/s1kWI7fr3qmB6+Z/8ksfkqgThjYaBthbYFqgxad/aUc5dApLZvqHLuLO\r\nkMTr7S0H+Wa6Jp8EzvUlqmm1ziZoruF+ZCc=\r\n=9pH7\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCzmKbuzymLIXeLACHIiYK/yo0iN0eGhq7C1kd73eovxwIhAM7GR5B7DkWaBqQljsnEVGE998BVn6CKRC592pM6DaGg"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.10.1-alpha.3_1645086252215_0.4960604152515524"},"_hasShrinkwrap":false},"0.10.1-alpha.4":{"name":"@flexn/graybox","version":"0.10.1-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"dc2bf2131f5441dfc87bc09292ab8f10475ca9f7","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.10.1-alpha.4","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-Zw8gaGte2tDk18mTSCIvvwj7HY8br2oVRXYR/2EM2j0hAkrwq1+6tNc0a/GsBALpwJun0GqjwJHP6km/hcegOg==","shasum":"5d1c6c89c645f7125d6a011e51044bafd9a744d9","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.10.1-alpha.4.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiDqxvACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmq2fw//StaQjM3rPOGVJ8i8aQSIoZctyHUNAl0i+8Y/9TwwOR7AuVnX\r\n7nFNB8ml9bQccXI/ORibseHYR+4pEZXOG8wd86BxLv9LQ9BzFcqLC5xjefzG\r\ngw3l3jzBI2lEYCI9HbxRM7eZEHISDjR4Ihpi62pCzyN+gCFG1T1d+OOM4L0o\r\n+y8Ez3hQPnd/SYizEpezqE6gfjP019pibq2vvavEk6QejYmfbepTIW19NlAe\r\n1CD5NhLqFN2sJ1teQLcCLGM/g607UVZHoLNpc1JsNfRz+dz5aIpd/6M6raYr\r\nzapstD3Ibl/J9h7bryrfi0csBxyJmp3dsq2MlhEdq25Nv1vOukoWGBYAhiPR\r\nYMWBQbSFnM4YvLqfHL9E8uKxR9LGarmBtc+Did6zUoVCHpp6JVFYDO6wA9E/\r\nZXEiLW1J8OC0R+b91dG/AUGjeJ1QDz4FM2BbyB2z9wagrnUxLxPTZYtOTlyt\r\nawm6OcK263FoZjIoEDIR7zWF+51w8bl4UUs58e2Uhk1ehfXWRMHra0gEkTzE\r\nfGviEZEgsXbiG08zcGfRii7C5Depw9urmurx6hzmPCbhe7TBlPV/P1CLTt3n\r\n/MwFGGXHKrkheBaer9G29rdCYnGYUk55xWhlH7GHCiZ2ib/fvRWdYQDG7tIT\r\ntTueKb2kKDDObiKr/3ItlXk47dTBNjYMcL4=\r\n=rW5X\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDSPV6UZcHy4AxJ/jIHJerrCcdPJ+I4RnJnZ3hF7T/6VgIhALrFhw8/cD+hLE2UXTBU6Bg5J+YzoAnZK2LX+29afp7K"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.10.1-alpha.4_1645128815635_0.13941256076833275"},"_hasShrinkwrap":false},"0.11.0":{"name":"@flexn/graybox","version":"0.11.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"4a6c14ec45fb0959bb8966cdc1f395c4fe048dbb","_id":"@flexn/graybox@0.11.0","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-xs+UdN7l20WTxiX36mMqnHRnp4PoMTf95OiBWfFtt2Iir6RPDliQShVlK0pO0uAheEnLI5T8YKRCKeE15O3D4w==","shasum":"e532f064f5ac6a260932ea8d114157b94860d9f9","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.11.0.tgz","fileCount":43,"unpackedSize":78739,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiD6P0ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpAGxAAlWbDxFaU+YopwOKjq8XZh0q8pe8Ywr2PBtWqpBeJ4x+9r2Sb\r\ng0wDpPGe8qEi4NmMoCDgcvamJDtnaOFMLadUX7AOFZCpHY2kAADOI0y4G8JA\r\n3VDevsdixgcqCvD5HOoFnsid+JIeVKyGDB9Oy9h/zZqJ+fZMYVR0c7QXxovh\r\n8YUXRfz8bxQL+FzhJWRpKXFzF8TvXysJq5zOqojizQ94iugSlys6URiY6oJZ\r\nzGr2WvehlakVjPk/AqjS+o7J2sg1I3u/BziN+fA6uKLCB2bv49HvwBFUqnlo\r\nS97MhXNQnsRXL8pSwBMgAP/Lq/xMayeCcMKIbUF1dgj5ZuH0iZmWeTqfS/JU\r\nuRuQgkeM8jQViaef5GBowcfY9YPq54T9Un3nMCf0l17CKDCQc0FpAkQOjdj4\r\nJ1u272LkBKl0Vta8izezU5DpOxzdtur1b9kuo6RyHxTW7sa/30r6LZZuN6HM\r\npZzu/qBAaQekh3mTUJyUm0VpR56Kz0PEmvAAqoa+fET0BWQfPFaBzY6qbuL8\r\nzuyUP7bQRqc6NrbIkOZF1C0Bf6ZzlRCjx4XB8U40f7pZhliuxM9bOZzBkWim\r\nD0zVtXqPq9qL9p5Rw7TbGkO8w7BXVSttHpB0IU7jIC1ewIY+19znPI5uy5k6\r\ndswk7MQCNNJDjWG3vhJUYO2vjO0RGVPnTJ4=\r\n=d5Ku\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD5y1hvBsgtty67h/SwM3DxQ5T7aLvsuVxdJERJoqHMHgIhALPyZyFIlcq4+rfi4Y79ywhr8TiPj1HUqwGPWoxGyaLx"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.11.0_1645192180115_0.7965744437038935"},"_hasShrinkwrap":false},"0.11.1-alpha.0":{"name":"@flexn/graybox","version":"0.11.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"e9e645e36472e4059beaefd0df6ecde471becb9a","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.11.1-alpha.0","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-nK0dnmbaSa6wNRUTKS/h1C8Ar6V1nz30KuhsmHdAcK+mPq5dHzHC+NVql1H+r+koRu6FJogwNcHgdl7YGZC+cA==","shasum":"8834de6f500976bbd48e82c59b834af7ff7a48b1","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.11.1-alpha.0.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiFStQACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmo4ow/+NAQiPc5gqLLKI5A2OUP7hCSQLN44nVZC/FU8uGrHqOK1CvOf\r\nSRuzLtXYGKjCzbPXKdx6DYikfvBCWVu9lydLazJ2JCs3zrod/3WsOdOfxBZZ\r\nbjUOGYeborttCdW43q7SgJEAGVO7sV+NOILG9nQZMr2jxcW9qiKbvOeBnntz\r\nnDzw1NBqXHd4bulrBmWTmI3+7cKAHMoJ8SXmWSUOHaK2uTMfVGrOykiOobdg\r\nyBdTnzdT/4CJ8vbOjnWU+EzD/OZKSHAH6P02/gHJKHA07T+qCSP5L7EUHBmo\r\neen7mn+9OXmr2QHY/6qRKkY19PF+7GgvQn/QaZ9VQAsdIf6TDpFTj4cdlW+3\r\nSHbTyo+L3FqnfKQtMPLCTSkr1kZaYws1HJNunmGWDg88mqdbXv4n4sn4LZZn\r\nxKXHJGNjJgCL2/clpqxz5nnPYqxTNzydyOS2RKojdzc90vJ+3hqeaybRda3l\r\niZSvOekCG/XBFiLlPdvk0iwXr1x000J5pArQ1i2dKq1xnaU7QQ+M3cZYOThO\r\n6y5P2JA1UT7vuDRsl1ezY/k1qQw4ZWRtCNGDryphUGSzsnx9kPGUqITNUV1G\r\nPpT6nYXUNBO6DyqphcuMhDxmfT7IybaKcWJ2aoYePEectpe34WYOnsxI5Npr\r\njJJZoZWo1mW2+85k6PK+XqXOD4RFuFU1uls=\r\n=d7/q\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD+swLJ6S4L44vPHAJ4mqVvDbexoHyTA1dwCk1STyPwoAIhANY60hx8zLAfzRvu6xxVsHdigHscQu8gyZHoykaIdMPQ"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.11.1-alpha.0_1645554512225_0.09912292095741115"},"_hasShrinkwrap":false},"0.11.1-alpha.1":{"name":"@flexn/graybox","version":"0.11.1-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"6cff1c67671c3e6c289887f3ab0a5910477d79cb","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.11.1-alpha.1","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-wKDqfc6uCd5trq3CVUHPNwzZCJ0TKazKv85aUddcMHJ1ftJkCYinWkOwKNr7JcQsVtOogBxPY04qG4m7/rhSJQ==","shasum":"b563c8478dfd80ec21300e6cc53d268a949e8808","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.11.1-alpha.1.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiGmrqACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqFaw//W5VzysAVI6ChxyeOdawWhW2pxs3P4NMvdnUkTGdzp+4YlmyR\r\ncsbd3VAyhmAUMs3hHKv8Gs11LmM6nPW9B7EBBI4Zv4PAO7X1k85JxVn+iQdo\r\nJ8zY9s+l9sy6xuZRu60MWqZjTvLA4fMljvU/VqtsPSR+BoMPfZB4oR5wFqf5\r\nKPUL6MpwSIf4Ot70GL1gXlSMAfKrpVl7vW6vuzwS822I9pW2N3igeQ4l6z9w\r\nq0kguFB31T8iEq7709R4SsK9/My1901yc8txnhTCvl8MfrtTWa/LrNV2gXkm\r\ndJJ62MYy7HyloQPEW1TIrwXorAIx/wluPgRSGrAX1vUrMo3vzJjkgBx49BxU\r\n+npEkDeMTSsgTCFbru5jJQfHolg2gi4mht6qxC+LS8+mEN5W1g6sJ6kJBBPw\r\nrVzSYC5CtymxdGMoo1/P82jfLya9mCBgWi10K0IplJEUhkmP71yyigkhLUwX\r\n25m81+OZo+18VKj6PcdEpIw4BXMYySnNv/WWu/0IlIP7PRM/UaJ3pz+hmcRe\r\n5tNOAsRr5iiGT4XzIiy6H6BuUg5di780mkf5snjPNrPo29bdP4KxHgL2YMch\r\nBxUVgij6ANDK47esIJddkLxanBcFI9dT9iy5EFw2lz/8bFmtbLB+8Zo4ETWq\r\nsmLGm5ukEFY4MlYmso5QdFXtk7M9D6e8VcQ=\r\n=R2+O\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCm3aYnmphl0rp3jQxJAjZUBzErjrPujuwxP38028mO9QIgREyljpCFOrfbclwcMdTzjdNFaIIVdPhn5KHhHdCF+ic="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.11.1-alpha.1_1645898474095_0.5666676595028595"},"_hasShrinkwrap":false},"0.12.0":{"name":"@flexn/graybox","version":"0.12.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"7c9c7f29f1c6f86902c3fb429eba6d701d704c7b","_id":"@flexn/graybox@0.12.0","_nodeVersion":"16.12.0","_npmVersion":"lerna/4.0.0/node@v16.12.0+x64 (darwin)","dist":{"integrity":"sha512-QM4l4ziY61l7HtpPleKWBQ3nqJh5ABVja7X9DuIK/KfiGVqn31+Cj+YfqpJE4TQTtfjZxFqZtDGKhINTexA3PA==","shasum":"fd8565b61b8400e0da5f1cfe1bb6176a4dc2e73d","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.12.0.tgz","fileCount":43,"unpackedSize":78739,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiIhkcACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrNZQ//W/Fx36f/eFxS2iVUwXvlrCiMAU3lO7vtBxmjWwFDQ+BGK9mE\r\nSsyXbh1Qqr08r2NA11SoRasJaG0pdzqBjySPogiv1S3RUORniQfX86MWcw+v\r\nOiTWFmkWIBUTIxjcls54sZlvTsV6X3F6iLPBYmWXi9eVLp06t9BWsQR7KGiE\r\naNlYn/wa/otF004pCaAEL3ZL5EtaC/2iHD4Pj7pTXfZPBh7E8hWSPx38cSmM\r\nrHvekaUtLYFcvhVJQMfwVej6nU64Mr297V3Fk1D6dBOJbF+8Ymzaf8X9+x0d\r\nk5ky0qVn4wVouLBA9NbXYp9vOYW47qFvMyn4/vxDuP5BtlzmYcQ+Dk0rdAwf\r\n1DHCLIBA4MSUZVXh6kdThwLQG0qOQXepvZwE/jx3fzOmuvh/dqc/xRiNK20I\r\nHeYgfSAsR8J5Hk6uxBJtyzBgHDR4lreUUvRBtVu4qVT/4bAUfCA7Evhcx9lz\r\nzxobDk7qfzpLCxm7FYeBUqVmI2SYCyV1qtmHe6vQKASrUTPSGF7JpAAg8TYn\r\naFGoMT5LzWwQDp2vEMB7xpmB7yv4DJK6DZBneMhKqC/Sx/hRZZNipl9FXFcB\r\n791gPkH1JsoGN+Ug5TyEb86S8hYovoEWFTmhJuejDyfhTYF98PJtqUwhTMm9\r\nQMfHhcp752VzN55cFgRPkVOd8BmGQo1d7/o=\r\n=lWrQ\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCEeY/EXB3uIRQnHdfJPU0WK1znNbn/khGCNhdxY+efhQIgAr6vaFKjDASGjs9FXGT1OmIERe3+EO3YbaGi9pkHxYc="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.12.0_1646401820133_0.35907339741127475"},"_hasShrinkwrap":false},"0.12.1-feat-visible-id.1":{"name":"@flexn/graybox","version":"0.12.1-feat-visible-id.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","gitHead":"6f98d2f34edaf35fddee56d9a4b7a82f2b88d097","_id":"@flexn/graybox@0.12.1-feat-visible-id.1","_nodeVersion":"16.12.0","_npmVersion":"8.1.0","dist":{"integrity":"sha512-vEKE4KMKZwnGj2An3JRuC1CS8tjvtgIKlrh+ae5ak2jIqcrFj0ya5O0Pzcoe1Cbv3OxgYTDHgPFcsrQdoDbjmg==","shasum":"56b6c5cf4584f84fffe6c7ca895bd3fb71125daa","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.12.1-feat-visible-id.1.tgz","fileCount":43,"unpackedSize":85268,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiKfCYACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoFQQ/+P0H5UNp4oU6STPDboAKfjRr9nryxeWJqiFzFD5upVrnaScuM\r\nzQFJFrIa2jBUpgybyYtEhhU7VvEJ0qVPhe0/EtX4adphhnu2Sil7YG72qL9y\r\njpUH1xbP3CmJOZR/btCAYHdsFSTRuvUCNGEMtK/hBtoRGHa9Qwqk2nKbA419\r\nQ6yQKCA84GthJ9PZolj6GfSXVLDcn7VsC+7/9goMmnkCzeumVtpaj2kQtglO\r\nm6XSrWESNXrVZnZGCHbiDffiyhP8np3DBSy/pIW8JV1i6KPeEU8nZS4ynezY\r\nzD2JBjaWux1QMGGf48s6bjfBFAtn744UnnFf+xdqnQGG0FIZCZSUcP8DCWjI\r\nTwrp88edLg9fcNxcZGixC8b+2Jg83KK9m3y7hjyVpgR5Erp1P0bfMwvGZm3L\r\nXEa4bY6+GPMg9NTVMCP0WM8AUGHYLsAQmyLKhSmsW/wo79SABQ3uBAYmfSPf\r\nR2Z0s45eEooO2/VQ8qH07Vxua+L1cxfxBJp6ldtu9We/HolpWJkQs7ddCs/0\r\nruo5Tw5B6Yierwcg8nPH1Iccjx+m0JRmBd+8IivC2Dp6DL2344g9mkpv/3a5\r\n3x3k6SltBMq8f4LtZQ79A4nb162VSAjFe79/1e8bEJPZ0+P2bb2Vk3R9VO1m\r\nrg/a8i/HR9uChbGpCSJnRauyWuwgSXY8G4s=\r\n=il7M\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD0u+51YrEyUW5vo9IgHOZQVcvMGVoZP2VUcfrWqw1CFwIhANu9YLG2q5YICrBERfFkJuIUIoE0sSjwcvP9lBT+eGwZ"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.12.1-feat-visible-id.1_1646915735950_0.9180464332406366"},"_hasShrinkwrap":false},"0.12.1-alpha.0":{"name":"@flexn/graybox","version":"0.12.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"d96696595b85691b9e585403fc60171fef8e959a","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.12.1-alpha.0","_nodeVersion":"14.17.1","_npmVersion":"lerna/4.0.0/node@v14.17.1+x64 (darwin)","dist":{"integrity":"sha512-237b3qFML/ZbTDzEdM//shaPkSTxWN258haALpoUmVtOPQnfqOnY1d/MbSG9zUS2vZT9BuSHyIAht3PXSdFQ6Q==","shasum":"4f5e0aff1062902bef9fecc57cc078bf14236894","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.12.1-alpha.0.tgz","fileCount":43,"unpackedSize":85283,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiNEFxACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmq0TRAAhzmXMjlunkOKWF1RO/F4j7KXFmVfyFs7qMaSnn7rSxGILTRp\r\nbryRkZr1+0xUS3RTawRc8qoNUtUNdfk1AdeEhyjcEn4GCci1UZLKxNmSghdT\r\n9fiS/cP7OFYMFT0lrfDyHSSqTB870hxZvCmK/+ZLwXRV63J4+dpQGNT1a8NR\r\n2kgGHoRNGGQKE42pz237Fyd/srbQcsy2tbgK+pJPI45HpdWena7mkLgHaKq2\r\nRZuT08Eyxl/WT69l6MYmMkkoMtwd35cuEeA3q+j21ZjBQBCjTK7x3q9Asi8Y\r\nQBmsHwHfj2DnNegXTIiMJygfJOEZca2ZOlgzlKgyMoYYI9Uyx3yaOK+BPMjm\r\n5tCibroXpE7Z2SnPbHMUgzBz/Rqw84LV0eH2vS7Klz7ZMLxDhBejjw3DkdvO\r\n41vUshm92DXAL3Dz7KG50cY2otCvD3QZDincwnk7tBR+kWm8gGCsVpsn3aaW\r\nOpxYtCMEDiixjjSZiB9gV5wut3moKRwyUEjbn7VugdRfNStdcp+TSTXRZnxO\r\naYqH/UyO8ohDZdY0PYIh8mX3DssQDRCWDd5nrz3YlppyP2Rhhz1C3PloMU79\r\n3P8GRQ8R0dYpCYOqX+iITg6/mGGeyuUysusKB7eM7mSfhaqQspSzyGUbmwzT\r\nS1F3QgKE9NOdEpppVBWliojGyHEcluhIw7M=\r\n=JjSj\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD5q57yDDNHQnwiMU9T/k6PBliMNKEtdsXwVVrsC3338QIgQB7CtLV44ZJhtn60y4/54GWmA02RSflFmWC9mtKXSTQ="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.12.1-alpha.0_1647591793499_0.19773549680763347"},"_hasShrinkwrap":false},"0.13.0":{"name":"@flexn/graybox","version":"0.13.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"82499ee1ca1fd2a546eb68f07ead1fb2ce00e28b","_id":"@flexn/graybox@0.13.0","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-Qsh89Frg7Jv42DCneJ4EzyBncTnTU0YYv+65sNcguQK+B8J6/CJ+HcAYSVm/rifaTAKJMjdaTpy9Mz9aIMzMZA==","shasum":"644d0802bb70ed1a335dfc83dec2e38f2ed29f52","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.13.0.tgz","fileCount":43,"unpackedSize":78739,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiNu76ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmr5cg//Xl6VfCwop6lr5dON7NiOHy8ZW1UblCCaloWimx197qW3LXE4\r\nq/KyUOfwscLGAAkWFjdtFZUdSwknex8D+pW4Jfmc2BwBBVeIB/vCq2f8kM1m\r\naqZgf6ELXgAkYiZK1iRZPmx0SaFC7NMl16jIvIAvGUEUVbzEPZ+WWYrJ0SCk\r\nZwtRkr7jN+lQaTNKeW7xhCIVSw/GHNbiv5jkB//Md145MDFafYncbszi6Vni\r\nEKOcSvu/Z3FHmsnYPbjwzGRwyHirD+7fO84gaEqmfb2zrBqALCHhW0qEfH9d\r\nm2wAElyVM+gKKmEQsEZIJ0f+Mz4Bm4OeuYjegCeFb3IkZI1k2k332WhueWvE\r\nu0qWaLoOqfiLvEqKa/Y+1Rhf3BBUggWkyh11EUKZum2//7hpb4Z0yQ1lFISy\r\n8Y4EEbTJZxbZdkMFbQy4USVzrE6arYFaHsa9u1jOyLHj4NY0j03Rbg/poAD9\r\nRTCMRxdvOe2p2i9GnN8VaaxFkTOXHOkVvU7h7u0p76a+in9FQcCMoAuhF93r\r\nOnvRCOs6fd0dlwzxM/nAhZQUXxwn7H4OuOP6tu3WquKTi1ssjBI1YceNpdR0\r\nlYO1bGpI5VzGlhuHgGKFiPvjR+/HIpyEJMgV4gozBbYxkF+A18aI6K9KvS0Q\r\njWJhAxrwtYOXqEHIxvMcvCn7gSjwssLM32s=\r\n=NURl\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIC30ftclWqRByT1xLGMoUbeVPhgeoOSonbmFIezcjMs6AiEAgnefrq2mpbpdFVIotwEVfDWg9LK1+n1yme134X59HYM="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.13.0_1647767290029_0.6016950727894266"},"_hasShrinkwrap":false},"0.13.1-alpha.0":{"name":"@flexn/graybox","version":"0.13.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"b74f2ac8287360c7c527a238d28181f06a65e09b","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.13.1-alpha.0","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-j1dtiOA7Fmvw8OyhustcBGjk+3M3hV8p9EC47ES0MsAL7UiBs/+jk/AusgCzGb3SKVBQGwehtLEg7H/c0MJDnw==","shasum":"926a4f51049e9841809dbeb4cc1318676dcd93f1","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.13.1-alpha.0.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiNv8FACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmokow/+KmaHii+Nz5xOO/kocfo/mKrirsGCu/PCwRj72K2XyvtZFeit\r\npHknIPOph+lI2P6b+8dT96KeN7k7J5NvNpZb9z4SKxghzOiSmtVwyq1+rZ9u\r\nH3dWrRLbg8/IUlH6QUqfGzpU2Cs3jHOA6GIVUYAPWMQMkXyRNHaY+Kn5rl58\r\nhve8JotVhBEKCUG857JkD1zrMmf9rJBnP3Na58wDvj8VyxHEBZ8KoERxVVKM\r\nTpFoEHq3TBqE7tUmwZOSBR64/t2ihCg6W8KoPvERUYdczjDI+JbofVqpF/zh\r\nO4xcSZa4rFbxcOm/NolWv7v85mK9Z+uqv7RSorfWPzlgAdN8CVtA4f5YTA9D\r\n1dBfDpfrLdwngCA4cQVjpVrArCeBL9K9y4tPjJRY5txlOmX012kYN49ts+0x\r\nTrhQF0ACOM/uUXnLtOdejslg1t6Adfft5ywRUGbNu6xEE+Ws7eoEDHQzz9Z9\r\nVsNuwfU0OE9QYk9ZB+fWpM9nJWOUl6d9fQR31WvkW4mpLEaFGb8mlByPPbZT\r\n+OzV3ph3oQTkk+R9DZmnxBzygBF0qcMi0TRbDQr8OGEiNPkmnCe6qAYbHYWX\r\nouZCwj1RN1ZOsdCg8lhjocb2pC2BiL6mder290YAwgLzbdA1oxE4fWVctgSv\r\neZ52canTNywEJRLHGNoE+TqNM2XIP6cFqps=\r\n=z2rg\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDpaFdcsQeHGmYerC8JBpPFHR1nejgIdYLK0OAU7VF9wQIhAL1CipyBc2Bg2c/+itCrdBTXCBHTccan+oHXKykKB/qT"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.13.1-alpha.0_1647771397364_0.13163340346303576"},"_hasShrinkwrap":false},"0.13.1-alpha.1":{"name":"@flexn/graybox","version":"0.13.1-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"940ebd98ab582a1a86c2bc507faa7d5fade22c6a","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.13.1-alpha.1","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-awRoGOJdGfC/JxrD133gr8iNquC7T8oSYFXSkmaPqxQC36LdF6gl+C1NhATAFiTbEXznVRwkQfyO42Tjl+vXIw==","shasum":"9bd39a6fba622fdd10080d81dd1693906c05fb48","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.13.1-alpha.1.tgz","fileCount":43,"unpackedSize":78747,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiNwm7ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrCAg/+Ky7HhkffasL/tcKzNo4XhmUyhvPQStAX4CB+LCA4qNUXU0SE\r\nDSXKyJ7BAfqZ4oEWKNymmrPIXFOl6eFjfKHbpPIB9P8QiFstHaAnSebJi7YE\r\n9NVQgL+T8SawgglAhrTMOVqP0t+9aoOuEJUn9Kb7tdKf36FcumJeoY4f0Uz4\r\nvKzfYIYEDhTBjnMY0FOBVsMlqd8m97Z7a8/6bJNd6AkCUMdB2C5N1ieg9+UX\r\nZygjgyeoupY2qGx0Qb0Sj/p/JzBbsAWNq08xm5VRGQhcVabRGs6PArFfqv1f\r\ntZHzRx9zqYDuE2b24MdYU5jI6jbeJoi7ojQOU73fo3ZYkott1OOyHsZkElX5\r\nsueCmnrbBt0a6xZLXapqYvc3hfZNTrsQMH4locQYDGTH6zjwBoMS8C898XrN\r\nM8Sbg2FH39bwxcebtMgpX0hr1jXVRi8bFOK6VzwDOZZ7egYVDsO7KR3lilBf\r\n+5zJViFQ2wZPFVdJNn9mv0xwTMrqrjYUTXmHZBBHKN4hXo96GPHLMjs4T5oT\r\nRKEd2/sM6GNdbJFkqjzODngpwIBwABqePTjjVg/4dOnkM55CSmtinALV5kC4\r\nI1SNWTEoAcZRiYDgedHlHPwXHPLXiFBu0yETKl1bfhWGvpeo/RglMMUxI3Wa\r\ngwHQnJqi5qugii32sLOhnMGYjd9WlrTSzqo=\r\n=OS6j\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCdxV5eTiflm3ffSFbvwTVfrJMpLqEOhWyEcWXGk19CKgIgeeLilL/mO71OhcNO8n6t5Zi98dWZCKPabY7XAeCjnMw="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.13.1-alpha.1_1647774139167_0.23891571756587382"},"_hasShrinkwrap":false},"0.13.1":{"name":"@flexn/graybox","version":"0.13.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"^7.10.0","@wdio/appium-service":"^7.8.0","@wdio/cli":"^7.9.1","@wdio/local-runner":"^7.9.1","@wdio/mocha-framework":"^7.9.1","@wdio/selenium-standalone-service":"^7.10.1","@wdio/spec-reporter":"^7.9.0","allure-commandline":"^2.13.8","appium":"^1.21.0","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"05f357afc5d45292724433206493b6d1d48b52d4","_id":"@flexn/graybox@0.13.1","_nodeVersion":"16.13.2","_npmVersion":"lerna/4.0.0/node@v16.13.2+x64 (darwin)","dist":{"integrity":"sha512-SCrlozLLpEWjt9slN0GM/VeiGasCnwKJ2BzwHnmptRqzmNYj06KYYdvZuerDpEeMJ96iAN7TTTprKeooGy8yVg==","shasum":"66f6d43321a541850e5bfc7d5d407e617fcc715c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.13.1.tgz","fileCount":43,"unpackedSize":78739,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiNxHeACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmpzzw/7B4y4FB4M+reD+ElZH282GTqs5mdjdqxNxm7t0KBiU7sbBZIb\r\nOVHXDitFLi3zdUqur3QmGnyGbXYy5/g107LVLQu1Ft7uss0YlwdUNlsZGkW7\r\nWH4POphVYyJTUxTN+UGPwS8NLoj2V4mnsqiUK/RuY1hmXJBVDVk4+Jx/0SWv\r\nZoMsS+U3Aqa8CNYD5eduo802ADB0AWvm5wktivtrbzVzNBTn/IUjZQ3ouCBT\r\n+4BREtEPd9Eq0iudG8sn9hNiGYD4LYdWWIxbdf6BEQCn0RePirGLVTuaEH86\r\n+Tf+AMwbilgsbf5VaiwuNIML2QBA6MwWLAT8M2HUbroiVrOKErbEao6S1Zd/\r\nTuX02WETPmryZDBPCL2vo2GCStp+AbxRR3EM6RK/LVC31g7IKRZKlq0t9CJ2\r\nBWfx3tv+MtncfV1ezopPeBqtKWF5xX4XTaNrpMlE7VAZl4BUA4gHvE7yr0lh\r\n0qhsF5OySIUxrv2KCiIM8um7AD52Fi4T3RXyaC6zQeHm/wbfmseEu1ye4c0V\r\nrYWIP2xHPaQpAvcFavJmyLG3P3Cy2PmRHu1goUr2QASY4q/ilA+EUD+cA21A\r\nRHWV2GeeakHCvd2ltAfwpgbEmRhbILv7mzlmlIxPL0uAUMIH401IfYRCnUg3\r\nsTIl2kntYu8ZtHeXraUHpXNfYRTKsqVNRZk=\r\n=ECnh\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCp7aXyUgYgP2G2URevQnNhSCMM/4yjX/AvKq/YkonG9wIhANR2cwKNYlONxXxBcBO783WuhhCiURaWi9KFRtS7If1f"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.13.1_1647776222095_0.68811384656599"},"_hasShrinkwrap":false},"0.13.2-alpha.0":{"name":"@flexn/graybox","version":"0.13.2-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.13.2-alpha.0","_nodeVersion":"14.17.1","_npmVersion":"6.14.13","dist":{"integrity":"sha512-fVDBg4dpUG3YNzPfrgVBRZbi7Me4n0ofgVP8HJaN2syGx9KVwtLum76z0UglxRvfNDncrDPO/tJrfpR0YScpAQ==","shasum":"8840512fdf930e7dc131c02bbb0c205d4d0214f0","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.13.2-alpha.0.tgz","fileCount":43,"unpackedSize":85250,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCID89mOqtnfJrfCm2VLkrJT8h/DwGdJ4tOE6ZUThmkciFAiBEX657TTH5NnHve4JgBzauKlyk/acSe1rUg9tzhzY7bg=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJic8meACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmowIg/9HM1CzFlgmJUuVEtNU8VVk2UlXGp5DtpnICXx5sghipjI4WNx\r\nMLRSLLqaPeSxUoS/NvCCz1DBSEdp3kg28gsaWl+kOVtVLXfORiEGalSY7WEb\r\n0DMlMyzH0jGY4eEyt+togtKGHiYYsswtrIUbsaZLvWiyVb2qugnUSDXo/Y8v\r\nbBJP6yuubILigsDQWfq6xRl8mWlclPr3rg3LlTt4FxH+0aE8jky9gjsyvSHQ\r\nNn1318J9FVkgvovhkn35gh47UYjRFiHq4t6UUoUGH1X9EwcYEPkO6cwA2Uqb\r\nUsl9K6yseaikMNA/JhwDJ+Y3k1s+3tTA0ur2tEivacMyvSRkzNkq8bEpZCre\r\nmPfI+jF0PD6n9up1A9G3VLqL4iirPvBwH4yxYDtSoSQDBORMtXRok5QBMAPF\r\nJPm6Da7f4htirurGLPUAaKlaDMG+9SiSqGbi/eVjlZsOX3Zr4+WXDIDrRLL4\r\nySkvj9dP3STC6oPc1Z9y7tNmwbCxxMHEJPdvFQ9jWk0Wc6vJ6EIRSanBerO7\r\nim6QQHB15000Cdg0xpeYA2sekWPYUkaxTv945ZTphKNebzwJ8O3+ryjI8Lnl\r\n69GOxnwYKe5qtWUZV3GfRSwYOEMSafIXzVpzvctH/StVL6dqkzRUNyrXhb2v\r\nDPliHinodgIqTLmtQujoMv2/rEQ790y3VV0=\r\n=Hbg5\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.13.2-alpha.0_1651755421922_0.9929613898015732"},"_hasShrinkwrap":false},"0.13.2":{"name":"@flexn/graybox","version":"0.13.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"3c954a3bd4ad21649554e57c97b072fb122b5e8c","_id":"@flexn/graybox@0.13.2","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+arm64 (darwin)","dist":{"integrity":"sha512-fOqHpxa2RZR/nAFNSP2HogCf2tSPAXRm9u0hgC1VbBg/fI1ONvPuGO0C0ZgYreuhIAp2CL+ZmR5g1EUCMeM/Qw==","shasum":"c6f8ea8017b318e4c1f96cf5274b1d7df7b8c6a7","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.13.2.tgz","fileCount":43,"unpackedSize":85301,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCICJA0vjunRE8jkpTTlXlt+kzHR9bGyxMeGwNFL5mm3C6AiEAmqy/jifVlrGvF2cW7dw31mrfIPYdBB2ZacL3lcu66kU="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJifCBFACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp84Q/+MmVad0dFcvbTu/2qD/ROS95W6suR8ee+m4Lw0s6UXhAH68Zo\r\nApLaZWuBqMJLSDrAR4PjtBzsfIrwyXLit7l7P8cSNcehp9rhlNta0W7espU7\r\nQZtyBNkEQTEX9KGxDfd7Zj8v3/XsjTTPpgActiORgYLSV3vUuyZJcV5NohzA\r\nCSpGeic+WCIQUzkKM9kIH787dzXGASJ633U0YcHsrnaJYbpoUQW73ir12tZt\r\nz1OKjV8kU1U2hXSydWSELTpJoy/xqOEP+ogeQGdxDXfN9HBRrXgTC7+apHU9\r\nTjT71YZPNZIXoodvrWRmUm4j1I93X9a75SsWWMWzT7YMoH2Jq3bybB4hh2hB\r\nBnz939zUVLAa7QUJNXbQruGOyTLKoPvQGLhj7naBo330sF1MgzPp6s/yAXf/\r\nyq5HX304Kd0pN/ofwj8Nh4V4aa+Yi4NZj/ozqmuEhDozmFHZAKZPVskekXEk\r\nmMbJc3LXW0JMZ6H4nhwynOAwDIdL5dpXjjVzLNb/Bn5clY2WGy0ypK1BPuNV\r\nmxJ/QjzjIdLjfhr2NJwCnHxFDV0SSpvfDtTRpuge1h4MYYC49EcdltN3lx1r\r\ngPq5rcrNlvhus7D9iL4h8iAYudTg95tlXkJO5W1pgRyt7dYiDSFkXgjM3xqK\r\ny/vILqgka4EatsWVclwcI50OP1iXcjJz9FE=\r\n=n9H8\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.13.2_1652301893292_0.8532345781060195"},"_hasShrinkwrap":false},"0.13.3-alpha.0":{"name":"@flexn/graybox","version":"0.13.3-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.13.3-alpha.0","_nodeVersion":"14.17.1","_npmVersion":"6.14.13","dist":{"integrity":"sha512-7JKEMyAtfnDkUdrtekdYT1e1Jr/FlmfSAzbLZSKS+wwGhRYA5m2SiCS7EpzTRWyZG/eDgkMFu7tEJELcYoO59Q==","shasum":"3b4239060a82906a978f2e8aef38059bbae2e3d6","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.13.3-alpha.0.tgz","fileCount":43,"unpackedSize":87255,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIGHAlhepx/9X9AM+WOtmbRYRvENAaPT1CCOuF8+MQFx2AiEA2XTmZx9FWT+SfqcMGuynY5VY2ECWJEy9RD1RxcYF9iY="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJihzdVACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmr4aQ/+N1mvke1cFasVmZrzhOjIMzxoLQIHl1Ly0ypXcI4Mdqd5duNv\r\nRk2jaXwGQWOCif88zCUYjsrCtIeFsF2CRDUP4/iT42ViIjfhvoww5Sha93vP\r\n5lZsiqoVaoEqjLALCPeuKm/PSPzSRX0Xymy3tAB/yBlsgiaKwn9L6vwGMNFE\r\nzyYTeA3lkrW3yGoGk77qDEt3VC2zns8W5YMzo8qCUSD0S0BuG+D0JaaJ9yOQ\r\nYrKvLM+NQKLd56yTd9IdTVoGMSKGwvNUa6/GpuDMnY8TENqq8AzP1zCvPIzn\r\nnvr+g9MK9tXkVhKAXYoxOWJbCT7MFCUVinXmTxib1W9BWttgwAP6uB8WyFRP\r\n8k5pRqrF5SR6NYEzBZoA0S6AdIbrGzPTQYv2cZ6JwZoyIdPw4/jTqGHfum8M\r\n8teqISbd+tcZh6UH0Bx4EbCaJ8Q4k4B39tE1O2Nswt9Oen9T0E5pn8hoLIDU\r\nAR6h/u0XonIqytsgkIaAveD6S3V05qRPVdj/wgfaDVgy3o+5pe28xQe91Lj7\r\nPJjunuEjJQsa/KPesFB0cYl7/2F6GiHW0Z9ckMlip+w3uTKqdEphC2JoAAum\r\n87nN0IniITzjmhMJ+p7IKbYzlHinahW+Tsufg1YiVpiXnkvZ5S1HtcZwjAw2\r\n5H+zMvGesXfnv8T28zQWuIRcGiQOXG7Kic0=\r\n=rEza\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.13.3-alpha.0_1653028693528_0.2479405502116574"},"_hasShrinkwrap":false},"0.14.0":{"name":"@flexn/graybox","version":"0.14.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"3eba89a2af5dd687ecedd9dc2c1e7a3593c1463e","_id":"@flexn/graybox@0.14.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-yxLXwTUqnnPoFQ4MEA0LqH9g9Lmb7AVi3/fCsmPv7Bm6ojG/G3dOhV3UyCq1PtrPNYcCQ21ZPxAkQr1pYIjhJw==","shasum":"52ace4eca171e3c0bafe1d5179d81d5e952b71fb","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.14.0.tgz","fileCount":43,"unpackedSize":85301,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDFkempG0CJTiAOAcMy5KStu6wXed97iKuNZ6AUqkhnswIhAMeZZ5SXbWacdZTa/7nmdJjjQvydIgGxuz26dQ4OeJiR"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJilNIiACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmplRg//YapSb59Ku9HXgwm8iGEFpyanukq57UU9U5/q1u4O59Rs3uEj\r\nSBLVdJG777YqmPxg7iDUPwlapie2ekMHUtbboYyEYFyNk3kDcPzm3cRTVHag\r\nT4KlBQqga31ku7Haf6xDdImqsuY8N8XtFc1LcXzSIvrFzHcO+wKvXVeR3e00\r\nkt1FKHX7EGPUmgeX6L0SUw2VND1ZaLCRrxYRCzH7kqYVjzW0LU35IgAlM87p\r\n5KmeF23H2ABeA7VOGoUagymnlMEXKM86R7IQ/aZ2MuNX8f9TlAh3wCyPXnxx\r\nS/nNO4qjIZkrOf3WoeYgPY9H9Vk3FxXcdwcYqkHnZpJfhEp7HND/zUYByCKU\r\nUChPnszwWylDQVzO6oV/Q/EU7QEH4AEHRZI1iMwKUiJvDXdSpzC3tVTqG1vn\r\nvZbSEJSftcXMbNCo/6TpeJXRIoBzxSMnHO+gejkJPlxgHlN/vKTWc6+gcPTI\r\ncw1mEo9mL+K3GibrCrD5VxVqqPN0BfOD8b8TDLvv2GhtJs2oTcOM4EK/UMem\r\nzRiu8ojFILv5EfiLUhV89hMiijvILtNpEjB+W6iD4Oin/+Ik4B3RLN7kda8R\r\nX4KnqFrkZk1RjXc9oj2COgRHWGsdez2pJPqvfTV+ZTqkRbMc3m9/TV3FbQ0Q\r\neREfknt7C82slDyxNQ1jfQqGUvGpxj/ihhQ=\r\n=oiRI\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.14.0_1653920289832_0.8121371770536159"},"_hasShrinkwrap":false},"0.15.0-alpha.0":{"name":"@flexn/graybox","version":"0.15.0-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ef38fb3cfecd1b57fda963018608700839cc95bc","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.0-alpha.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-z1cyvDnFaqI6aq4Iv7BsXK4PPZzz6rVrlYoAwX6n1CoE+HV9hwBkLJM6gSSzylcDnvpnz9XTHp30E3EKGYg30Q==","shasum":"2f8be931e1d7745dcc66609728da30fff3821155","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.0-alpha.0.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCPp+5e7s6Du34aEf+8abyeAWaiD8pyQtN49WKzW8xREQIgRvYgnl9pBQ6IRmQarKM89dWokudPb+LUinWDymWTjhw="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJimFH0ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoumQ//WxUbQQAH9zmGuzxM/7rm1r1eWcxMN7IwmiXZBDoqWKnXWi4K\r\nc4vS8c1EOePsmCmgt5wTPN3QVq/YMvv8FLqGBjai8I5i+plMwydxeC2nLhoS\r\n/EOa7s7euq9z7xuB1mJTVb93+RwLtXlG9CnpuNAPwVu+KlYRzDklpphvlRkj\r\nTNDRRyxEnlRwuJiE6ALTZ/OU1FBwJPKbGfzKJ5+ZuDSgtwoqRwxptxBX6dYE\r\nSoNfqrGv8Qe5fmGALJ/PAELsjjoqzdBBGy1NwCZhlTe0K9YWe4ZOmJ0vZsKK\r\nBKodSd/0wEy72SbfKSNdkROE3OY6Zu+G8djwrNW22fN6t6XlH3ah5LUp7rG/\r\nzGNivFD8xfr4xCl0Aw5kPdP7SvZpkUA9oubRUFAYjI1OWf5aj+qm14+YVBoV\r\nSXSscbXS6WzXfArQDhU7yAsLDubvfGGpZDIp6bRNz4aHpznKLyn9z3jkeQC3\r\neApnfx8w5711YM6gs3Ei055SpaD6slbK9K2xcBDzLbcJVEiLHOAtqEad3pr6\r\nfqXVDDn7CUojbtnFmACGnmIkHgO+RyP87eph5CojgQo7Bsr57v6iujcLhv3D\r\nY7evNNwOyvGY6rZENQByTn/u1JscIEx2AbrybAjfuGCCi4Qbd0mpvbpfb/FH\r\nEfdghVO41iq4ohasTxSwKMhDyvgNjwurBBQ=\r\n=Xu5h\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.0-alpha.0_1654149620096_0.8440328404644293"},"_hasShrinkwrap":false},"0.15.0-alpha.1":{"name":"@flexn/graybox","version":"0.15.0-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"e8edf05e6dca603e3952e819fcbde8b0f4a6b28e","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.0-alpha.1","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-5D7H03GeuXSWkT21fqp88oVuuNC+MEeSKoX7JQouNM6cWzARmG61tSRhQ8ksNDxgyuUXowkkuoF1v1TWNYn41Q==","shasum":"6ce01703a2c79be63471241700592ab55fae6316","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.0-alpha.1.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDJykDN/dQ7Luv8EN0wKqXHH1V2ruNH/obJHIxwL2zRlAIhAMHBlvq7VhGQvkDOMp+0TxEUpXuxFEB9DdjnImtdTMEc"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJimNlxACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp+JA//cUhpJSJYA2iaSI6tF1OVoPjBbYkR61nK23EEWAgRKqMrifT3\r\nxfuVvGZJ6kf6s/5NF4/BV3hM8eqrd2CPO03J/ktqgdr2YGqnmLxV3LHIyDkU\r\nj4qYkZSz3GJ53UrqCgzRs/GlszCZozuI3jkY4KdKw01CpKPcKVRxjDXPmqzi\r\nlsQ7+/L7xTYM/CM+hCSM5unf7hmCcm4ElPzfSaTrQLuUFJWEhV1COhzvLNBw\r\n916ACHS8OI4ufG5BbLD6GhMtUj10Gvx3FfaFguzswPGUZ9tVHfEVEdkSiO1O\r\ncFXh+w28EBFeUDD2Pn+Qnlkuc2i2POn2ECoVHN2NeOmW3FLeA53M6zhCKriV\r\n2IEiIUiS1JIl4M8u68KUDlYGM+5xH3n1uzUtv3ps80OHl1GNOgXyvWOb2M84\r\nVU6RvB70yucgScU8BR+V2j4/2Lx/gUI1QFBiwtDjwKuBhhaVeouYv0m6OTr3\r\nrHqhozJvrmzBmSFprNvSgBo5sU0BTrIGjtMeUToE0MLvBoOUsbeaKrCOm//k\r\nDd/jQ1VlVmOr6fvFla95H7lm+R88tyv2oj/1+CYV+0eMTVz9smum+WLGfa73\r\nqGO/IusmcXAvu+WcxTiO1de0aMLewLqEHr88gkPiXNSLajtcw+nA+lZKGRxp\r\nLQ+iCXfHcEhsywANTrhRRYiXPP2Mp8o0r8Y=\r\n=P35K\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.0-alpha.1_1654184305333_0.05809186551727974"},"_hasShrinkwrap":false},"0.15.0":{"name":"@flexn/graybox","version":"0.15.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"cc67b7911e89452443b2485823fb48046b4c9926","_id":"@flexn/graybox@0.15.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-gnK59DprkIjM2DO4zm+ySSTsMQmuHIQYCij/er/oMj0dIWSWtQXuFuJDEOP4wyjypV6B0vJPjdXiC92aIICwaA==","shasum":"ed1165e3c20bc3fea558e21a26a7558bfda22611","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.0.tgz","fileCount":43,"unpackedSize":87306,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEKSCsjv6XsKb5ZHNVdqng28Ci3phBpjscFqVPgwCsHsAiEA50LTQQF4NeHZ5L44jj7o4gRYmKjtnzaKP6wyvyndltA="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJinNaqACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp5WhAAopXu9+OBv5ISGdJ1vUloh9JqwJj/rzAt72IEDtVwhNRJqpsc\r\n89edY9qPllBe7aYLjKJecAblxjPHSsMB8q00IIY1OPGaDs9cyLaOJdSrvs1w\r\n8/2b49T0LZseLtoWkbZrpA4LY0TBdLaPoCSpVwcdvnlAjLhCKYCxLX4KDBZL\r\n4xTatFYJnkWUXN6e+buhzd2PtdxjbV5eXzFAEjkNu+6wQB56smqGa0ZOqqZv\r\nbQhQkbV2T2rCF+Bi6B6ody1jtdOq332oQdxj84Xrhu46IbU6iV1AnlVFWDyH\r\nRcCs719rd4Q2H+uBnNV52kdqRvP8xLzuOwzHzSqw9DV2L1aAbArkPv28xltV\r\nRsL50PYx4wWfyQhd4hsX64hOwRnejmMqjZAOq249scTLn8h+N4lPMW5OuL+a\r\nQDAdNXaY3uGtNFSNA8dM2FyXBft1qOfJ/M748XD3Nqynock/SNuX6qxsjvpD\r\nlP5i0RrvPNTsnLbvBJnW2ZIFNAzSsfg7Sesro/u+LFDYzQhGKesz3PZ1ED8S\r\nnEglW4YIwZ7NbgY505mrFuf4hP05/S1TJRU0BR0r4cpvGAQKlJL7ygU64PQD\r\nz6wGPWnvuRJXxcKGkBPxFGfOJjfl2BR9mY76A/r+Wyb53X+CGXWltcbaIfoQ\r\nlQDmaDnNVwGApmN4y1MT5afSNHrWgjEKm4I=\r\n=h2pR\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.0_1654445738737_0.19746900544093027"},"_hasShrinkwrap":false},"0.15.1-alpha.0":{"name":"@flexn/graybox","version":"0.15.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","gitHead":"ef2fd88de433f8aa4c71763c9c6224fcc493a045","_id":"@flexn/graybox@0.15.1-alpha.0","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-06iEEjju4mMRH2GiaXKoNbtkWxEsAPe0heaxG+htOxv2rzhF+DTEjdR4q4rdWAMfBXUiaS/OGmTNbphi1TcX6Q==","shasum":"7e70288d4d7f2240f72dfdaf8bea920fd76d2bdd","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.1-alpha.0.tgz","fileCount":43,"unpackedSize":87305,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIHdgohAA2ThlohFg4qoAk64rpj1qJZ0oK302AJULxRmrAiAkwkbul4LUMlJ3fjbGSwcq7W9zz2jCoa22oknXOLxHbA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJincRpACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmr8PA/+IIjB78j6T/lt6/MhmXpOVFBydQXYQMuxq9Q1tmHxWRDbkKzc\r\niuMccGIMnaf8LgmMfA5IDUgM6Q7H3RNPyG3RUaCDHQvbYm1ZJralQx9AQ4yF\r\n4LaThpkedDDuIV9s5jDW9nITZuhlyFnKRIsLRijV33EK2uR1dFZuDdpV4Oqb\r\nJfQDkaI8Yv1Lu9D1TPDk4d5sWv+gnY7yikDizF186Je+pLcxG3Fgpaa4RzSF\r\nsC6nP40R+JabJnS15Grws/jjoISSV1E98aipOK4V/nPxW103NrjeUD5RkPgH\r\nHh6QPX9P8jVmQji+FMdF+XkVQNZopfgj2u6kVOfj+FAzwpnvWR9B2AxRokpe\r\nnNRo15i5AInhqpTt9LvMNqkyxKxB2oisk7SvH8CE4l3+GkZhKp1EsuyS4kZ3\r\n1rr8SnMs37AB2Pok7409oXw85d1ldkqmhmTMEZcyV0szjmGz2SqP8sYi5Pil\r\ntkWIxnoh6vPwp1C03S1FTnrYNTQT0KSByOEldjLI8w1xgptte2W24xgM3UHw\r\n8Co3XKfsThNy4b5mF0eYZk7QcUQ08M6iG/n3eMCOwcQEK0Jc2d0YsVJAN6fL\r\n8ZbcufQ6oCI54qEweE/lE7xlaF6iB23q+qrS3xPsl/p3lvMHRX5M4wsaZfdE\r\nKzzv22aNC9ZbDu45LkF6No2cR++MpOYwys8=\r\n=EkTV\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.1-alpha.0_1654506600990_0.010086847337931193"},"_hasShrinkwrap":false},"0.15.1":{"name":"@flexn/graybox","version":"0.15.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"c4bb9cff1002fe60ae7c9fa54d22bee1902ff4f7","_id":"@flexn/graybox@0.15.1","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-5QZvlLjm/qz5qD1Phaul7IE3YbAnXl2UIMMsSteJD1zn9jkd5CbN19lLST2D6Xn9kiZ+0hQl3/gHzDHHa2lcoA==","shasum":"01747762ff516f871726e1915a63f3be75bd3992","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.1.tgz","fileCount":43,"unpackedSize":87306,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDTVRZyBBu6qOEwVHSEcW3HM4z1OCer2Ffk8AFd4ND1DQIhAPmqDErappn+/d2pnXmzBfIwlrUxu4Dhp6MDNhM16WUP"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJincrYACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmo9Pw//RLvyzrgPdjwlh6VMg4aIipGsMhga1KztkGqczxDaRid5unoi\r\nxRLEPsTjRqcOUb1Mk8tTpVPf3pKE7KnhPib1KEAHW5d0+/NCBojOgshuW3sC\r\nq4f+X7BlTqrWu1N+oYaxV0BFBlWIG/AMvMBNvreXxfM1Sr2AnIzvFl7g0EDL\r\naWmbhRRvjzKrMXJ0BQEEQ7xy50tnXJfTGWLfBfkC/5Phleb+nTwt88B19nNL\r\netBjeQQoCEVUUm/K0DbW9YY4afP9YhKBMsU7zy2dSwygXOCkam1gON8gXjdd\r\nJPsRi//ISWUS4OK57wOJiuDbFfo2QSe4IA+vtPgG6Gh6sdKbOOHpnlsMcNYY\r\nFKtdnAIZ9Rx2vV4LqE7RLC1IsI1XlbVky4bHULbof50PNbCMycFb6ED9xnok\r\nLGJkaxLxHLWyRS9WKkQ0GQiYvnrF1gOhaLuAQDlCRosejqdY1g1XZPVBznBx\r\nK7Ww6dRoeG3GSY0Q81uMP5As7TIrLHm6LagDJw6ADri9xCTFX52U2g7f2vcN\r\nlerZ+fxcizRwGyuFcfyvGc06lJFYVMlvX+tGs+FU+pjvlGt5Fg7zCAiG807B\r\nNM1bpzHxP/ulODStEYpRgQwqvFsNbXGipesC8clntndD9PkNnlr3+BhvsjxM\r\nfVSgWxuRFLIi4F3ua0VpfCVItRqvGJpv1zQ=\r\n=efZT\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.1_1654508248383_0.5730170976037163"},"_hasShrinkwrap":false},"0.15.2-alpha.0":{"name":"@flexn/graybox","version":"0.15.2-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","gitHead":"e817ee95e9693d95c4dadb56758141c124d72504","_id":"@flexn/graybox@0.15.2-alpha.0","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-QFV9Mq1Rna4oxXegu4nkesAHTdxjquKEXOnW+z1H0GAIM9yoqznolRYbFv9IQX4f2SnzWetd9OzOsHnrkLzgWA==","shasum":"e3e45bff2ca8eb7a4519b7463be34320acfe0206","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.2-alpha.0.tgz","fileCount":43,"unpackedSize":87476,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCChrQxUGYfxvlz9Wo/rGT1zW/wzAVPOGark36Fv/eivQIhAJzUet3nMveNUCOlmFNI48LGW+Ba4peZNOS0VtO8jjnb"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJincy+ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqRHQ//U8BETi08LC6+Ttaip852/WbKZ2kGwon+c7Bat42UmOwGDQSb\r\nEOUZNte4YYB5lVWI9Zs5amQwMpjCOJlmeap2/2e0nAyjy6DbNntLhZUyd4NM\r\nbCD54/SWqw87/VgyMHP6Hv/ImGS/pC9VMlTpp6eX2Ge/HC6AIY1/3S/8CQ6A\r\nojOc0TcQ/jL8Znh1kc58YRXV7rDmgB/+K118XSC3WJPRzQ/Qq9P5YRt2tFnp\r\nfIxVn7PhEmOFh/hueDlUidZPkbyh6CfED9XdwuJ8N3ScBRzrCqk3XVjyHgD7\r\n3eKRshVIFsi7Dn+DkIija9izYM/5Y4KC/MQVx/V/bvuO9NicjgiKdBObRdBS\r\nsiFeuzs7sjcKhFfAm7GbkMLCXzNknaHFtBKbUwHGHHJ28JdPLH+JmdS6jLXy\r\nfYHw+bGM376VZt/5Ac/dQMBqBZYQEPaQwmI+cWAOKgJ42Uy8g9tA3TH/IlQI\r\nJv/hZ+78zSwMB4zfSxSW1lU9Z0f5TLM8T+1+FsASE5yasZTBAQoVy6oQCvI1\r\naTkaPAydUy/WZIhkyB1OzKdVEHxv3/tbkFy1M4xq9y4PVoJeFlXzG6TgPYLC\r\nzWsHWst7JsoOmGmoA1OBQiENfiIRiQvjl/qtTs/MpUz1ziw4mjplKD7JyUUs\r\n7G6W0brLm9HfW9nWD9mk68mMu1T9OZluCRg=\r\n=+FsJ\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.2-alpha.0_1654508733826_0.5655984317271763"},"_hasShrinkwrap":false},"0.15.2":{"name":"@flexn/graybox","version":"0.15.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"7c39fc75b4ab154c5bfec03403b432ebe610f2a8","_id":"@flexn/graybox@0.15.2","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-vD2wlsvBJ2TfloCdGmOBsOgnyMLOjsP8o1oqE8QJgYWsPhvIR53hdKL7Sd5YNzWWt6jP9iSlLcpoq2a0+eJPhg==","shasum":"12c812896dc6b6e18e309b41ff3dcdbb121721fa","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.2.tgz","fileCount":43,"unpackedSize":87306,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBhOQ41P7zyBuLeJgUDZd3yNzZBgp5tFzLepTMeDItMdAiBbtaqSMrSpEy+G3Z5HDTMHVuqtI3TWen47YJkfArHKUQ=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJinjavACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoocQ//Xxg3HVzjFKGmlb7fGDordBZwBUIwWNyiwcnV3GL6LU1kirek\r\nBuKRrA2zI1j3cGqal8b8HajOYSatlA+X+XrNYuwOV4I22fCaL+EoFAYFseAX\r\nxVqfDusQXrVKK41++B2PIgVnARe3v90ZJRbRi8o816nuC3cwmxyT20lDA8tN\r\ndZk0wYlhrrlfvN6gq+bOCqH3UAXjxnS+PHzc529eHpzrTrqNAcmOuRCOFxj4\r\noSlYt2naSDeRjRZFwKP49RQo/bSgcgZ78a30iduxJYY0qPu9I3yf//JQfEfP\r\np8rnKqjFLyHcpE8CXPg+Z5RD1lPtjqRgORwhFOsX9q7luaV4jRqHtAmwe5kw\r\n6K2zUeFVYY9Fk8F95SYBuw1/kl31Vi8IjRLpLn1BUgaFI24k5oGPxruGLTYB\r\njsKqxKr6NNpKV8SdI/Y+Yb4QGW7d69deeUlzVQKcGHbt3JxbN/vEX/MQW5uO\r\n+cwjekA+GojoXbcBBH2fzo1M6/Hv8E0xEk5giaBLgd6+xXTVXnumYQiv6kQu\r\nDtKuVTBrlMxOEYie6BwFHwS+DxqqDvuY/OPgoOkftsAmVVrn8BcjGDq9DRKL\r\nvE+4RzA3lk/p3PkcdPwQzRHy63FYqfYzu1lNrF+vdhNwcSwjRfi+HYhwV4DR\r\nwf+esKDM8TNwJozW2Tq8XjTWe99rVKUylgc=\r\n=2YTt\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.2_1654535855619_0.5499096345963708"},"_hasShrinkwrap":false},"0.15.3-alpha.0":{"name":"@flexn/graybox","version":"0.15.3-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.0","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-u7WVjS0i7jBdNl7nhd7sL9OeU3I/gGh+DwfUIez66+XxtYlIbClcvcy4N9nLN8rL7p7kJRfIVd2y8GkD2g6Pdw==","shasum":"c9ad430aea3258e7d77a12976bd63625a1b1d635","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.0.tgz","fileCount":43,"unpackedSize":87535,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCEjiV6V5q9QwGMg9raDZBL2YOEwU9zmV4B5RvxNLL5AwIhALwaohnyIpWcLsMUeX+H6uFk9Cr9cTGGywqKYAQWHafn"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJino9vACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmoe6A/9EAythe5tqiXfNbHnq1q4zgUtHBRXy1rNq84U7LdjYb4rw++S\r\nfFeNsDbt79uP/qU9Z2e4bhJspKDiQuaVpGv9Dju6aNH2gDmxUatJr6ER/Ubd\r\n1EtYBd/N5fdCGVX09sUPTzj4L5hfiavxc6imtpm0rJTXYOcDP+jz0m+hEgQf\r\nNiq7o7Wv/VpVuFlKRvSmLyr7P5lN3dN0oM6AOcHomBIZj47u+v6zqz/QsPCj\r\nwH8s4sJXDVZgTOv2TcrFxyVlAEHxD/86m00Op3lgpCh6qduRWh9+uxJKt99L\r\ntk76DRLBEYYUf4jB1mZczEko0Wb37WCgGta1s8YHypNVu6eSlKe+EME8MLOr\r\nGTRM6fXcBeOwbfz8kjUubMkSJzgEEnaLermt+29a6Dh+j0dy+tjk2UHeYJtq\r\ntb9vntD7DkK04g5Rh2Ef+/kPawjdLpKl5bmlIA3EWHQrUHTs5yHUQNTmrU6k\r\nGgmplzl22GOg4Ys0X0mpjpBJXG5RwT99oWv8akjvrWRSHH2Kotxe4JmMLCP4\r\nd44r0rnrW5Od3vwQV4Tcyabo6uL1yeOEywzN/FXf/fMh4Bs1BfaJ8hv4Eim1\r\nRhVMdOyKfDJY8yaIrEuLK4QfXAWOjSWzn/BFbo9L0pGCO/OwwTngPsA5R3IP\r\n8PiWgHhcSC3yK8t+b/i8AfzE20wcC9qLaSg=\r\n=ArNN\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.0_1654558575094_0.8211881976018192"},"_hasShrinkwrap":false},"0.15.3-feat.0":{"name":"@flexn/graybox","version":"0.15.3-feat.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-feat.0","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-hqHSSDL6NZb0gRr2Fk6bGlPquWACZhycy+UVGTpNa9gb3A1i9+KYyEV3lhzJDkFyiuFINPYco1Tyb1invyEiag==","shasum":"043abbd708ce70f99bd8600635a9cdb6358ee26b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-feat.0.tgz","fileCount":43,"unpackedSize":87454,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQC5PQgbxnOtEELmSwKNH5qFd5l2xVHZ+mTp51maQZfAzQIgNDf9Z4huwobzA6/G7reA5mOYdF0+cOuk5F5HoTOOYoY="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJioHbxACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpaWw//ZXlHcSsxjG2EwGyuqO+rdwplyLu8nA8KRV6pt7Yy8h80tOgb\r\nybi+VwbLMOLo5h3iTTgQIeBMFGEKQOyJFzSSWR79FLLgyH1RczkEGx63s5hZ\r\nG06eaigGGtFr0TP7Kq8ZnQMjrGKNvHq4Wb2oTbNMkmfw/adARUJNWd010uRK\r\nPOmNiBB1FwxQPff5bG1lWqP4vjSvaXitFx50UF0wtoZeXcKdi72AvkynzEqq\r\n6qqwGletvAtMrprF3g1GfM64vWudDmG8MvGQG781JDrtErWr/qrWSYHH81cx\r\nVCVR5Bv3g+U0C/XfsbHiJipPHNo3xbI8kasGWvXMHc5DBxcz6hRgkEeVgr+F\r\nqvDr++35ElB0cgXnIaaO15T9hmOteYjH9lerfhhVTlIwdQdagAM2+U3+rJ48\r\nxz83cvPlFkXKl8LkUzqSYYl+d1NgCh/9TyIX4Frv0UhnkPsntN9LzVR9XWa9\r\nVacngY11AwvEv4HGo7NcCAaWhxfEHLFYyy2g6w2WMYmOL5eRxitnHpvUOEqD\r\nQondbQJf4Cb74rEoND5bJArrWWFoUxj/DppLOF31gtJ1CRGwDOQBiHeoJgbO\r\n5AkTaZtvgWwEQov3hqTgrC2tQyAvejh9GsIVaD7vhtnoq2xYHEG1d8f+WvPj\r\nsoVm1xoiZtbL/y8YdXapZ42dTaTmpUanVYo=\r\n=43Un\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-feat.0_1654683376924_0.8678724625358403"},"_hasShrinkwrap":false},"0.15.3-alpha.1":{"name":"@flexn/graybox","version":"0.15.3-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"f29ded8ec4b129a73c8f48384cce9d74b0f7daf1","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.1","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-4HFWSfdVaB0fMeSryIrDfwc2A0hdGXdv0tbQKqK/nVEMGfoTShYvZ8e0XUrzHOTd7hxO/My90PxHbL+Q3FouWQ==","shasum":"4d067301f406dbc109b8f886126361953e03d682","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.1.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDx6TYm3rZpdEYICNLDSw7BV5JSCyCg45iW2C+7BKBqBQIhAPilw26n9Dlk/XplD45I34NhdhOxyHKWo5ngQm2LKPWA"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJioOqcACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmotLw/+Iq8KYfXzOjdY62udjpsFtQzmL15TpMpAebb0PY0f0aL1eP89\r\nYFOqNpv5vFp1AWYsCxqz4ghBHGZ11Fr61ZVGiza6mBHfe91Ku5A1pNfj2dwO\r\nc0hyjSi/qGvbGGUkvGZFZaZ6bC/74aeooYEM4bDhjTRuXp7MSk9vHxT2uAy6\r\nQUPOcpV0w2rR+BF/t1qvNYLZ3f1WA8yBA1MaWLq/DaZ1R4vz1giMjB/wo5Ib\r\nCm6V1yBdMhY6rVYJcz+DccvF/mjgsbP9F4ZLYkBeMUU0Gj1Vi0esHL+eWmJA\r\nVPwL97Qmn0OFF+zdM6GAGgteIJZmaBPvJ0otTeBbHNwjpRQcD8REjkXK1Lv0\r\nVzJs+Qh+QsBrbD2ordlLNI4upYYFCDuAEMFiP+K8pGvJG3IVuFjW1cJTnblX\r\nJ4s8I39jXn2rmn/k31UvK2cbVJThdOK6ACr+Wt7EcSeKx7h6AV0IxrsAo+VF\r\nSpMADy0MSvy+AJUqroMY5lmRfedQCTJ+whTNkY1tOZEzlVzakJqwc6cu2sRD\r\n/A6IWAZF0hOna+p3mB3hPB0+qogWIF9B3BrsUCTptFqIE7MDnDOmICvlr5NP\r\n57Ca2jDLdUYftqeT6FGj88Kv3/lDKPQN34PLZBaOz4NVoao8nmy+Gkm8ODxb\r\nY0G6lAzZzHSk4wrF4eI2TuWt2rfnioCWefM=\r\n=l3Ke\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.1_1654712987852_0.5303732027347112"},"_hasShrinkwrap":false},"0.15.3-alpha.2":{"name":"@flexn/graybox","version":"0.15.3-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"af8074f09b102de4790a50d55143c514e0c1e2bc","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.2","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-Pf5xlcOIULliocHedyZYjMb602XRwCv3SizDCRkjxGBtzgin0JbJDZpC7gZsIgmMokphRJE8mPJNz1fx4rTMIw==","shasum":"bd42210053b8638524193157e0acfe39abbbfdea","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.2.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFfy29uZUOjXF2kKxM1oqZYH+UYvTJa1Wy+kKpNTIAmdAiEA+mbuvXJyA71VFzgBZGIZPzD2hrANE2xqz8iuD5+CI1M="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJioPxXACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqGBA//QRQ1g3bg1uuA5xk35e9jE7kMcIyCEQFSWH49QPTe/pX33M06\r\nSNOCPvf9bVCnhIdAW8N8imnMGwPw40Uhp2GNFRmMEAGJrOOVcU0xkEut2mNR\r\nG+jOAWabYhrwJ5IJSjA+MEV/SHDPOK3AsbwogpwSOjg+EKQ5iYW8QqvnUB6v\r\ngfPbZwjM/tfhTvO4WStPVLkV90+To+Acpma/1r+Bo/LcVvrFJ9OrZe46Qza/\r\njhs/QZPgoeP7A31hFrWtbYprxE1T/7/GI880OQbIFMtmqwt8QFCKN/eNxtOE\r\nIzE28rvXKo2py4R8fgFY5WeB0ZrfJPUe1wBMjgBhiiDyHDhaLZsYxurBqThp\r\nklL73QASIGrYPQlLBy1txLgLpZzwHaSKgjgrYoXmf2W7XYk/AxcIjf5lMQIY\r\nhhn0wHsPcbDTKqaR5EvQEYIHvwmFi7PTCj0MjsnWrU5Womfa8/qAEEPRCt1n\r\n+QP3x8nQhPbVh3+d3yrGA9R11k9Fh4E8Xo8oPV2n35JeyWX9BM3uXkGdYutP\r\n1xtvYkuVsvNriuJoLYzzbLa3DTgQUkQ1vOPEquyhcpinqseWyZFICrzS3DWa\r\nXp6TOAj6nDsaiEDuBIucoQO9PEtPo49PQH+t3Rm7OnyL1asGzXoBe+S5MNCt\r\nhEZwUZ/Dut57dA8HdOaJYcTRTylGCHIDO2E=\r\n=gg4K\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.2_1654717527305_0.27056239800557735"},"_hasShrinkwrap":false},"0.15.3-alpha.3":{"name":"@flexn/graybox","version":"0.15.3-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"3b59a6917ffb634dcaac5ebf5178c40841409b74","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.3","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-YGuQkPYIYdiqaL/ZGhWvjtRhcoFmoeJfpnMUt5j/EDE5XakTga58XdNAR6i+sARwETxOMiqBHooljWX5JsJQRA==","shasum":"123e38b9f4ee3bdd131a3ed77efde4e6f6d23b24","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.3.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCID5deuNkzr/O4bkNjwyas7AedX5RABhnjhsE90srr7gxAiBUAnelh8I7nV2R54/wWHdIB39KGoDlf28LCcxQLbe9xg=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiobXLACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqKbg//abAi7mWsjVKGLO9LBy86rANL317Iirx4xhpqNh59vn4iO7PR\r\nHcZSXgP8UBkM3aTM62YSU0BdJEzNfn7xAwTSpssDrmTlV3sEQc3nSIfPH4ou\r\n4ccN+eiw8JwW3NgXobxC5Mk05UOt7vTix0BiASe8ZQZerWkyxlnYC/YudfWx\r\nUqDYPSsBD1wYoNI6T3xLDlKmGQrvf3WdLg13P7W6S8Qvgxx1T+25UwIAPX7C\r\ngt75ElAkWfxvVTnevwIzNpHYLeR+x3ErBJKZqdPT8E5BNTjqlpgi9tJRxoe9\r\nLvse9TmTd2UKVEUIac1bB8aC32M8VfXh8L1pI5IuMjKka8sLvUHY2lPCUeEk\r\nSGIV8qfrIf6ZqdbQ65WJfjRvlgqHt0J46vngAa8lBVwYuf/DimJFsdbbQBAy\r\nmjv/kcyuVUdlpg7Yir0k2Af2mTUbjf67Gdgzc05Jog1IWuMkoNgVlZ8qIzdQ\r\n6+FHXe0LX44FBxfjERE7+41FcFPQMVrnvutPPKl452GTrZtdbsaU6d0RocX+\r\n6sh6JTguPNsMXTWudQhEaB4+PudPkYLO3EuEsWZ02hhPbZDaTfpQqFvhK8+W\r\nAq9uUvuZcyps/JuDeqJxhunurR5k0Ubogb6NVBUOmIBPOJd6rAiL2iBFgjug\r\nChiDPhUYI8S3SgDElWPacJl29eLzeUBLZlE=\r\n=hNih\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.3_1654765003366_0.3800029127173672"},"_hasShrinkwrap":false},"0.15.3-alpha.4":{"name":"@flexn/graybox","version":"0.15.3-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"42578de64fb348aeb340f79c2cc456095b65c946","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.4","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-4kqj2JmyS9iMFqvt08RzhA8OrE0BRDqTyCfacXBQTKrAIHUeOC5OxnGrEMU9BqEsnsEafroPNxyq1vuqpy30Fg==","shasum":"d35fbd3bbc7eb4aef7482ebbbd6eb03511796351","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.4.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHk0FoW09uPAob/BZMnEA9v0FbVyQZiDYlpSTActVpqHAiEA/DbbAPR/kYvoVmabO8ua07LL0pxzHpRZl7lnnHptHys="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJioeFjACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp3CQ/9G7DfaEhb8/vmWhtJm1Qfovd19w2913P8irn8AARlydcoW3Fo\r\nvtfkfEiEk+NIivO9KY7utcxcAGdCWswyrbmToCeOFGf8NrWSQOkjObQBlU1f\r\n/QKegnUXfXObcZH/i0enmnb4Y/haDIgA9M11BVdOSiNDr+DyDSVi2mfMFoaf\r\n98XdAufuQdSECc8hW6hpfs9h4bLJ2WVvUQA5LN9JuE6+KdJ323Zl37++C0IH\r\nff+XW8rtF7w5teizQY8VgKWim38QSgb0riclGtlhhdcoRnqMhO3EvU3x7OkM\r\nninz9aOHMMoRewzTebiwPs0dvMQSveI2L2sbdmeMjnbG3fE+1EXSh6fOD8jA\r\nhwkQE7MnHL6Kwu4WVBrFfDeTgWDG2L/q9+X/zVcN5v0G54W6ZjJ6Nl5UOVq8\r\nrxAufG6YDdif78BzYjLCcjx9vrEHpBOB7FavwlvFpf65jVy7+0LRB9c1fEJ1\r\nV6wJ0X7g4z/hC3qkgsOGRrXQjrxmqFglr2QDoMcaVcE/1eQ3FEJ7+2CV54FE\r\nRB0wdvT5jIUYnAQOCx3CzlZ8v7XIZ3yxwv7H5swf4J5wFvrhxKR+G6vQI1ko\r\nMjn/koUzX6wFX9gaasMje4927OlSnSot1EI9wrnbr2OOP2UlpWRUUhXhuidX\r\n2CqYPcC6rcWzH6MIlZbtC1ElMm6kkmi2FWc=\r\n=Jt74\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.4_1654776163263_0.34192012470816024"},"_hasShrinkwrap":false},"0.15.3-alpha.5":{"name":"@flexn/graybox","version":"0.15.3-alpha.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"56298aa4701bc9654653493857f38f79c1983ace","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.5","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-yNWzyx4PDtLWoKkIAu9zXplmW6g5dJS3e9qNtkfcYtWz/7ctaJ+u66FnTx40/px2/vgF8GlFX30qa9t93J0cjQ==","shasum":"04bb93c908448427468c088adafcbb958d81d72f","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.5.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGYKVwtGMIWJ74DAeLWd4j5d4oPwXLiYVw/dphc03QBzAiA9fyf0USqVOegeHUVEOqQ8IwvPINa3Z8GvAaFY02B1FA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiokKDACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmot3BAAiP0boDHW6y8ENLoKOB+GtdE4VC0koiR6T+hdY641QLGcf7sD\r\nXE7J6Lc2qtwcZhqMLTEpj12MYQw5KdoMButFt4aawCh3Yu9tzoWCCiqkj81w\r\nyO2bxCUJB7+SSb/DA7kr+v80R6w9jtvdc0lLakHeSPaIywqpRrxVs8oLxvyr\r\npzEXDmSw11DE1YXxBl+Pj3//IlaqxIedwB1ZaFIJPujNfznfN9QG2T0J426m\r\n3hKmQxMwGhqGGKUI/s5AmFINaTbwoCGAIFK0JYEjNQJLkUWjvoIg5Yt//k/k\r\nZnk8+7ErU1JdTskL5Ig3kcp08cpqUqm7a3XipT0mh/K82qP3BlalVAVDshmi\r\nxk+GRwyeN5h6xtnU62aHqt7i+w4N/kRqUSTImISYxmMozNdrDCyq3ZT1LKe9\r\no8LRjYOFspRHlnoXso6SajitClJR8+YIT5bVk+DBMBPmDWzKraZNdUdbUNzK\r\nE72aTWhR1QXoh24/TayIcnhBUty9k1FLLVspHd/UxFfwJxHk6+OlkmON1fsU\r\n846eAd3Jxa+IEOTGSrPmhdZ3LM7Kl7smFSwr8J+XfW0Jbd+u2GK29iW7oKwU\r\nlfuLDTmTDx1lJxeJJVtqtsE7x8I3SrdFW3X5oeg2y9Qqjb8v0+8dsKwF+PPN\r\nRXn5MgQvJMXLoXz8an2/kD6+2gUv5upd5ug=\r\n=m0/J\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.5_1654801027489_0.6784164711812264"},"_hasShrinkwrap":false},"0.15.3-feat.1":{"name":"@flexn/graybox","version":"0.15.3-feat.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-feat.1","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-GchlSfESjn61YSy/ClopG5vD/HU9zR/qV+Gvoy8AeYUFd9qgz8wkKzElSuP7sXPWXDBmqCXfwfpVkWIczx3qpA==","shasum":"4971ab70c8a0297813c01cf3afcf6bc8ddb1d8d4","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-feat.1.tgz","fileCount":43,"unpackedSize":87534,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDg1E6ex0yowaxWKw42oidMeOWm70O0u7dNrHWAzLwwCAIgWQFJ7Gm1Mij9wIQq/VHcdXoprLd6ukR3iLSFVIb80WM="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiowDOACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqxGg/+KIP4N6x0YMb0q5481n3MXouJbvFnlUcdf6HfOZkuEBWArcr/\r\nF7mOR6qsjxrnNbTLwnmmtvcq0Rx+rY53BINMs12zG9013NRpmUTahBzhoM1B\r\nFJNQzvB0cCkF+FrTLyob49B3noCkoFB7JooWMmsaDhghS2DjpWzpeVFDpKQR\r\nvhmpVeBPDoWWzh/RIcU/pQdvUtLvu3203aCBtJRBm3dUl+GiPBn2EXu3vyZr\r\naMA9fJWQBypQQlgQSZc6nVzW8gh9WtErm1j3x3Cydhp5SfjLjnEnOo/tv4Tu\r\n3ePDzQg2JP6W6lExFmfnkV2Duw5bALhYL41SS38gVenjUc9+gnRwePtvT+oA\r\npV8Y05iHuTyJkrzAWVVsUAIgDnt1jdfIpZYj6B5oTizfeMeXhedrLWbZliEO\r\ngvYSPc7W6kAIUqrQa+7ZPUCJHVotc/Lp8UsAI9YBbQzLaN9E31D0VPyDQ9Er\r\nRIFkEDAwLvDNLCDOO46RGJ7ZUSLz31Mc3YIEqL+53Twj8g5XlO45beRc5KQj\r\nkgrtkXq12Y6LU+iY85hGkIUat68sej7dzCNfo2lDAs+Q3DogltTpkQ5aEenz\r\n5ulAeMLN+f1XOl6Lc/YF8dpEh5oyLAdbjLHB+5FLm55nSz1tE2iKYCuweT8I\r\nV70VgooETT0a5bl7aBaElRM2aCRXxlmAAQM=\r\n=tuUY\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-feat.1_1654849741995_0.3316228893223938"},"_hasShrinkwrap":false},"0.15.3-feat.2":{"name":"@flexn/graybox","version":"0.15.3-feat.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-feat.2","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-+omAHMKJumW95zJgHnA4ag75NQ3xph0I/4gDndIw7ARNzCwDMWhOfSp6udcrYSm6tuQQFgb1Hpw4vJT+1mWCvQ==","shasum":"b35884bdfa9f5a956c0745e779321ba6704e4b5f","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-feat.2.tgz","fileCount":43,"unpackedSize":87534,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICWBZw2vGknXD47B73LWBfvGejdLPxtbW3F13RxP2E7NAiBgNpxxwWHs8H/e7tg43Lpdgd3Brp2gNIj1q3OIFllyUg=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiowaaACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrbWxAAgridlV7JijeXja6rw5MbEF223IUuDrhe6ysC7GxwsSQGBfpt\r\nLKV3dJr8fIo00vOavntX4XLTdIcR96Zs6YzWy+TyePz6+fPFwG3Y1Hbthp+w\r\nhtixz1oPAE5PYjBdxcpHRx+EchYBkshHLFxPxcCRUT56PWiEqVpqwVFwBhz2\r\nqsfLMPTppKSp3kjp1wvM5AvqkpFbb2D4PamVQDpF8MFibUqJFCa+FCHDDJic\r\nFSUCQSm28MOvjeIT7TU53PBdVustuDCLWdzBguESUQWnb+7D+r4tec/MgAR9\r\noSz04Y5Be3iysb+bx817j6B+Icmfe4I+Lr2qdFGFL/Xhe+wjQW6xm8YvoT2T\r\nvV+MjZQUChHpr2K1uqH0ctQxri0wU6HLck4+b3uJNHp3PdgxIh4x7nDKyZyw\r\n5YEJ6ryhcxpidaLQTzZa5px455vhhS9YKawEtcW54pYe9YuNLBaR6Wf2j1+w\r\nmcevrhgZhD87WbLzlDHe9+RGL9ZA/mSNAKfktqPU8lYHeWnLz3mSxzP0w6Wq\r\nTSgNgLm27smhE6mlMnm49O3U9UPnWrFHczasZF32nemlDLjcBWyUcbOhx7YM\r\n0RxUAgAPydqP4YyqkZjXwkmet6O7kedyAVvEIfAmS+pGxgf7B1aJFEz8AK6X\r\n4IhmoARkEELVwxaI2wbFpjg22xiB5Un0IHA=\r\n=LDUg\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-feat.2_1654851226726_0.9690128461322824"},"_hasShrinkwrap":false},"0.15.3-alpha.6":{"name":"@flexn/graybox","version":"0.15.3-alpha.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"380963854f09542ed7842828afb988e00e60ca67","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.6","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-gVyzeym8rn9F9oXaf4Xw+thx0mZRNR4860H5DxOrjzCoN7b2HrkQ6HQ3WRCuF3ZDs86MXLsO19IDox0sYUqxzw==","shasum":"a8934e23de3a25dec6489716477096f6c3216cf2","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.6.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCmhvuY0cl6t6DzEJ8IKiIYxx+Aru99cqrmLu8wgVtgngIhALRen7DksfuKSYo7/9VfWyMSZ7AtTdtILA9r9CB864kn"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiph19ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmrlpg//SavYvirB8xGUAq+CLYkZef8M2AIHmW0JH9567wq+Sa9JLFFv\r\nnUT6VI0i4r5GM4SnPtONMftwsD5vwWko8HOsZmLi36pwo1xikbzG+7qqtBiV\r\ndN13b9cZU7Yy+YZx1AM10ZAXM7VxHE1eEl5zj0FqE7cwOiyC5plm3Cf8EIIT\r\nPiyx/kMMN/ZU34ssMmNGh9wovBVdjAalVRkSufo+IoFwly4nVABiD/FaY4vi\r\ncyLYDHcmiTm43peb4abJFMsFr8E30yrnr5NY6t/2RbvA+O4zAjINCh2oh1bm\r\nxDQ9+P5B0yYsQYAUrmfY0SJweN3b4WD7U6LOb6cpF27IfKqYmA7yC0Abryxv\r\n2WQaOG0Ixy1x4J4Iy1+tZnKkzZnRidcQLPKkmfRYItOTm5BAUQS35P/VYytR\r\nFYjNt2OpBt+O+wQZTegoL6ims/THAQoCz8d2KnBBc426okMub5LV2hB8UaC0\r\nS9qwhY/uxcgGLuucVGRDXMmY/YqpkYOZKEc1wsyYSMTRY/rm/ywKIySwBxoU\r\nh8YpaN9+JuHpvzyRex6a41BxP91lYVuvgs/ycEK4vIFfCkG7VNQxbbdlVevV\r\nfW0iBkPj+YcSsCZ9DkeXmF8mdBy5CluUYqZebyhJSMw9bqMegDUi7qbUYvIH\r\ngfYXMk+QFS0nRFOzGq0PGBz8sWtqIF3Ilco=\r\n=8Hha\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.6_1655053693419_0.3047342151981445"},"_hasShrinkwrap":false},"0.15.3-alpha.7":{"name":"@flexn/graybox","version":"0.15.3-alpha.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ce0ff2f8f889fa00d53ffa3355056ce40a5d367f","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.7","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-tX74O/fBFi/FiQ6C/EXYS1qfh6tMWBlMEmkmTWuVWj0fOhVxN1jvWyE5+jPC95PFexN3xOn02Z4wfbPHqC9Eyw==","shasum":"0b741dfe090b214b92747664dd97ad799ef802a8","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.7.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIHGHhFPLxEXWX5oH2iaMkxYug3h7NcyHAmZ+jnCi21EyAiA7egqRKRgugpK+whGZrhcMF7T/da8rexWozpO5aHsx/g=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJipiD2ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoCPQ//di3sObCGKVvEZhmkfZrViCYJ7UoYOygg9qr802tsiUCXU10Y\r\nxa06dewqmh573FGq2LvWTeqNfu/1FdmSb3rA6hTBfgaZr8rfnDQMAW+4YNnG\r\nejaS45RUCAnNYbJfXU5Q5UvFX+QxGtB14OCNqsEaDhtb/NuBhJg17sRsSPVC\r\nqA801RW+tUpwT1F22CUTPSECnKSYwyOn8OhV2ZLycF1rXQ5ul452H38dnP8z\r\nqZqh5AloQx62UJfkgawjjJGp16bvZsz4RVAYvOYW1WQqzM+3wXzLmyGU5qHF\r\nBgcljJfT6QN+u2ej2DsI04NKz7jPJz0hSFnuU4hqOZHNk/JS4zyF56OWD/kW\r\n0fMrZ2Xrh2z7vkS0m4hduF8P3F0omTxuQb8XtSPWBdZx6rTODvr64YALuAsl\r\nksCDQrJAd27DrGDaat2RIfzJm9APKVNhBKNqcGSoYDGnC2aUz1KoansyGXEm\r\ncS0QQcKW1Ylw+bsGef31qqgVTB+RmnuAhM1Pggyp4c107RT31r5cEvugmjKP\r\nuBSRK/VdGeUpHTiznAwTB4k0i99Lv3Z4pgDgOFBZkCou7M70JlL3XhvjpVru\r\nX8zzyUNvkkkUmkUQ1tp69HWjwHBmfIjwTPSbDvnHh9oHLJc3vCgXaZKAI1Sd\r\nj54a1s6iRGGwgupDqdR8GvDp/OWw1ew3GcE=\r\n=R2Dq\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.7_1655054582021_0.15411136013089033"},"_hasShrinkwrap":false},"0.15.3-alpha.8":{"name":"@flexn/graybox","version":"0.15.3-alpha.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"e9f537c73f8bfe445cb428e91cd64dced3daa65a","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.8","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-hcDmc5x1sgMg34eaBPwU8wea/1ygwluCyVe171XVz2qJZPsvHsZGOKR32PNemmi/tm7Tflm6gZx7S08GHESKaQ==","shasum":"d794a2a98826871aabbe7dd0dcf90bead7eaa230","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.8.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHRsaqPr9vapYE9cyu1pvYyVbtaFYCAAmQHn48d4ln63AiEA711ugmEuQFGrqL4nClvCItf5EsqReYch5SPk1tOtvt0="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJipvoXACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpXRA//b1NbxqHSsUedPCa8sDssoy5sNdBP3HIddB43ai77qZQVP/Av\r\nRe55nbQA3kMG7OsAkeGN0qysXhJYJUkSSdXa1O0yoJ7CBqGi1z63szrErr13\r\nb0SFMXgd4NOtvW/CZH/PeJvWug3HdLnf5jWRFRfCfSShBcBx2AfRdFfStur4\r\nwjcjh6QVPqmgEbo2GHdQClwFcCfI7IsyF3MABRRzru2/DRcSDLTQJu9TWSPK\r\n9BTvbenwiJDT0Jp7v3/Q71RaGOe5KzvYpQPnHVyhJAHKkYqFp5knpY9/TOpo\r\ngQ6ReTP7ct8t6KJ2YMHR9cswcLcmBQquBn4UlLWie0eh6gYwWHojdbK18ssQ\r\nulECNxrOPa1j+HMerHLWtH2rCjiSXaTdjkMmvwkbygtFzthzuGkNaHhTHegm\r\npdgTrdfZeia8yGDwagZweXQx9tDFh/IHwSu4tw+v/AmdeTEHflOqGXLgVmCa\r\n62NfESOQh6tg9mWxxS7Hwhes7U2RIZ+Mrvg2rlLbrN2nmmMcWbVYSFgUVvGd\r\nmt6PwTENK9FFUWMoDZPMOQn1qTFr6oEA/wGGticvtCO5X8UyKnnmGOslpWHH\r\ng4eRULFcxZCyWBOaNus/0gug5bREmCBOx8s9M6K+TUtMvgBbulyv314v9KcC\r\nq/TlFyiBWmomuv4Asu6ETNxKLFC1BHKnLvU=\r\n=zJ9z\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.8_1655110167678_0.27092532722346885"},"_hasShrinkwrap":false},"0.15.3-alpha.9":{"name":"@flexn/graybox","version":"0.15.3-alpha.9","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"568835b338d8d09efe6f61fa5c026bdaa200dee3","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.9","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-THAXay9xj4Jft2MA3uat3mP9hWvJFXtyiRcIMFSMVOJ5p+KFs968mX11qkx9yIr5y5DrbadFM5fp6VJlHt/WZA==","shasum":"ee9e95a9e4ff6dde8d32bd6c370a41d35d3fb840","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.9.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDa6VIWH38JgXDz0OVPhDKziszwC62KXTeZhaJ+HJ9e+AiEAiSyqF1mUMYpV1joVaSITchvZ5Xhv/nEiMZ0SzSchzxg="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJipwIqACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp76g//T5X0m0LXrNkQ3Dj+r+ohu3yNuF+TDi+OGXAc1hIXk85quIKy\r\nySbjha018D+1XeTsDgtFH7boHtMTlvuRk9zkuwufTBria8UD3IBTS+oQDuil\r\n7Lc/LmzF4KefYM7Fbe5KtKKIhjvS1jZRozJgOFp+ceDzDKovq+43VifI54fD\r\n4dQLev0oYAtnMfJQrWV2BEPTY3l48qLFGQuMV3qNnAN7FwDVwHQ+pgrqJlzC\r\nhFYYJ9Qu7rA4ixDK5r51/MV1AU7QPZTtnPRIOIF4y42j/1iQRqK+HDTRxXSO\r\ntYVW27c5I/6OaTMxqZYcSfM+qNlP5lz9ncurYw4rfqxpU+eae+G+9RVuGcAe\r\ngKhWm8O7N3qDBwCaqFAZU8y6D9vjk0658KZxodi0BGh5BeO1TbDyGU4O3996\r\nbUYALlooFHm9maPOtMag62QW0aN+ByOgHHB9xfktd1rIzBsHE6xvliW0mDgm\r\nHwtnzpmECPfWTY0oAufpZd5K4AgD3zzpp6RtVK7XsCjHyTOKNw97zVxbKr7t\r\nwFcK6H4BpqCbhSj/o7QYBIZdeP5bygzHI4lFcfKyEO/VT3ec3o/qF2liz7x8\r\nwc5oJ57bbPOIkG/GMms2sEXJDryvgl9Fhs8ITwBrp9+XKrdK0czVq/vskvW4\r\nlTp2k/hf8n06Q4kt/c7YsMrxAKuCMwGD76k=\r\n=M3VC\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.9_1655112234675_0.7976785237805737"},"_hasShrinkwrap":false},"0.15.3-alpha.10":{"name":"@flexn/graybox","version":"0.15.3-alpha.10","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"49a695c7b9bd2f842aaf508351f6192d7217c5c4","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.10","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-oOrhKqALsVV+TVoquPbzrgpLLi/ZheY9wxaclf2+gBXT48eF0tedHyiUYCCKbBecA9g/GaVDOC5uEgHdHZYC7A==","shasum":"a8e619726e5d6f032ed8cdbf116be7ebb354d3d4","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.10.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD2MS/7F/sOp+Dib0tJ2A04X3DOYxIjSvzWy8OmokI1WQIgHRKGDLaXA2sRtFVDdSOvaNRpm0fAlX0XbMjj1pugdPY="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJipwzHACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpOuw//a7EJ1lcavOkt4+L6c9iSZ7BqB+eOag8a51emy91e7A/UuaPB\r\niGsz4Nb56MYwJOsUwRrVpDZAXM2XBeebepnHrrHE8f9KSX+Ng9VxXzvlWyO2\r\naBRSXZj12umrWfojIQMxrl1REwXBJnt6sMmUFm09a1Pp0u8+En6/x8ypQlCb\r\nkUxY2L+MqkL+Dgx0o3FNVIa5h/2IWgsCqP3JWJBiMxZXVqoj0udX8Ny4oqt9\r\nYbkOgQxYohTsN7dNrzPju3gD7exkZPRu0bPILe4jVQnz1dq6EsM1ZYo7Y6cr\r\neB/RHpbs7fgNHitwSi0Og+DfHPWyO8LmhhCyE+2MKcjgx25Ltm0AdJC+U71T\r\noAu4mlN0r/pul1d4ys7ak/4zkoJX3nH9YPxYGrgU0TmsUMX4cV/iKl19rppz\r\ntqVeGGURfTFXfTuhWvEsBKQr3y0OINIS73YjeNGUedRkxxvscXz1KkZ1nmDh\r\n8KHbocmPql7b2yY6hoE15lAbyNSBgZ2FJ7WhIaPxbKbSQJ/IDniZhAO3SCXN\r\nDPJb1CnWu94Oz9mu8vHNLvPAcMg4hrl8UXlmm/w0xhIHUJ9tTLIRcsAuMYA2\r\nQdhpPFU42x+VU6vMXEHTPVP2g4YAq+32anflFRML4PbXFrFl5TEidTKQ6bf7\r\nBtpIidPugY036KyfvrCSQwr3prwNeTb6nqE=\r\n=7yqk\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.10_1655114950856_0.3754796567655885"},"_hasShrinkwrap":false},"0.15.3-alpha.11":{"name":"@flexn/graybox","version":"0.15.3-alpha.11","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"9ae9dae351cef6320846aa4823bb3df4cefae6be","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.11","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-5zTyn4RuUvud89QHPpM/e6QsO84/EfPJZgxHxp73lBQsytJGk8BglQPjYfr7OfSFqVLA4L2JyQv7NDmZQbbSfQ==","shasum":"adabfaa27d1438315e0e0d94e8d26c4dd25a48f2","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.11.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDKqEr+TNZc/aphgEjjCGVlTxWivbdoSBVc4/AHMzmBXwIhALLlzRXnIe4T8ighD+CkTfZ84RltMTIQk4c8ngmTzCJc"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJip323ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrNvg//d6hMnV+8lN3MxnA1IjL/5pSCZE0QSlR6h6RwTHVZfgJmPSG9\r\nDQs3g1LsOwwek+EQpiearVpn271KUkyHzTJVjevLhnD3CQh8YahdTukXpHB7\r\nrRqLXoTvnc1aIsw5oBQ+yJNgm+Fqzruvj/jhu6Z4xvt7FWUXnvVtHERg4IK5\r\nTpJ3+ZPsIebqpHc/6V1psndVvnvhmoHXirkzcWXe2Zo1E7gBH+H4M9OgBln6\r\nMac8Dozq/JWa0/wnkhv6d7NiT7VgMEpZV3xf1ylotZp25VJQRsynfFLMsD4X\r\nheHhhs4WULP+i92Cum+ibEUKN6zBYZQlx06JJcNRwWCLcvNz92Gsu7IDbeNB\r\nIePf2Z82aAX6lDZhhg43FY5wlsfMGiuoPHpFyJmE+59zOoYw57nK8x6scugM\r\n5V6w/1GSWES2f1cTrHEBSbzY7AndM9U/a2gj+GlxUmRBucdrIjiNhOqcn+1p\r\nieJszS8my9qxb+xJOv9bPmXYfX5pzVZ1Ic34hgJ3MLtaVPSnN/m24jyhDz3h\r\n18/fHokx6eGCIKEQmBM7uLqi8peRAJ7rOeNJeIpiiRGK2FftCXNcXm6hrhUG\r\nJ7F5B+DBpWUgPdiJn2NIgks57lcFoPclnP0oCN0wTvXp2yBBm0bLRdMTj1Eb\r\n3uwTI310r2b94TqKYLKgotvO4yMdSGcDMmA=\r\n=h055\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.11_1655143862950_0.5506835459211188"},"_hasShrinkwrap":false},"0.15.3-alpha.12":{"name":"@flexn/graybox","version":"0.15.3-alpha.12","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"43ab78f6d5ffa834cee99a0c553f790a4a3cf1f6","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.12","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-53WkFoBd9QnlMIqtL7xPLQkw+MTwUiBNtQVhV5+nBAjPEICQnQbICogwIJQQSnv7HmDQKP2J7oS1O2uuhtd0eQ==","shasum":"2932d9bc3df85ee16ace11f9ad36daba72e40d5c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.12.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDCIvEiLY5SPHkiKNgRnY4RrBd8MHYNxnkn0mfq9zZG1gIgausgfjh7p+WzEYwz869xPHaTt+XJ1CW9bvixu57YGEw="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJip5f6ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmr7rA//Vwm3uSmy5SKrijw2NKs/nlTCOQfUGvoJfUChlbBNWIwaNK0E\r\nU6+jmwKO0luznJu5CmxnYLgRdsJJ2mVhqANg5nFg28wXDL65bFREwO5B1Jci\r\nVt0yzld3opOIj/mBhvkZT9Ihsoqgy01P0MUVOvBDIPl1g6hM5jTQXaY4bGwP\r\niPMHWShuGit+dyJdIui+7UfVEN1P/QqADe6RGyvJvG9uZEmY7t8dDG5Rpgyn\r\ncO5chZGjgCWU/1Y99m1IMh74ctNStgQD7gZ/PJOohbe4Kx7RnFRNvxiH+vfk\r\n9f3A2p/ApvmNFKLNMlWrQ6WObZJUiWidoqQlkLt2fdl5oEWrB0SdDLiXWq/h\r\n097LAKH4djQ6CjYCFAjqktuIveK8Kr+QbdfTV1ddr0TbQIyoEVHr5kdeJTdb\r\nxixG2+omkf4L+YyrcizR5H+rIs209P308qvFsyfwJVqCDkYBK81KBeimykx1\r\nCIQd44N3OP511sCq7yAQyhMDfmtmbc64yDIakRqNRcYTzoZ155eA7rtJJw6w\r\ncbN/TBnOZdvfxmNGkKf4M3pXh7iIpL9Qnmwyl93KgpKSnGPn6C+GMrD8O9AH\r\ncPVhuoT+/tzEdOLp6GqW6UrL/TzLnJfE+X5WvelbN4eacQt1WKKVDWurmveN\r\nM8iPgdomH/OYM+qJZdVTVkOxfEaSc+sk97E=\r\n=ETfM\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.12_1655150585900_0.6260446648902038"},"_hasShrinkwrap":false},"0.15.3-alpha.13":{"name":"@flexn/graybox","version":"0.15.3-alpha.13","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ebdac34a88ac4bf413835a928d0cc9af6fac1053","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.13","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-qPLlAFwCvrRgtaDI4rr0Kbydjh2KI4vyo+0hX3+nPxyf5I+Bc3LICLxHxmZvzdchVxYjYlfPTL6+hXgGxp+d5w==","shasum":"85e2cd3104c8f7aa2f38003573fddf5bdc7f2ff6","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.13.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGeQ1e7/h0js8w21wObx2jwVA83tA0Ly8KG7gkofmW0EAiBVR4vrdrQDk+LHBA5OdTWTLls0Py22ILHqS0C2UGgUsg=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiqLXAACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoVkxAAiE4HXiDL/G1+7d9hRh5NUzWzlqN+8u3TqbjHGy76zdVkwzTW\r\nAVugbapH6MCs/3z1DCkFxzEsIX7pkXwwgBRedIHDa10HD2bduuxKs9QzapEY\r\niMxOfjg9Io6eRmyqX62aLTdtZNdYw+yYFYRIytgdc+SjW1qKSfm1FqYMsRxi\r\n7kFchfmf/0Kw3K4Um+29EgcXX2Wd41HGP1Z0KskytstzXdXAtTT9udk+7SXU\r\nz/TBtlHXPzTYTQMwEwNDPDk+Tw3tcWvoV6MtMydhXQHA3sufjqzst/VW7Win\r\nbnUfZv+6lgquhGr25E0P2LRty9Cao6c+wDUZrK+r2XZMu/rspQDduwJwxuEJ\r\n/q0OqNGdQL3nsse4GHP8/agTir642jNOhjjIvJ8IXNmK0GjfO9vaOCqCUOum\r\n6jtM9TlEWiIevSEuwiuGSIASPmbUwQOX6AT7RqTiYByrpVPXwEmv4mRbsI0N\r\n+SUrT5WOYDV6iYhvFKQFhTaOX+9/xND79TlK1Ot8/Zf46hIGCmH/cb2TZOdD\r\nczTpN3vPXol1UbLAL99fT4JxOiv4KETgsZlgPR/pnR0lHfSxfXXfTYbli4FZ\r\n7Q03f81j5c4sZ5/wKdkYQOeL7VIDHOnBqKuOjcCbD7d6JfRa3dFpU3JbyA/S\r\n/4M62KhgalmIgznhyIhSKttj9h2RUuv3fQQ=\r\n=8s39\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.13_1655223743927_0.10566006349085466"},"_hasShrinkwrap":false},"0.15.3-alpha.14":{"name":"@flexn/graybox","version":"0.15.3-alpha.14","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"85cd0f11fac6d2b358c573ce78f87c347cca1121","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.14","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-BvZafDF6zi6Wroc6ZpdqFAHBq2PMo2L8y+IcA81AAGmo2p4iuDeLjcaQw1BFQyYQ8cl3v+jQuReQAJZM9a9e+w==","shasum":"2a28f5a3c587cfe9a5ef655a0260175168a18287","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.14.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCeDlA1khRYUXhtd4ws/Sse6FglSJ5pHCkOvc8AODCzpQIgfURJdvL377zslbc9JVGasBbRUG76HzJxG5lvePWtujU="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiqN+rACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqL5A/8CnBdwVZWHZQY72G4Fv6C2p8zgFlbeEe54DZmAg5NG8j8WhTU\r\nbN4QfXH8c7WTzDRRRoRtwBXKtjHbZxC0u2n1TaSu3MQ/CP/3goa+lYu07CRk\r\nY0oMe2euJMc1qxKiiy3SHCt+RlT0Aik9f+guEuk77NZcCJiK8r1oBIMWUXjT\r\nBfKE/jSwGtecEYbMJSzULPXXmqZtMHrrCfpmuRWbTHGdoJz42uWIBRoBn5dH\r\nmDg3GlTFBWTrwO/HjFyP3N73INliYfMTi3OhJ4lS43WeznaXY6AbXWAplrjX\r\nlhuF+kG78r3JOOq2b56J4h7l//MD5PS4SXA3/NaQC7KDvxt42K3lzoeWOomr\r\n/1pboDuId5egf1vTk2NErnzGc+LACFdnQQZgJaIY1WRMvq5Mi8BdeUpY9LwS\r\nLvxq4fw9zSSLTnWyCTxBlnKjsqHCs0fPouhSnwTti9uMpsFcXbnRXKzycJN1\r\nNeIgdozoIHFH5Ziqv5/PCLPJTXvtd/kgD9anzntfsK2bjsChAjwetnQVGNjJ\r\nH2TzACJwP0dktpJTbIzEJnsHHOz9qkZd7HNhMYlPPoj+HFktgS6lpdMYiDqs\r\nIrwe9aszybBRa2JQxxuUMWCRWA3N9EDUBj+nRYs//ieAPqtWHaTVZo5+4VUL\r\nILRyFRxhTzBGOb9eQfcBYyHMWklxuSkfbks=\r\n=0sC8\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.14_1655234475349_0.1472475251865295"},"_hasShrinkwrap":false},"0.15.3-alpha.15":{"name":"@flexn/graybox","version":"0.15.3-alpha.15","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"9deec3a3bd484b7641865b0bb84af825e46ef258","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.15","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-ie94prERR5+yKeGDf0SdSHS212yB5H0yz0/7BrfSQoWUXUgkm7qh0JYN+BUd9seWEwHuQiMLScPs0/gucuUAtw==","shasum":"205a0be8995fc7c4419b958deeae8536184a6540","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.15.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIEoXOa4749e/0KBE4N4MmFIi1zA+D7cNht58LAA5ehRsAiAiQ9yzYzqmKE/PpXdzEIntTFA/lpYFOfZVct51JW8GJA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiqdO1ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqYxw/+L1cFF0ibhiMDuBk/nLNthZTz2Sjh1/BQWxRcBM8BM4Vau/lP\r\ntT90iNKW/xLMSxn5LGztyAIeuWrHnHMuV5tl97Px8CJSwtIPaaLDLv/kHBmU\r\nt27YJ/1u+iuxKTPcD8ACg5nS9UZ/bnJ2QWfAFonDh6Ik4cdJs+2eAozWfoCS\r\nj42A1FEM2I0aeaEVK0rbwtoMG7Ld3p7oQosEmon02A6bT6tA6Tx7hvUn+aJX\r\nCDecuburxLHFOPpiylzrUaQ//rhnydoDQkgdjA+o+azD/OA0PSHNIHgipNVc\r\nM7OhHT7HnRv8UxY4SOaxZymkBGKYkIRkePed7bSewRSeUoIWxeVwkaXwYS2m\r\njHQ4MAxK+NIL2uK6vMe0WzfcJ/OSZm7bfF8+NUEJr7UdgEoqEj2U+hGr6d5A\r\nwoZofKRh//CadStToYOew4L2rsitm4AEXCYivs4COpbip+lO0aRJLKTHGLEK\r\neG1G6Fk/w9/8UzldHh02mgQEDdYpwrC+Gce5AZY9TuZzy+aegYUbV/mVWg1d\r\noGZUmJuE/li14TVeXk3IRqKYx2OiZcYGWKHKKwmfn5uZ5Nx3ou2cLXMPAejv\r\n2OFqjiJdTXYYXdN4k7chIjJyPvhC2Kyg5ZodrrusCIWgaI+j1c3dYwZVj/Id\r\nwbsB42HNl3s8yUpD5CwEHWFjCJ5bfwIEfsU=\r\n=KAHs\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.15_1655296949568_0.27209666514749387"},"_hasShrinkwrap":false},"0.15.3-alpha.16":{"name":"@flexn/graybox","version":"0.15.3-alpha.16","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"31feba69cc622a1769504bf78635b270ea82b6b7","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.16","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-TXHxpucIwofGxDrJYuaBnTprdRV404UTfMbOIGeN1hDQn0NQy5oKaQWhRvkGd3VqkwpAEsytTAP0Hg5AifWrbA==","shasum":"c5135d5a9e6b7076e8f6c10c5a9899958891de78","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.16.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCThDQDzPfEOtvNTkHp+N80V8bf4OpOYX55XGZPPayVTgIhAIISaXTTUsWQp4OOrcpTSCA3PWP7CryUAFjM8M/T5Le7"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiqg7sACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqZbhAAl8CT1y0ekepfFqGVvCIS2LdRgGT67GUh2KgsoC3i9CHwkeg0\r\nGtdKv5CICdEy8YypiPCTq74kpWrqbAiHUr2vzvYkHFEYldqivNZER+e6KlV3\r\n9RFe8D9clmgpijPIfxF1Ii+WeQBo/IJlgG/DA0Buwm9aiRVCYdVPDJFx9VS6\r\ncwYam+F8DWvipboCCkt2JI19Wl+FEb19IngwLsLsRYZHVeLovj0PyyHqj6CC\r\nIKRF3M7kz/YKTBuebXpvsBhUxORBXU2hzWifrXfCKvXpQq8JlI1aszzalL1X\r\n8n6IYDS+IUJPIF4QQy+nDSBOIHcFlLLky+gusjyaNCreRW/M2NYRel3SyqUX\r\nKvxgjlwg/G7WR1zBdtW6vyBdHF4tiguYsF5844TYUcjV5DVgDT7jlQfLcPeX\r\nEiqB07+dXi7Tz02DgbQETIt0mUbeWyfVHZuVYBbJ15KgaRdqllDtabbSA9mD\r\nh/AZUeUWRfMmpbZ3SzTV5HI1TC6WMWmMmsx6daNTZni0xC+jGm57CQXb6LXI\r\nzjNlHQaka4s4uiABgCeGbHO3KamVJl/6CH7S2gpMTuXBhrSBiS3nneYRrqSy\r\nFK3wY6LNr1aPWXHh0nBQH9V6sB7U9QcwEEg6Fy+neayg/10yfTGBlgdWDYQk\r\n2fAqkONlVndCWN7Jk1oMcJ2mw3bjmZidHug=\r\n=g4SJ\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.16_1655312107997_0.7529189148104154"},"_hasShrinkwrap":false},"0.15.3-alpha.17":{"name":"@flexn/graybox","version":"0.15.3-alpha.17","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"acd86fbbc8e23817a59075b12ed7006aae6ef8a6","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.17","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-r5mQL4jSzfpcLy93u0uYdzkbMpvwfRW26epsjES3HnH5gbTU1PFkrPIOqaRgrKIP2YpO1kQHSe2JDNy4vV52yw==","shasum":"1522d80811e21531556ef0a758ffe09e87739ca3","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.17.tgz","fileCount":43,"unpackedSize":87315,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDkMyhO2VOlthiaQ1REUpYHoAYP/RIKYcpENX3xF/IhYAIhAJVacB8wC+wuFssGmkXwd8p4Hwnvc6l+Rnm/GkQCsrMO"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiq4sqACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmriAg//VNctoRqX/I/Y+VRbFz8Co9N2Ra/bXcmS4KKd59Rq5SpPON2u\r\ncO35Uj0lUL0j8ZYHHXI5MlNgJNorNq6gK/t7ECDUbvHgsxczhyvYq3QMYSpR\r\njKvea56dT9WX6Iy8IBbnququHJ/C8bwyxmbC0Gr1SMqwPS6b5cSWNAAQc84m\r\nJIWmmmUeyR+33k+O/zHkZINLzz5E/gitLQ6YeMUg40F7cZ3shigrHblMcjIS\r\nCqI1i57pq0FZ+DyebquKzO44mZLjrRQ6PFNcLKSc+JQNahDmTsbetCHdKQ9c\r\nh3e5wg0IRt5gmsqon4jgwaCDK68TFGgrjiVY2EZvHYwVX9rgelXhgTmcbYuY\r\n+aQQrO12btkbzmlcXczaqWzw4iDsF2QT0+OLUhNPcT9Kl+kKtyQs0OtnYgAq\r\nG36Vnpp59FXK2mBwXvmsOUDY4WlexkbWyZiXM1UWT/NsVS5XmF6bsuHk1UEf\r\nzYxwLke70iFr0uurkv2eht/kcw3omgJPSVHawRqCByAbA8kgpe9WS8KT0rVt\r\nvbsQ0JQjsztV43LiViZxhmG2Zpg1p6T0TUapJC8BcRV4F+bjjgDF30QNb+xs\r\nWSyQvjK5VWr3F9GB2wo7OGtCaCa6/7igTh04nHNDyLHqOq4uqqO6Gc3ROJfh\r\nBIprQnyvp95674TwSUE52SiKuT6qXKrOclc=\r\n=0yp7\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.17_1655409450499_0.4925969851701901"},"_hasShrinkwrap":false},"0.16.0":{"name":"@flexn/graybox","version":"0.16.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"02c7d2da882d234ffc35f51c3c059eae2c42ce1e","_id":"@flexn/graybox@0.16.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-QRCQgdesAaS85OQYB1F/Dr/OXhoWk1atlHpwl+wNvWWlekVnnTwdB66ZR0WSQaWDCrgXKnOgDKKaysKHychn1w==","shasum":"df37fb492f2a91a6025619f1db50fb2152ff2a1b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.0.tgz","fileCount":43,"unpackedSize":87306,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQC4+5arGuYMfneOjUkfkPDdvns8h2x/XtJr54sfaIa+EQIgfIZrg2m5uInaOEAjUpngnIL8RzVDBx0tdfMXeoKfHoA="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJisFAeACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmobrA/+NRvyTkgP7eD1BhFz9wD6i41phulRhNTJA0EsGelAgRlTSd5u\r\nfOo60U4jYA9XRO96h2GjhKJUCljNDF/GU1Mp8VsdOPE84pAb1pbirHeb9sCe\r\nSnf1UhnKihQODOwsr+cBF7OlaEphpmatPmZzxFPJU/8dzRham7+mrAuwDh3C\r\naFEyBnGqIEdSMWSRYkpA0mbfOvVbj9LR1RNUBy/fgVrIPHS5hYzEeSxujRgL\r\nMlLTVIkTv4fMiT7MLJuh/mp9TwH/7GrFKKQjFGdFFKXMtrK5glpO3SEQkhmD\r\nWdR0KklBI42mC4RxJscwGukXxkHUAPGbWzqisDPDaQ/m3BoSiXszsI3VhkrP\r\nErBBLaOZwOeRcM3ZScVdld/9cnmzx/bmrfAAH6tiyKKexbL4W9yM6eKUAM1s\r\npk+PWc3WKSO6l4ZtvXzVlSfm99VUlU+HD976NciHkZnBtdcY9yQMgCu+eRhp\r\nALHTb06alflS/xU8ncqPolvzO0DScxva6SYTWclwf40QX5cHjKL0F8FYiJLl\r\nMHjbB79FgRkZKHWpvxlL6pXhCoGndlOf8FKCs2HBG9O4V5xgzE39SlrVp7Rr\r\nogi4iiYUW6xQKF277cc/65FUu3+k+sFNii6MQrMng8UnBqlkSi3VQg6oHxkH\r\nhS4zyzxCySwzTRGwOXEM+U16CfYt7XGcjE4=\r\n=Iisy\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.0_1655722014294_0.6839865813299884"},"_hasShrinkwrap":false},"0.15.3-alpha.18":{"name":"@flexn/graybox","version":"0.15.3-alpha.18","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.15.3-alpha.18","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-s+nFri1nchDShcMf20QpZsirK5LgH1SwDpfB96ymGtzyeNgnzR1avSBnsxm8oRcmInEBw4CEVyJyWeAkI7CVRg==","shasum":"664dbc9a0047d8101a05d5da40178b817e8df738","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.15.3-alpha.18.tgz","fileCount":43,"unpackedSize":87706,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCNqd7bC9Vtxa/mUmB5V+7gCEPsy0H40Tr4m2t30NVXqAIgEBQ4NYWcJR0FdyA6X0fbk6/MrFuCFQirab9MmWNElpY="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJissRvACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrJmQ/+Jtg4Pe7DG2SUg95Qn91MzpSevHLqtZxYZlsjXA0DVNFKoOdS\r\n9C5hU31kYkqE1+TneYPoyg0oaMh/x8lUXOsaZKceikILhRwXwRagk6rHSAYv\r\niG1VX4k/qdgtHltCt3vLqAuZhmw6762a2viAQ/zXlUVzxRDVXs7rlwNAYMxB\r\n5eMqXmEeadpRNZnvh+5pbx5/f8OJCg2ZfE03tboIOVS3GkBxq2FHJWRuj+Rb\r\nDEneDjB6m3NW3oX2R4YnW2sH8JdpKK+Ec65iqxuCxt+T4Ak5GPtbAdA/BvTe\r\npewhkpFJ9IjPZ7N5fV90Oi74jsQ7rVeh0gD7u/xVxTQ2PlO9ulXMLZtnwsP1\r\nw7mPJjWLKdg6TGeWLwUft6JiQ3OD/F6rbBpAEVqIRgrXu3jFsra0ZMuXamor\r\nEzyZ9E5sBFkSXSW6FVsqe1Nt8YK7hS83T3Zezjxs5Yi4Fmv3tIBpcIZVm9bG\r\nwp0f3iH5vQfwPYwxwXEOCSV/pl54EXhvi6akZm8YFoQxSJtFAgnM2jJeK958\r\nTnNsSYuRzuUahdM1Dmtu4mve+BCbNpGmZX3QKgZAuW1aKwYx/zEgKTTC2ERr\r\nbzV8WsvRg/YUHphiMT/joKH77YqybCRN+3YaZt5hXwNSTlA5YA2rkr1KXvg6\r\n8iAKzfmUPyPCHtOnLr70A5DBvwyqWbbnM2s=\r\n=zqKL\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.15.3-alpha.18_1655882863764_0.9536663296500201"},"_hasShrinkwrap":false},"0.16.1-alpha.0":{"name":"@flexn/graybox","version":"0.16.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"f48663843efab518d17371c6ddf9c30b3d6f1098","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-alpha.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-zGUrjjv+rt8RAIHwIZYZ7l7Zib9x31J5rQ410U6xeXl2JmWKuhwj7FYfkyGAZqQEiAkQFYf9/YkDLf2c8xTH6A==","shasum":"b389bbc8b6fa3b2b35db8be2e67001eb5d161d28","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-alpha.0.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD2as7rvOr0zrFy71PPEEnsjiDzx7pVkgAm0g7zdnqKTwIhANyM7OWTRlgkxpRea2RBPn+xY9t3NoGZ6ei4e5JZzFeN"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiugB1ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmo1+A//TLL8UWjuC2zsRDgx64flkxyPYmyGOUgnhe6O7OlmwsucRm5J\r\ntiRYttIVPBZHa8vi9UWDqo35RSOzI/C9VXxjF55SiHdzRYmgAJz5BYJEIttk\r\nrn7R6wAuYJ7llvfzFpmPG+i9U9HmuPhnDRthD+ZDtj8KnVuSjCrNP8vS8cLz\r\nwL+IHKdf3/gJQo4KVBUFXSGeUTEKRhsAJEur6smBfotIyu3axEousrup7s/X\r\ni8vKCDOEkcXSpWx02oACvSnCLrzMtxfbtFQix7IspK4bG9BuewLHs4yDmxKV\r\n+vuZ/p18HnJH64m+EECwDrMfrUJXZ4OASEy7QU3H/uctmeAVqfd5/XLGPD5P\r\ntQFwyBIBFJmlg2Lr6jXDPcMv7k0YNYHOdwg1MR1YYgTMLT+MJtrJCIrxtj/h\r\nWMDXn2QgwQRHMumgU8I/SP9kya6x9a2KS6dDbI50YGABSe9V4024y3J3HZJs\r\ngEpi0Q5KYPoDeOhTcNLwBaRX6MVrvhkDlPO/RfNPNI/xtfAjiJCqENgXXHzR\r\n3XA68i7jR1DIXcmCBK6irNgds3WYw7Q1Vh6C+oyaKgS6S69CTvFimMZ75fRE\r\nbE/Nmvmqcz6lftUkmnMwOEFtQD2l7E4+fYe9M5fhLFL2E1qMom03MO30PQ2b\r\npi6YkPRcFWQdmjJI2x8/M+MFHSsn9uZuoMU=\r\n=4jrX\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-alpha.0_1656356980825_0.7398669616713791"},"_hasShrinkwrap":false},"0.16.1-alpha.1":{"name":"@flexn/graybox","version":"0.16.1-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"e758cfb42114e894195ec1470cad0f06fca17a4f","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-alpha.1","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-uBhSPF9YHSZ/muP3zkjvGfRE7VfQpCJOwyrEdEDlb32UvYU7ydOeh5BCqZP3CoigYJEUe+L4SoPOK9mcG/yHFA==","shasum":"73cd60fb6941512a8fd0a2692268f48e771fc5e4","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-alpha.1.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIAHBKDTypP+u8BfGcDkBLvntKEGJFIQ764Hu43eqhsdKAiEA2x7C9sbzZ5TTCtqNe50UvqkJ8Vgu2QKYHCtGP2VabW8="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiugd3ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrEdg//dU9Oj85Up9XeV8WtDbCIGsWSzuES551b4/1T2aFhmxo5kXli\r\n1srs4iCLKPAGR+LZlXYM/Kg0CZMcu5X+3tiQ1LAv5Bn4f14/z5VDLDcLHUB9\r\nlQ0fQBLmnjmiykAlOmaqUhMGikNzPnQwqrNICqHgupMkw0WSWphGQwUEreIN\r\ndLmHb/nFpn7u1OqKvKZm8B8I/U5zJ30jbjTw+5Dao9GHYu6/ts9/il8dPlca\r\nASnJMq2rmxaU5dGBv/fxWi6obh9wTSrR5cpoPpCQnBjE8BM/Zvs0UxXhKz5Q\r\nxoz3JFH1TFcwN0xn7+XiwH+Hytql1xnocEoCBsnQkmMlRgYAomfXH+7HgWWw\r\n6luPF6niJkZM0w8KU/f+7ZuTQnkPMYMHwjA4fbf0N5jU9uLjWSpIhZS/rw6+\r\n9Gh9k8M80lQgFvML2TVeAUJw/rpUYDcEUp+bYtBiS4bPC1AIOmk9yC9M9Li+\r\nI0/iurn1kYU7dowBodHQXIQTbXDZGV+6ghI45cb604Y4OimhDD67DsYdLHuZ\r\n9AJvteiQL9noOt7p21gDMWlQ5SwQegCiwfhwfiMmjVSSRcuPXp42qZpYSCkg\r\nzOtpVJyBdt61XNyxGGYXtjSUsSEvcZCb9qwITXwbcOkRcOhzdtFTZuqh6fYk\r\nALVspef9sIk0SmIhKDLL/n+IJ6u4XQK3s8k=\r\n=CYhw\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-alpha.1_1656358775652_0.9211654375514609"},"_hasShrinkwrap":false},"0.16.1-alpha.2":{"name":"@flexn/graybox","version":"0.16.1-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"226f7c06795781f0abcee27097c3232b0cce7712","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-alpha.2","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-O71hc4uATS9WyNCJpfAealsc9jluGgexf5XqiCE74tDuLxF8u9c/G4Y36rgK2YdayRil+Dw6DZByViKYPPHcSA==","shasum":"8dc9f3d021360dc6768365d53581b1d4a66e6b26","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-alpha.2.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC/sAGyFNpAI0sbnYscXMG3TjIY4o/JeEJkBG4eGMho2gIhALDjysEl1deJ3fsAZw0fw/VMzTEvqn3pMUhGE/tZZNKa"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiu2Q0ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpyDw/+PMGyWR9urcR/PUyHKz7YEZFhMC9i3EGNE756G/u4qDW6z7LQ\r\nroGF1RM4O1Fu+j4Gq++CNDqyhAJ0gjhaZxNoTA9eYtmYvY7+IYK5//GjTYSd\r\nQDxUgL4WoduVVidb6uJ1bdG5ALaXDvVg1gfgG4K2hgiyGkn8gWBTW2h+SczR\r\nZgIQd0oklxHMcQcSPKpVsvIw+E4r8am+RWt5MGUD2AiRfOiVnFnPP2eHofHE\r\neI7HlL3v0BpY0JuFJSn8cLi9b3lTDQ3nTKAAZWUlYBmP1U5VepFRQaVXMXuY\r\nURmfQ+y9iFGph+QOgUFkwyS7srEFqWJR+/KP3fXOOPmJU8tUJ0R6OfNcQJiW\r\nElXJPXdNNfQfTJnYEXD6cZaQaHJKU0FecFbZYDHO4eiLxfoT15yc8veNREm2\r\nDCN+DEzwsS4LJrrlgA3Tt32e2/a33HSxEqaz2o9t/pksLgiwF9qs6MNBQLc7\r\n3nV6nZFDnSvTG0jL6fvvTQvLzcbHjqUtcaO9rK6wBvLYB76w7g8jU1jaaKj7\r\nBbSQ4h+LIM6I89Cjum3aOy/Pq4SGKaSbwAHsbOQ7zavxPxK56JHMaRQoCKVd\r\nuQ6sj5Ew6GbWHw5II2D0ZsdOqszK63HUQYqFPzyUKcDNQbH3m3yAa+cXMM+A\r\nhaarX4LcZEsGvLVfB5KQ/7nRoh+NwZvCj+8=\r\n=qetd\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-alpha.2_1656448052478_0.6214012715736323"},"_hasShrinkwrap":false},"0.16.1-alpha.3":{"name":"@flexn/graybox","version":"0.16.1-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-alpha.3","_nodeVersion":"16.14.0","_npmVersion":"8.3.1","dist":{"integrity":"sha512-CYHFQegOtIwpHIFqeOWhzTMXHyvHyRRF4ld8l4VvT1hTQMXOlE5xVEreLq96VRaBpHjnZslBO68tabUfjl+HfA==","shasum":"6cb328b9f3ac42bb6a891c2194f1af877a9147b6","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-alpha.3.tgz","fileCount":43,"unpackedSize":86551,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDc4bJuQ5Bha5wgDDrQlllnJBtg+OVu0yjhZWzyZGTX+gIhANYLboePR02wsR8rCvQPQNK74eviijxGbkupgkYXNBYI"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJivEJvACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpN7xAApJS2GfuRES6vJ+INKKV8F641rUX6mKrlTPSj+utL0KXg0drC\r\n+13EHxxxkd5PnWNvPvz0w7RPCcE2wx83vpl1wmZ/nME/7f3fRhlhe6ZdI6KQ\r\noyoFA9k0ojtsctkm+tAsfjQOPb2LkJpEyrHybhwTB6Zx+JN33ASOtub2w889\r\nxXz6puEtO99U431VPkt3DfvDpOMT67xl7Yy6f4ua5+SBtGX7BD/Px8xM3BfD\r\nrVKi3zz++VFyxf6FBS864bFyGpu2gZvnhNxhylgP3Q2KSNIum7ozw3krmG3+\r\nRx59m1BhEjxutaN1mhn+IkzYiNpAO9YdML+72vZbo4Sh0h4Sn05Ocu/DWUda\r\nWzcv4AzO1WOvCdoKBWDdVrZwwCFUAqqCzXR//4m1x9hArLHoolzxEjcU0Opq\r\nMS1r92E+SWCjNu9QG9u0J36CO0fttrZ3VaFJsZ4Wb2bfNuwGv3KbY4NYjhTk\r\noRZdteR3tU6ntq4ELF6utPeOelt9cye4xQgGTN7honBH9ghRf5SiUpUh6Pgf\r\nYlejALz99ti9X1ocA1/5j+xK5g5xBN8+pcyPhkdk2tGpeIOBynIWtRtBKGn+\r\nFssLbO7IizOwGnD3xnVeXqEXqarj6mMGHZqbyAVFGl5qUmgRz4KpjjYzFslz\r\nOGbC5WXzUWhGRu8ri9ea0DHvo+kuD2y8Igs=\r\n=iIux\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-alpha.3_1656504942856_0.9359663144191954"},"_hasShrinkwrap":false},"0.17.0-alpha.0":{"name":"@flexn/graybox","version":"0.17.0-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"495767cd6b4708babdd93b192ba8b51e5a68c25a","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-o0vZOlPaLfk1E4dLEVqwhIovJup7Cw1a9wQa1ZWM0/5hf1f+RRL4Tq+F50rgSxoHy60o/0Inxyvnq4+17J3vfA==","shasum":"3b0f91182df5f8db7ecae84175c0fa506bfe44de","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.0.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCICfPZU2U7ztiwhk6ql7mv4erre+jqqXO3RB/W2Ma9xT/AiEAhFy/9x+huesERewwlkFxCC4J6uYYlsjKGze3K7rSKX4="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiwgEZACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmpbmw//QICHoThrt5U2Tdh2mKeoqxiAX6Qax5ruZ0BmeejpLwu39qHS\r\notmlYjDfyNju/1ORxk/+/aGHE/jzO8TvTREz9bgmdyqRz9bM23WBjuLmp1Qk\r\n2Pg8eOxPjrmOxRj5pCHQ5j0fjbF8SnoAGjPAnadrnNSPNSP0FWeSevH2e6Sk\r\nY3yeel8mx0zLYryHcrSlfrNFgK5sa6t5wIla/r7pSL4cpjx9nyu/6uR81XN1\r\n0t72k4ODLmZuThERzOuqF1tsACAkzmMA6l1dF5YuE5QtyStWSqrDbov01gjI\r\ndx/XIKIR0CYphfQdqESsFmkhgpBOXnijH9ONHj4FlmzZQZ543yGMEXsSBP7+\r\n4xkJpVtKYGpttGoh4XjzgDq5GGgGCF7cjP9/Scj28zDvuCXMOxD0QKMNoerf\r\np1aSJcRNDmiZ9ly2PJvjTKMl4IOtnmbdyHhVTSI95G64eRhyvHkcFT8h4jFa\r\nrQNm8Tga2+XYqN2Z7m+2S52bon4yk7WQ4cuNu0LohhtncS+nHiYrs1CvMkSt\r\nvR3G95deOLstZHXIQWAPfnZxCz1mCnZKEMdTaSt2LaJLH1iN2muspEqqb8ry\r\nzW0Nxsm+8H/Wtq1DHYupZx6qeuvj+9mnea+GUWMvNVkOMaqauLJQCKsk1JPl\r\nX94QyhEjCva+8PruOi/8d4uXAwySaD6cbls=\r\n=Detu\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.0_1656881433551_0.11583264515893288"},"_hasShrinkwrap":false},"0.17.0-alpha.1":{"name":"@flexn/graybox","version":"0.17.0-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"c9e7cc95d32900e4ee91f775b714cd2498597884","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.1","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-01xVW0M/ucfFmS7wS7PLRkjCGXIzbbPC/wNA5cqiDOi38G+Ps9GSR8WkeR7kEvpJdwus9pTZ8iEhlEsRTnK21w==","shasum":"ad0adbf7ce90274f37fabb7f2a6950b05926a167","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.1.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC73ZgS/ffW2swjwHHtnwKh/rPyxEl55m540CFLLkXmGgIhAPjwD59nxhtOhOy40NrnEv35c2t0lW9CxwqFtQfBPYyU"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiwzL9ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmq/tA/+NVVv5fWFKhNLFfMJQElLin+xkHYTcJDAUImJntwjebkud6NR\r\nQELAw4e9pS9p2NChE1Hbcjje4GFAJHzr95afg+cv659Ek7fzB7nZQq1Dl4NS\r\nDl+2FJsP7AXhIDzzZv170gEkVzOGU0j8ZTZpuVZpIknZr6yPCqNocX7Ggk8N\r\nR8q9Xp/c8Gfhn0SqfR6LMoHv56Xti8uwD1SeT2hCSk7in3SMmazYsmTowaq/\r\nwIWAmUJn2HxVOFppdPFJzFw5sJMyDmyLyptqsyXDD/ySMsp5q8ie057SLDZY\r\nEFj8f1YYXE23ANWgYcntTErsbu2JaxaXBcVTTwNeCcGrxB3gpab8eikEAduS\r\nUthbtqa3rKSr0SjgX4ZPhxCFTn+OQo5cKZSPEFYOCRetnGOGq0stzhshdabN\r\nxP+xd61ixUNs+bkGILTnXDFq7HAN0iUmxaoCTu6XZICHEjrl9ytLOooHuYq8\r\njUurHZ6YmXkVteeoeMT8dLqDMuB76/lyynmVnWBc9AyxQCEnXwJseSjppqD1\r\nhzNs/VX6i8HcOxv3F7MqBEUngOf6e7S4P1tLbRgjCQPmLZ6WfXjgoWOt1JML\r\n51d5GUKL+Zk8cdRsYxxag3rNCrBHKW0+fSMmUJXO9IgtkpMBeoOJYqmonWZG\r\nOevB95FfhQB8r0sWNcaccH9YbQSiubasgnQ=\r\n=EWL7\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.1_1656959741001_0.6143059409154632"},"_hasShrinkwrap":false},"0.17.0-alpha.2":{"name":"@flexn/graybox","version":"0.17.0-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"8c7fb7f88e325526dc38a382bb99dce9f8450453","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.2","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-qRCiJMjbzS7jXhDyTYlHpGMzMBGnf9OjqnvO9TTYHvFlGQKm8dmpAYS9++wfD97pn+lxzz1rrzjetdEb66ehvg==","shasum":"1c45126910dd55f3c9bbd405f53935c65e74cc9c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.2.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHkTB8EuS3LerOqwhYCUfAqBJNAISkSMpVoYw29LYrmtAiEAw5CHUQ5hDxtw0H+jcCebcXV6ZWcSOdWIkQDwDMdw/NE="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJixVwGACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmo7fQ/+J7cDFSlI3j0cIBeZJi4gPRywlfcCtVymLoSgDB3odQ96nQeV\r\nIKJeZDyCHvi+6BDN/UIkVJiBxDsBKahWBQ7cBbAy954p9Bd8UuIeFXCPXI2u\r\nB6rQ9zvj3FEe9W4fXPU7267e/LZyWkrHOoZafcnaot/rHKRlBYEiZ6oPWXrh\r\nfPzbUa2HyuIyPvj6ZYXT0qiEiZKxN4MfzEDucZ2LuFUsrpbOGoftdn1Or4ty\r\nrgXNZ4s+bv+U0BUzKWoeWY8F2pA2jSb4dRv1zlkZ3QrBDMmhaHCfBkwJsfnX\r\nk/rl3nukIXsL+RCXianWy9tQg4L2IxL9SZ2V9k4ELdxrZjJDIWYZrxq3mrVL\r\nIEeWlGApOiWWlADuGWk6y3CDlecv5P8ysoLqeSvx5lt5Z3Y98V6AJn6EXxk/\r\nmOIydO/zgjZWxOMO2iRkeYHs85emS3+vYiq/Zcd2VofhuGUJ/JWNQqRTJ093\r\nGyrTcff1+YNO7ki+f07qY+MVNGNbLd3mOV2eqc54oEkhVSv3cI09sakj+hlw\r\nGleFAnZMsiVcZkouV42ryIKbTITmfa5RYZ9VmH+sWy4NPVGPehIHhkiMU6Gn\r\nxcaLce+WBd6JtZdDNx23ZLg1umjL2Vx+ZGztmvaCu6PVgaaINnG37LJ+Xnby\r\nEGSPMI8dH5uTRPON9t4svSv3SdkqBeoW6B4=\r\n=YTsz\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.2_1657101318332_0.2704174637425085"},"_hasShrinkwrap":false},"0.17.0-alpha.3":{"name":"@flexn/graybox","version":"0.17.0-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ebb078857b2ea578318f4b6d617b559206c8e92b","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.3","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-e0LOs5rGDuJ5StglJ/RQP4cumEgKEZEmIDtw+v/9Xg7p/bgHwAeqrUt2f0Tda8oIJcdjDAcMoj6WqBg9+zdXEg==","shasum":"dbb9950c8d33f499a4ba2b8d0f591cbb9c89c93e","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.3.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDeqMhKnfGOCuxfiIVCJrSBzDsKsgt9jYCWrQFSaqfHeQIgCYYWwp1lqtQipseYCUdrbQGQ7zmC5kKNdPOxFjOKkc0="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJizJsPACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqjfBAAiPgMg83yt9USL5ARVjkTl5fSO5qEqN5hpZqrC4HW2zdvKEIS\r\nTaJFhr7m2CSmXGjH8a7QVErqU55HTcB67vjssKMQp7NjY9w3mMC11Lfnw1K9\r\nschBkSzkm9oaFSdeM3huHgcfu4oON1H40r09Nbscl2EoshOSb6UD5sSzmiv6\r\nUXQx8Beopb3+dr8//X21NuFVUrmo3sIwRdAX5hK0/WWpskH7Gk/kbs0pdjq5\r\nbXybOelkp3HSbDtizTDF2qE/ISgu4vCCU9tHP+QKnAkA99+7Faicte3HN+e0\r\nl8tjJN3+gh083COY8xkKxAREBrwmE17pCu+s/iZ+dW8hPuqTYHf3gYeH/yn1\r\nwR5GkcgFmf5zGDWeTy7kPWCAMZ5bh9Egcu6RVjgQmc7PNctpTGkr/BCbeY+E\r\naUdpnpJQY42XDcy9jr62q531Ig7v9bgOQmCuZ6ZsoM6gguSyHxJXu7QwnigP\r\nEf+RJwxlXkewebYGiNRgtpVPyxZjg3PKV8qvKLmZy9m5ziY0Xbtnt1g7xrQb\r\npSYUP+5WJjev/5xQxaE8S5WA6ECwtpMOXHmJx0UhVOP0CMhuSgm7PDuelosN\r\n3z/k72lqh2ShrAgd0sb5Ztr7ZKW9M+iSU/iHhvvZrrTw9XoXXvE0ECASyieU\r\nyTZhQ1A07GlFzdgcSK74bnagvseaAs9rzkg=\r\n=DIJk\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.3_1657576206727_0.8192465403063147"},"_hasShrinkwrap":false},"0.16.1-alpha.4":{"name":"@flexn/graybox","version":"0.16.1-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"591b53a3401a732ddf6d646c05804170f09b0ff9","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-alpha.4","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-5Fxk8Pa31HotopbnOQKQYSHtrpQW4WQpja5ctWL139reXIlWPpxuayJ0NyN8gJJiFuiKw+H0bCncYsCNX6/crw==","shasum":"017c514e3fb2c2fbdca7370bed513dc38a562ee4","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-alpha.4.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDfvecFYx1NrIXaXAEmrVbUd3wHSXPkMBdy5/Kyar3XzAIhAOCJv4kKorzcidqpLo08PXg3sm43CBc6CfStr3uFoI/O"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJizTOJACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp0lRAAjLI0AgmNibjr6JZKAZ1K/Rk+s29sxpO+Cdgx6FkHtvTdKXo5\r\n+IEOBhRCZp3eiuX+l6CBx07FSN8OLci34xlcLrJsOtzFWYYmZNkVCZ8e6mAy\r\nFssoYM03V6Bag1h/YcUonUM03GYqQ1UNCgnR20lpUQxLsoCfTTJHE3SgDO6Q\r\n5G6oQgdfn9NSdnCeag2IAhrPleDjYgOEoafRWQDgD/GM5SmQ35zF5mUhc7Z3\r\n+2Q8dowr6KIRKkAgdn96tOu73Dziv04oO5RCwUgdXgF5vDbh1hrNuDFAdzSU\r\neW/cBkZkra24AU7nj5wES6glFRPnlvVyulXGEBRJIdLygMTHbx2rpvufsGsO\r\nulOY/nIyWNh0kjUshOJBVLo4r8oolIY1GhsfcbE42NvIy0jNdanuh+t+PSrz\r\nbLpeHHQb/XHStHVBRuS1CI+JbZ6OnejIpbEDw5Hy51DGq+cbvKVmBS02N10g\r\ny4vw+GJe7064iAF3R3WuTwpTlPKLUGbPlKcOdDu0FO2sI1+4tDYYrKxRkKJk\r\n0nOVkKA0iZuIGReHI94mn/RDsLovIJOjscU18boUAIOMJTnHY8c+1OX/92bz\r\nCqTH8Ia8+5CEWdANpc26+TUy/j502ja0WO97CGFY2hetpKPqwVBK0WjrxeVp\r\nSbov339XVFmSpCr/l2Ko9TA0LYkp5FQamrs=\r\n=07hA\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-alpha.4_1657615241034_0.031006447391378256"},"_hasShrinkwrap":false},"0.16.1-alpha.5":{"name":"@flexn/graybox","version":"0.16.1-alpha.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"1ed2d001aedcb047fa4f85f2eb30d472a922352c","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-alpha.5","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-p2+SzhwsBUXmmsZJySDUU9QtTx8LvIcEOlTlMLWA95Pm8MIdHkvs99z8/hRFrsthV+cE9zUsvddAuIHaPeD/Wg==","shasum":"e3d08a015dd6eaa196c4a2b15db4cb0ca4564077","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-alpha.5.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIG4xS6MdxnzzNSb11810yxLaVCIhfLIe7bhZimTQzInPAiEA/tQn/U8VYSFwvOzLPvgkPhF7LAWkq/1FU58n9KolFzI="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJizTxeACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoB8A/7BPho1JhcOTd7XPL0pcd3lrYqJ4MKbP1zRxryZCqaS9dUGBk/\r\nwiYynG4jv42BiYUZquy+gpxZRrhLHWNr6baRXUzCP0L29dWonZKOVTIeqL6O\r\n7yFVmxhHJXieoZDNT5SHyMnvJedw1aEScOv+FJmbfWGkCr0RlDMDjlUO1BM2\r\nghMLpFMmdGTd030bwibn8wSSv1fdo0O9qc8AOj7+7pFAcdsk0nbTWePzp+Li\r\nt/qkpGFMN40gPs5x1ezuKLHo3kW96rEdHzla2vRtderEr252+rR+XCdvV0g0\r\nBT/tVCbQGcnlnkZrZV763YjfxR3aF/iYU4phqKUssqn3PJkQwRzKooN10Qhv\r\n9/Il4twPDvGUeKId3epLipqRdlIo7QMEtU0piSQymd6ugzAltnBmgG8pxI99\r\nNtj51EB+wpMlmc++d+GHsQFgZbvoPd0yuQPfBHvmF+rsDN3j9+/pfQ6fmYSY\r\nTvyeoNjX6eRl0r5BoD11LxZDfAafbyV0Jddsg2rk62wp0SBEEJA4vcADFarl\r\nQZmaQoByLdYJGl6nxGfZufTWvMExj+S8OEXwSfLIRq8pdE7nMHUkZdal3ieO\r\nmolnW9rMlZHRDTxbz0ckkRMuerYTDmpS2j5oi5xts/hApXtyzO+vLi9UCkq4\r\nsTRbSNTCvTojsHLsxzlxZWYF5Zw2GhJ6XAk=\r\n=nepT\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-alpha.5_1657617501722_0.04328254748895777"},"_hasShrinkwrap":false},"0.16.1-rnmq-upgrade":{"name":"@flexn/graybox","version":"0.16.1-rnmq-upgrade","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"cd8efb9a64bd921d4363f79b20a14cc65991fecb","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-rnmq-upgrade","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-ZR2HqhAuAl7DR1mKiGjl7E/lNpNQc9hahaOPb7bDJGIkaFlYqvyNOafMRz9bSOdyoH6RZKQKrjttWKVFvKY55Q==","shasum":"f4c5e0357ba5cd311b43d672cbd4303f51a723df","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-rnmq-upgrade.tgz","fileCount":43,"unpackedSize":87319,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIA/0pRUgY+j9VETblzrqon9eMUvWIkJY0MiFi37Cll5/AiEA/r+C3UiiftVFWjn1aVXMIYVt5vB81jrUXwd8Lr5sjrM="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJizT9eACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqxkBAAoh8ZF2QtRNE9oqJmeZYooW4KFX7ZcbJdHoaYRaYTOHClsFIa\r\nECNrmCtP7WvbLv2tz7PsoikZMJlFc/gYB76oHGhCoaYM3ftI5plw4HMuuszf\r\nMdFrfbAegv4++XhAkAIWaD0tRWI5Y3Cr1wlyAC8ekgJ/7FcxM+x+ab1Lmk+G\r\nHOZ/Ia34AQhGcReO1EcMRTfxsq900bVhFnf6tzDHbp5P/G6mBuMNxfeFnDsh\r\nsRWz48RmlIIKx+Hliv1HNnHcBmaImjDweTBrTZCg+NzM2jiGHUgLbrSAptSf\r\nLVw5bP4kXcaYbCPI2WyHqLCwBsgYuWoFPxBvFBWsSKAMBiFTuK6WiYdoO2OS\r\noQQlh5byvAhL0r6EugoxOFgj20o3uKmhJ9APqUObcgaeOQYcsJcpk7nnZnnt\r\nCThp8quWOaZpavMHpkIkkMZ4yK42B1hVw+97KLeydUavKxHOj2uk2y+kLSk6\r\nqG/YLBv7URJUkVNQ2LDOG+mBS/8Nvr/OoPfwY2kp6efQeceGmKB3FSnoVyxV\r\n/tIe0CTgL5nvEo828EGQQIX2MJ1b6Eya3ZEw54zGqtyjovlLaA1x7MGV5QLA\r\niu7QwjRU5QaibU7stu17gb0wu86e1WuDQd3qNqU5J/Q5C9cheAR5D9IDBj/Q\r\ndRLibPR1bZ33RqgbN90y4SGG2xZT9jEGgkk=\r\n=Hlhc\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-rnmq-upgrade_1657618270589_0.47149150066245715"},"_hasShrinkwrap":false},"0.16.1-rnmq-upgrade.1":{"name":"@flexn/graybox","version":"0.16.1-rnmq-upgrade.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"7ff9279e62ead080f40e33fa61ce0d659685f85d","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-rnmq-upgrade.1","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-HhdOHs7Gd8ID6bDso39LLb3AMwQIgBuSmBDDzTT02BBnOTUDVnJe7m608cRcswb8a0iVWtdvc1QNaflG6CXKAA==","shasum":"35cb6826dfb06eda93d8f09644cb72e4612c39a3","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-rnmq-upgrade.1.tgz","fileCount":43,"unpackedSize":87321,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIEcpjoqnQHnLjjK2afD3tRBE1QxgTYzWswCgm2Zi9+AvAiA9vAXppZJzP7RSBwu19/wwdnwNr6sv4xA9W/eIFUFNMg=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJizUDoACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpTxg//TGtvRp2brhK+9osBTpv45rIoFt856V6ERKj/WJwL/1PWRfIe\r\nN74UVRnLBe9Mrcs+G3lo977KP/anMbTti861wdchFqXU3cxcgUIll93NzTGr\r\nr+w11xifdG+LfhUuuzVF1Ct7T5RvP4Me4csdSZD/dzdkpmZ76PqfhPalBT6w\r\ny/sY+54b0MprCSLx6C7xFpHrGCNKtF1dS4bsPyvawWk9dpSsZxLXNOjDjfYu\r\nn+6kFfw/fqVmO3b2YWKAEkTdJMC2BG6IgfiNIEwLNP8DZk7mMMKLh22bT1mg\r\nwfKRAOvIlxPagFX8RPGvoFcPrdY4LP0dCLjuDHZxUxV/7lSDl2LcCep+xlIp\r\ntl8asaoP/PCu4X9gwMJ9+KJiUAakR32fySpqwcylc7aj1PqMaM1CoA+kFeS6\r\noXH7ueCxultg3tmpT03bTq0MY1OsucJ8XUlrpUN6axyYoNd8cFvJSI33MBuS\r\nob/+28gJG0wrZ/0oym/dl2/ThB7d4GO52oZeeTlZ/17zP8bFR2qItHmddyAO\r\n9/lAQQ2f9QhRPMJUadzK5hkkdlxsWjwhxCQ84+hIrAHH9oXoGh3HACQ8+piY\r\n/rCnCwnjpc5FvLUWaLLwp0bBZc8+a2QqhNp8hgHmgklnrxN4Yf6gE9ZGmX78\r\nERYT3ntBuGbfoHAD4bP2a2xL5e06bEQpfdU=\r\n=EHRm\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-rnmq-upgrade.1_1657618664310_0.13501138211632702"},"_hasShrinkwrap":false},"0.16.1-rnmq-upgrade.3":{"name":"@flexn/graybox","version":"0.16.1-rnmq-upgrade.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"8672dfc716154427613dc88909663421548d5d6e","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.16.1-rnmq-upgrade.3","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-9JTXuL8tc/xNe0NfgGGh7GieaTaBWjzChc8lEJGPgPiWD6fc9y8dhF3omCAfSvrtE2RUIWZQu6ezxidEsZ7J9Q==","shasum":"0e1ceecd8032c1aa3c25214f834bd847cbcc7867","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.16.1-rnmq-upgrade.3.tgz","fileCount":43,"unpackedSize":87321,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQC7r7bDRQFXA7zIo8rojS27nvxfC/n0zREoWk09a4N+UAIgODEyEDl2EyhkpVdRbNtwMnnh37vBt2zbrToz89f6hwo="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJizUP0ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqBmQ/+NplKOTaIO5p2CQ5OulEH36Hz34nqDJoO48oZUFIYJmoFSBrh\r\niHnVmTjlrf6vBRYmlhN0MCdj1Iws+OLVUpqLg+YLVuIVzijW4I2yxxqSujyz\r\nGA0Uq8S98BG38zA7BJV2HcTHjtVNQy8tM+RO2j8HeQqx71X8jYdNjU2LTzP3\r\nhY3opaa3TLD5LVl86bJIYOhnpzYYyTYpCAOsWiKFFfcpRIX1OjaJPUn0uB2A\r\n6gnvxIbRVxNhm6a1+5YAma2sDxtANZVC5DVNN25MyM3F8c9VoYb074nD+qhh\r\nsgBDMTAg5ikuNwmS2Z4pm2hELwdz0xck+VaLtmRsRPbfL11jHpA+lv5+q/Ry\r\nVu1v03WZpK+cj5ap/ZO0My3wiO7NZwau8JRYU4lZ3jnFf/YMA1JFw7RYRf1j\r\n3af6cyFTW7PllW4jbZgYwjPxjlnY01l2ihzbGZVfelKYug1zyluNXDM+V8lm\r\ngShZK3gTpgN9iVJYkww+RY+WhPs4st/HWlBmWEqqJsOkko5y382SVl8xTwqM\r\nAYrapUuwqaUqRUrW0w7eWxkhv0xfvU2nA3Qnnu04aQMAP+bY3cyc65Gva1u5\r\nEBUB1T9ZfnmxGpAYksxTOLprnGpsgCQi4iYo5S3wzBwUa5Jux7p0ZJhExZGK\r\nnnRY3XELz6fWAaF1aj6dDcu1S6n7kAsJ6M0=\r\n=LNGs\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.16.1-rnmq-upgrade.3_1657619443828_0.34691117470133115"},"_hasShrinkwrap":false},"0.17.0-alpha.4":{"name":"@flexn/graybox","version":"0.17.0-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"f6501b4617fc035e58ee275f04299726999e88fd","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.4","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-h/wPSe6UYe6yECnCy/+M+uINHt0w4NGrMIF09R/5rdD9tWCUfgbeYmTufKRVUjg3ABUTW7g6kad81+xVpagxZw==","shasum":"6633a6d876dd1457bfca3968a89b13c388c37d38","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.4.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHXxknSY2HBvykSEhYgFA3b5EFiDbQIY8i1V5xv/dPgMAiEAv+MVN61yKm9SBsM9+ZfAls8aZv5vtUf25Mwi1PBDIsw="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJizdUGACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrrHw//Ww24gfJjR25uQFkq6j+XYEo8YWNxLdVNqkdsoe5POdNk5ecT\r\n3W90KeazpOpZb/yAok6mm77dvMcwAXEZxWFM82IsKBCKplR8DWgOJvnavRpD\r\n8jVZ9at4VkzCeQumKf+yTeUbWegvmBiAkA7oAKTvf07sLRDnTlabRuGS/hrL\r\nkzhHV1T8e6PZfRxjGwCdXtu0bY7TMxJxo/FRdW0aNDp0L1ouvdNKBTx0AUm0\r\n3ttDGK9WEIxGaK51HqNWUhFVgfSc07yekcHA1LRCoEFjUXt0bL64QNEt7S6s\r\n+KpG3Ty3YaeOezzfEYRftvVmbFUI0VuSekJ4RLFPdhE5zCtPKD7Ch9tjEGh/\r\nY0rVKTqiHA/ctTv1LhsY4IwvfPbv4mK+QSy0ajTBlbJ/JhYR3rAey6Hqhax1\r\nCPRAa4tu//r2vOeG0k1WtGCpZ2nD9VFUMmMOTkRbsmKN3kQ38CBAcfPb3v5j\r\nypN5JMpac3YoWQpbyVTXJo7utGmH6cQX7ZQPS4+ewED5C/+Eb1YWZNAXkakP\r\n3mmVndrrmnd5/YrIHzKaeSdvVVT2DHmlrAj20GXoQOe6DV48LL3Rb3Bp3I7D\r\nvDkqCU/uLTA8TulATdVkfRk8/4GcpCHW0yFVxjD77bsA9dzsBVj2EEDQWNSS\r\nMPuSdaRFq4yWs8LV6P4jNPpeFWaX+Q2hGFU=\r\n=/gQ/\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.4_1657656582026_0.19944233836963088"},"_hasShrinkwrap":false},"0.17.0-alpha.5":{"name":"@flexn/graybox","version":"0.17.0-alpha.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"5485487abba2e2e53577dcf6b1fc958b5ec13d62","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.5","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-fKjMlGBaCOrIMKYtxaZEhuA7KtYAR/FVi/7qefi6TUfxGBnvrLSKC1R8rOf+IhNwT8UB53EtYz0YvWivilfR0g==","shasum":"8313bd840850e4dcc5cd67f867f112b2a0a8f12e","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.5.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEENCP51kQ2HGKKkKDsdlzaF/AkolI2ENxYHiihUO805AiEAuRow5H+1HBOM3YpmoBnMKwIt+BPvljVdnygTVJc/Ta8="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJi1bUVACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoLFg/+PmlU/rAIVjaTISHoEw8Pv0yR7+7eZFlppfM43PZ4nI1XWEyI\r\nC6wHULq/2Zpus2IwO/oIOlymBWTbnxdFd+y9OyPnjPW27SsIAYvha6NqJZy3\r\nPYjxCkkU8gbP0H4antKaRniGyy80VsvQ6mbYgK7Mrre0/V8+DD0m0CbKm1yp\r\nhLDJ4IOhRVs7xAtOGpnK6jeMR2RN19r4nwsyJp7vQc2ORySmY3JGvGEklDxz\r\nUyeoPqrJBb+8OS2CouVcJcp92E2m/UK591LV2xvpdQLTGAMbJfMuS4V9byZv\r\nOq1EaT50qXIdQByjSCDRHdiFm4XuukFlqIxru95WZLlCnce9+vPp47J2R8sV\r\n9rNsZkcp2jdDArNxc+0CJ3zbV0VRXLaXecSRYkt4s2dliF2vxTuxK9Wvvnbo\r\nZh6XJEbMmhRptkupbqvcBpIbDvDqUo46/WZJRhbDD+IrAnHyokQV+YFMvuJz\r\ns4/u/QPbvSrtTxIzGFzIVaNoConUGAb4AijVsovH3/LYVZtZSJI/R8t01YaF\r\nFubsfnmpDvlMIfX2vXZKdqke/jlL77cXAbpRA5fS8uq0bx0CcqfP/HGxvHsg\r\n+cgpC+zg0j4QSkUDs0iwS7IVJhMqplnjmH45iGiTZeDtYq76jlk+PNhZ/ftd\r\nZgCcsI17b1Ii08jDqar2g+2Jj37UPpL8TMs=\r\n=k5Rj\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.5_1658172693535_0.3965996457758263"},"_hasShrinkwrap":false},"0.17.0-alpha.6":{"name":"@flexn/graybox","version":"0.17.0-alpha.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"d76b08d35b9eb34738ef84786db81110d8d67391","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.6","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-54BmVZb3gaFeDvrasmEZ5ARB/fWR3kh4T9R8Mn4OpPztE+a5dUlv3PZo7FflwOj6HqwdvwlA8d12GwvY2qEvIg==","shasum":"c8c13e481c6e2dfbcad937804c3aaa001c58793d","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.6.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBj7EdwfLs3et1cEVJ28iEHx5r8TySrAl5MiKjqWNO4dAiAb/shFZOF7Cw352wc579kHYGlRrNVfNTzXZJMn2RsNFQ=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJi2GsJACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmryUw//TVHoA1rDI4D+YcFJqhSR0+5LcYf/0Y4SQv0KBvlGyUHqzybe\r\nC8wNbmrxMY92qy1/8WzGSOU7RNE5pz8w3hoiLaigPvCrlDwwQVJpMRGwHkV3\r\n8LQuS4Ztddf/tkv+EzhBbC4PblusQl+LFVtYSdBsIVF9DG4g2TVQgSu5YFmv\r\nqF+LNn6u5NN2oPKcgHY3mx62LiHJsDWvvqu7gkDd7UKhwtz463Be71mBBLKk\r\nPQW0fUqIrTN8AL8H1coNqcTUy3Ke3YmeHKVeDUNYonK2xowCUlbBke4jr+h4\r\nGqG/fEM0cg/2F+VlspVlvyeoA7AOYtAo9N4rxSxB3DHZc88oDbNlCDSgm9AK\r\npx/NdRebV3PXQ9okzIEIRhg5WO80ILXyqc1tKb98SCasgn9cE7I9O9nTMdnT\r\nmoyLl6FNXAJzmKUMsZs8K/6GJRG+euhgbue39q1CMeJWc8dT2b78sV2kS/UJ\r\ne/FnBFtBOfL41mXCFX6sFL5tiiRbkR/iRlWoxAdcb7/9dk5GA88oQJFdgyu0\r\nWGS1q/8oY6Gtxk38E8Fhws96mfICWOFB6NLk9T2q6gUvwOH/2g04N0HrQ2Q4\r\nKy5oYW+0USoZCfvbFkhA8GQxg4CbRo1TWnFQfCfbghfJ1K9TaC4RLvRA3Ngq\r\nmfBn+MG5f2peluNoqmOKmHtDMdgH/sa864g=\r\n=Wy10\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.6_1658350345666_0.2207331206984826"},"_hasShrinkwrap":false},"0.17.0-alpha.7":{"name":"@flexn/graybox","version":"0.17.0-alpha.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"7569299e3767db4fc308801e25a90a94418b1680","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.7","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-++H5/zrDiayzRBKWhU4pAoueBGOqbiVRZ/LlLEUWFxBOJ34iu8DoIjfcwnTPulQwqwOzdWk7qGtuAh7VZDYXfw==","shasum":"d386b2fd703a96ce9cb4f1a327d9e711343efb4b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.7.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIG8tecU/M25x6sGtf2ihGCK9RNq/iIT8N8OSQzgntoqmAiEAudIVpx5Yel7DttiXVy8YkzkgEp8Lo5RTtvBJhiuyHHk="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJi2GzUACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrwGQ//dY6ce/o0zlsNHSebhUrBXiEpId8mVvum98hT9ipLqpxguFeH\r\nFfH2GkyNmeVhBluiun/KUk2GEBStTjMuxl6BUGKguWWJxUMrhiqo4Kuevzhw\r\nAD95mRz2meXEzQKZq5ZW56NM7FU8wFbkNVJEWjdb3YseAKSOuITYsHLRZTIN\r\nHYhY5kwcZ5i6HDyk2TtXSf9qREbdHmf2rhcoeUQW84ucfgbSfZ4QObGjDd/t\r\no6XzF8Y72RoIVwncuqe60Z9j4czJ3ghM1DS+kG3USwNkqX18d8aV4Xh7MMmj\r\nK+WHGSGCbpT2UUYHm2c+tAgQ35tQa2iHu0BQ/Mu7noiZhtssFB1FHAj5nUuy\r\noJkg9Xsz0asDxvQQ+eGzrDfQ+D8LVa7DFjBxDGUmfzgGhPud4aaPN1LWSxHX\r\nsLNYmEaVxYRBbxU0OEACzoQugezidK3jvotu9QP02xeO26/6FmbUvwf1sQWU\r\nVH8JJsnt85wJ2JECXyL4F8/Je6n7md54q/2s3Moq8uFIMWHbGfulKXJHSkDI\r\nfFpG/onLbKdm03iazLOf3EofA8+CsbXQfJfilZwFZhsJnA7iOQE0iokC7nx1\r\nwRBEF7ydomIOr/JAMHO4H0g3K3xZC58FaWQnXRHdi4mTSS3xrrPhuJR8PY14\r\nICGh07ZA2x7VYcwbnxhQELijGpY48EPNlSc=\r\n=woHL\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.7_1658350803432_0.45758113146862556"},"_hasShrinkwrap":false},"0.17.0-alpha.8":{"name":"@flexn/graybox","version":"0.17.0-alpha.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"cc1b22789348258fbaefc0d6e206a98d10bff6df","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.8","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-p4ExyqUFo6oQIeeHdvosyuOkZguB0SkHLyvSdiSWqDxTz2+ZEyDefb9Ya4CJ65svSCz1jDvvEzM4Nh4miEnaFQ==","shasum":"83df33cf613306d76010ee950459374923516188","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.8.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDX4LQwIE75aArxQ5MgK+PpxZw0BukPLASRVjYJJQiDuAiEAllohPv3qTPvFcM9zRrAHFCz8taKzdEJXwRwfvQ/PdeE="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJi712dACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqBFQ/9F0jjJKwab+qiFmjJ0kTNrq/ndiZ7/lhpieEdzJrcyp18KbHu\r\n/9SEY7gf1u2L3yNqu5Xb5ZMkd9P3P437XrMZa9ZZu3mFoEoPknyfWRMQ2O2a\r\nZrR+9fWvhaZ234TdfhZ+taMFrZp3LLFuko07Xl7WV9Xw1sG8YFVxnXgFBj6p\r\ndqo4793s+cVMWaI37BKMyfO4Arcwohw1Pa1KxTDdoEU6iyrU3cDmx7i8+2ep\r\nSnfELuF5mDrfi/Fu2HoNPF2lF/r9ZPdRWwim8ROijbaCFmvBOEvoRMSqv8Af\r\n0mQaOd1rrI6EhYJ0GQg771N22TGN5EUdvJ+/tYYUvjn3kUpNFPOwDx+KLV3V\r\nPY4wOVIIFAu556bu2xlLK2DbZTCfisQpeQ3VJETFMkgDRcX3T7scQ+CPx8Qu\r\nKBH2heI13Ew+LY8cHkPxadkWgZvF+WgnVKDPDHu41PU4uoFU8AmIuBpAJYBX\r\nsjg9IacziIgOOyv8VDg8ERdrqGqClW6eTNMdh3KmJeg973xsQfNl29QTykvR\r\n90I1CUpm6t9n+QSpYUZN5OfGpPlnjhlWA8PwFf3uB7+6kw5WCDjXkcqkdFR8\r\nWNwahUHGBtcHLVzjZxn2E8J2ARsDLiPgEhDgU+TNDNkVSnHBBiNg91GXTKJx\r\nKZoW1z20DWB95FCC2S3Vc18EJTaUPEtmN0w=\r\n=bObO\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.8_1659854237385_0.22748682447880664"},"_hasShrinkwrap":false},"0.17.0":{"name":"@flexn/graybox","version":"0.17.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ea6144e59df2993aea1c1d6755ddaf92d781edb1","_id":"@flexn/graybox@0.17.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-KXyKdrHd4ovgPFqJBEmM0zHxhiu+3H3k1yV7eKWCSlh54wgxRxs0IWv13d4TIzqKI+rQ5T0IFB9RaqE3uDDE2Q==","shasum":"f7940e307e13f83dee893f3d6b597218bd99bf28","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0.tgz","fileCount":43,"unpackedSize":87306,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCZNCW4S/EVtpcSN8HSPPP9kMHXnDJbo3/xDm23q+y2owIgTZqdarH7jkTh4g/KfvSRYdo/CkH9ipnmfabV9HElMAs="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjAx9iACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoKvg/+LwnCn3crmUjkfwV/s+WEfnbkSEBH1CLvHN7DrYBhJ5cApLnT\r\nVS5XDYcVfDnL4CpRnhX+yM9Eum70RLLUfCRWAeBh8TlpNUO+S56OoTg2KNzy\r\nYJeoISwPVfeAgsazi1V8NxfHZY307lYh7XVcp37c9nZlnDpQGVP8W6V3M1+j\r\nKI/u01hsDq4EaFEnmilFCFNcJ2ynuvfrosO3OTfkRNVjYU+tN7MQ5TpiyAml\r\nyU24+xxkLKWK0Vm1NewkQbizTQXPpr2QZuO946Tz4b58O7uz02equWPKyOw3\r\nyk8Xl4Q4ctWTcaSDE1V6JOWQ12RUKVZF4oNzS59AOGIZGJnwTIZ5y2ERJy/C\r\n1EsHABzJJaLaVLbAzSw0vuxSmIHqIDe0StEmBjOPeqfilb+DrDU3bDP9G8Mx\r\nWMGNv04rbPQtIfLbpYExpjE/d9mOoLfgiK7jK85rGXioAPXIO17mCVDjyvLD\r\nkQgq4bS5Rm+oOPFz3VQYXLfVZBCryMl+KqTCEkCCdbTjvm8ZB3I7skMOPcnR\r\nnZrQ7njdOTt+J/gvP7CvEWKlpYzc2K1tJM10hWshIQrhzsv9MeCs3WHkWvFa\r\nniQ+7k8FxGrJ2EQzvr7/XoW2BTnVA7DP/nh2DYostVw0t6s2ETO7dj/HIlPg\r\nZo2Le9Y5xEInlj/FWJ0JdUyjX0dE47GcRCU=\r\n=nUxc\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0_1661149026445_0.7597088334788671"},"_hasShrinkwrap":false},"0.18.0-alpha.0":{"name":"@flexn/graybox","version":"0.18.0-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"59b8f81b5755466b56a51b7be364eba5c3aa6c8f","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-hGI3LVv6eQIkhlClDLuN57nBgh4gToo+BAwYy5c26ZExFcQmNY6y6jWwORciozvwozRXsP6BhzDxpc8E8//9Yw==","shasum":"4692fd721ea8ae5ca8dbcac06684cc8865aa87f8","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.0.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCo8R7iYIRO2MEE3V/cqoMmD7AqyZq4nkMoFNT4XtdrywIhAPU7zhj95dYDAqHORyjhSKlCVALOr5izHVwfjvXDNL9e"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjAyIHACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqihxAAloRLwFouFOhN572T8C1cxcO4XWaSZv3HTVDM+unYN/8m5bcs\r\nBJTiS5EuS0oFtTY4eppeBoiUm1grIcOH792owL2Fo32Kpj+FUyoMnEt9JLDR\r\nLRqKh0t5YB0ULFqBv0x5MHx/59yK02ztAnObcdMgMQkR6ns5McJcwrRsycvi\r\nAea39CP5Z27zbpfErHJZ1+ukJ6GCQecAoAqjsJy4GOCSJEyBQmNWHwVVL9vc\r\nETuxLVEIQHPGRM6I1/YLY2I0Bsa2VP65abBdsbHn1nXdhmRDr0ex5CBEDFeF\r\n8UEZmhrlpJscMRtOgFemiB5xi90Q6eW+0kKD5Kr3kHMwkmA4wIFJjRVObKVq\r\npzO1ca1ucRGoxiI799stASQZj/mPHUd2sXq7kS3TjbxwSeUcQXeAmTPauOER\r\n5GnFmqFQpOYPIOuqKCGoDbeWXhaUDCQyHbvXvgiiJOcYsRsq/kTchivwT13s\r\n+waBGB7ynQFgcZD/NfVuCUZXxL21EHwHNVsG3sINhs0x80cBj5ssdma/a7Jz\r\njb1ujdgCKw2LDF6EzmzZ1cRwJ5H5fr2cbM3ndmDL3CIR3OYEwPAHPjRNR7Af\r\n2Fx1LosjEx82rvH71Dd2+xOUE+k+WYrBbKOr8eTgliOL4F+x2AEj+LH8s3Pf\r\nCrdOLrH37HarSxiY3WOMoJ6kSpcD9F5oyhU=\r\n=MOMW\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.0_1661149703044_0.5021515511994761"},"_hasShrinkwrap":false},"0.18.0-alpha.1":{"name":"@flexn/graybox","version":"0.18.0-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"9ab33200b3afa8adc006a29b37892d17408b084a","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.1","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-pjahEfVWoBUvyyWklijZUHssjnwHzvxaOuGUpuBlnyexq6gR8Ly3HaVT7PuIMbcTY4MbOiQ07TDpIiUQTRHyMA==","shasum":"00493d3e46f0b4a78f7adc98080c20169f79bd8a","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.1.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD37fJeeQ48/xHaOqsA3kQ0fbEndtdtuR8/aoQP4Z06egIhAN6hG+FbeCtc/1yG00/GgUFYYmaqeE1SCi3FxwZu99XJ"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjAyglACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoE1g//WalBW+GCIH3Px1oEvxvACJxgnid7vkcXWRrraSnGdpuNL4tl\r\ncLazUJMrKMQ77s6IyQkVOGxTVvVM7Z3vE1mKYrBRlDPHE561rrob0XjrxiAX\r\n9F9TIlwIz3x+aHyAcOLgPdxe3tLBClAXAm9YmAICdKMDCGnJCOQjSBiMn5mz\r\nQ0zGPpPeJhAOe3A/Ty5jx01seZ68V86TUNVHQoNzydoc03yExbrSXtnaWidI\r\n5I59QDLZ8hIZHhq3bVBLpbGeDSkLMZrgkwqTFRq+3aYcOK29K0KohvURUpoE\r\noAlC0j7uS2HWYKXjzon1ivN1n//BxTgyeGkZQohZ2iK2JEW/EUN75iC0mMTy\r\npg5zuW+G9EPsT59fGY2sh3tbr37iOX/gyp2s+1kHT3ou65Ic9aT9nf+XA4Nb\r\nfcxu987r65fpEIx6uP9ducfaesgj0F+Hoh5Nivl5Jq82arkBhfgPWpPyWrHy\r\ntMg41x5vwtcJ5KogoCPcoy9EQlH9SnuBhbMH6evZfZgU74pMolO8iWJxpwhx\r\ns8ecSpBODPsLHWLzx+IjqVfKhrKMouIJHvZhH4sTZJzZWGN1NA5rHji41IJ9\r\nU8cIz17nkvF8z1Ga16DW2HuQieYmyt6tD3kiHtdthhGKMYcszmfexTZCYggE\r\nFbOIl4TMTfqcFRvw9qJXzKygBkCcJCVUJtc=\r\n=LOGg\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.1_1661151269639_0.8230675081792145"},"_hasShrinkwrap":false},"0.18.0-alpha.2":{"name":"@flexn/graybox","version":"0.18.0-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"0d9c0a61e5ab7abe9ceb596161aaa25a116f46cc","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.2","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-Re87+qaPoCUmRWhkgJha6wfK96aFfR71PkIQxCTRzdqspRUZw5LpzvPtgfJqliHEWv/+UHybclpLj3nlUXwMXA==","shasum":"2aa71506f6e37041a3ed87398898825114be1baa","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.2.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIA9P/ZJkdvtQN2HNWolwqWHQSpPw/czsYNJKqR69Vm6OAiEAsaALTUF+sA3IGsFVzRfxZIpqETZTb6QBm2IJ3jTXHaQ="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjBoSGACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpPHA//ZfnC051SRlL+BBqUmycFGQJYsayFUNN+Q+1FE10KcGxnS37z\r\nAZ+dj9xCNwQ03A4MlprLfiyBNsGdj63KzPJbcIszsdryHNL3gxLeg0OR/0yP\r\nyrKjJnO0ThyuTID73wOUXI7abRBelqcgh6j8f+Kkvl4ZkE65uKBLqz/EFtN7\r\nuVJdDy/B8X2TdAyV7eOYWHStdxHhPayCsLNoQyBS5lqw+B5rW68pLnKUYfEJ\r\nC9uZg2wLdsb/dd3YcY+hjSvvF0ZHFjtW5x9XVziBC5G7TaF2B79noKXPQcbi\r\nsuJyBHKOrggv2GsqeEfPVgMkELxbSqbKYXWhcjj194DU1CLcxuKhKq04ukD4\r\nGFKsaatTRwuBfqj3w2guGOXGZPAyoqvEXHDfJEPHRpHCb/9/zdKpahuItxlW\r\nTrLfeP8m70LMzHuSAx+j2qN4cGGAqqVVLoDEnqhqhQ5Mv29BUNDAlMuqbaeG\r\n+S6xhJ4O9kianXA2/9YeaxcDM5vnh/i0zenAeoehRfaEH5p82RyBpyBBM5nQ\r\nkqvqcWjAvuE1D74tG0oXOQ52VtRteays2gPwdMjkDTlL9tUfIFoo7wVqQHxG\r\nABtGsixP7G8UZ+5ya43ipcja2TdGvtVyzY1AiqIDJgTYfLFIZ/XBDoEiYSqB\r\nTzH6m7HpD9DQC12zlsq2hfkBe0CeoxK52so=\r\n=lwfy\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.2_1661371526506_0.9143247551065885"},"_hasShrinkwrap":false},"0.18.0-alpha.3":{"name":"@flexn/graybox","version":"0.18.0-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"9c7077498cc357e2b8c0de513cc41b2b818ff3f7","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.3","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-+Ul9rB55qIAVFCDPfarIM4EPBfgTKziTX/fx2garfje+v4hJ5fBov6nhaogv+32SYYt+cKwC4UsCp9IBpd7QKw==","shasum":"b605e83f01618641d9ee0d8650aac64b87799ba4","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.3.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD/BnA1aqnga/m1zRUYZxZJXK4Xw2FdMkoiRhTvg822owIhANEHyOMxdgyVZIDi1iOHx9YNNo2uHZQ4lU+IPD/8/0+0"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjCGn6ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmroVg//YAV0UHpEHYw02zgFRmt4ItnmaCZ7++HBkORj4fHqLAOoOf/5\r\nGIiP9KKFaz/oHoNXePuNLUB8SszOOREf4nd3Khc6FRiBETnHcXIhJ142/T+B\r\nxINddSbkXhraC1TKq4iREgyV7xekopQTGf5dK8q4yYiAI6+13KBrdjpdjloD\r\nycQC6M7XYDDHwzWJwXPHFJg38e6ghWOZ4mDIgVvEcarjYmgE5jqr8HTp1SmQ\r\n8X+hnGkpWd4nyCQoGKeCxA1kwvRJrpBMi8wRVnCb0BUC+GVwO8GbF0w+Ffp8\r\niqquHYrFwxDaZNWN1lRPz0q9DV1gc4HoslxgtVtlri5Sb4bWFTd84ZnEi6cc\r\nfmKdUtFkchSRqKE3JOirh7jEmuMuAOI/S5S2+Gc2KK/qK/CbtvtDs4P5DdVL\r\npCysSmw7ZUYZBwBcju1+babENKu0UrKX+KynumMm9G3rGMyhrfTDDJznSieZ\r\nas+TeqMKHgDkqOurNSxUg/+BjgaD6GHTDzyXARpAeK2yk2CuxK6+qnC9r6hD\r\nFni19+gA5hVqttAXuZkDBH3BpMNx4Qz1dCKuq+LJCQbFRThQgqB+/d0n2TEL\r\nRNlKcoqwqgX2gKjFapKKSxbfRQAMo3v2uRc+s88jVQ3SHK3JIRfJnbQeb4mF\r\n/0Q9aoxfwxAGN8Ml0IMYBgpAaW2y4ah5mXg=\r\n=SXl2\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.3_1661495801893_0.7992149219207592"},"_hasShrinkwrap":false},"0.18.0-alpha.4":{"name":"@flexn/graybox","version":"0.18.0-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"eba48cce271370d4288d6b32e0d4f7135b12f741","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.4","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-LrGuv9neEk83H4R5r5nN9L1tQVvoD4wnWYBgGvG5cWeHu5VtNP3mXMlBHh7PI9DDp3bDhcZ8cNEAwlBHta1nGA==","shasum":"32ef4760aae2d2eda1f97dfecc5e77bd32856556","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.4.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIE7R0sv/Hcf5eoMlwAKAWj2M5s4KJc9FfcjXs6yYRJW6AiAcCpzKJvuqR9jH5KE7/U+aeFMbpWIfM99lNxZKlWiS+g=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjEg9YACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrH6A/9GzK1PgcX68zY/rW2pPLDS4X9zFVOAXw4kRorW05kgCJNDamF\r\ntrdhu/bd3qsVTsp85V9oACkkGCM1lMxOm6+yKvkpfKPdDZ9uMLEB/gEQuf29\r\n+GknZHD/D3zo4dPlH3qxLkbNkkxiApXhItcXWI+UqDk6GtURlQWCgfkWly1E\r\n6cSSGR/MmYbedTlkEInPu1yY/1dmlH0r/6NB0AA/1wugDpzWlxO6buC6aSHw\r\nGmSkUfGCEPyBU1D3uhyWWtZHUZ0L/RvYHUh1P84RS8BjFOnJP9zqlzJbtRrF\r\ndVWP3beiUGkBLvZOw1qZrhQxlM5cXyljiu38R267yJLNeCzMPqt5RwLZWab1\r\na3lVSLeeM4kJHkleFEYeMQpDwUYabU34GknYSPN51qHLc06XGSbxYpaK/fST\r\nM97qBBe4FV2h5KRgBdhPC/Kbf7GQSsOLAAYJw6JeqvocsCMH9RTEQ711FKy9\r\n48Bi9z1ZtSAmjozLaz876U7LbUGMXI3cGf8VhFYZuwzle+Y/qgFH3XD3Iqyu\r\nduhRdDoegh8H0/G4sk7V76BDMAvsvcUfqftnDBpMJ4+kZUgCh/eVyw7wC/wY\r\nrxQUzoepIhFJ6Ms5EcMoD8wzSToDkaewxMYktfzWx9YLLGIh0mmme2GuubbT\r\nVuz6k5gR/RYdCTzYnJK2BcMXGzUfgBKlurs=\r\n=UoI8\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.4_1662127960429_0.02344715585937207"},"_hasShrinkwrap":false},"0.18.0-alpha.5":{"name":"@flexn/graybox","version":"0.18.0-alpha.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"fb392025fb0627a303ac400736d95e2a308d70d5","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.5","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-m+o39fBJLRkdASKYCYwfVwNqas2jMRe4hkYKG3kMQu4DoqIOkVbNYKKNZxANmJcxJaPEQk7hFOwmuSjrILwejw==","shasum":"99c375e1a42d3c55e8bb03df2a34c14054f5335c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.5.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFC5T2e5jOvZQSe4RukUiGXZHK7Ieakv/9xggKWaeBBjAiEA/ZFlm9mwWRBhHhR/o/t0UZxzUI0LMiUroiU36BTh/FM="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjH3A2ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmrb9g/+P6gFSaRhtEM3GtEaj9Q0J85deqnDO7DWXuI031/3N+D6c/K2\r\nmokBqxgik647JbrbEqCwnZ7V3vPgk7CMCqACSfcfX+uez1XIJM38EJukwaQg\r\n9UhZBjRoJaH7DiPseMpkXJXKDNlO1eVu6A3WYNyKkSiDL6zPVtN1NIKiboUn\r\ntJCVuC+zrlOmu6cbZU/l05v2Ugdi7yfQSdxck6zukj1d26fr6DSU5kT67l3A\r\nka7xXfW8AnO4PulhadIcdprri50ESeBqcd5yslUs3w9dDn7z0rUFSW9i1VFG\r\npi/b7tyAHzOSukQ1Lvt/bMZppI6gf/CiCV6L7qa9so4KpKMtx3MCCfCb3OOQ\r\nkE5A6kWo50x9+Alhpg3F5KwfhIL1p5OuKtQx3N18tr9G4yFFYt1gC+7SrHZO\r\nWGMu3733NqH2KY87GOMotl0AjhwvQP+E3yIWIHFeu3z4Ae/i87syInIYsXNV\r\n51Pfx85tMYHdjDIAdCTbd7PTDcCYsWXaOBA5g+I/lcyiTKWjACa0QIRD2h0G\r\nS4aw5pU6u6leYy5gVf2AdL5wftMWWe1MH/04q5I5Hd6wXYOO8NrlwxJ23NET\r\nctszON9gGS0qYJS6iLm9dG2arHTL97jnvnORdHjPCjotH+kG9B2+zkxK2gpk\r\nk3iRPS4JabH3xFft5Di3rdCEiI0vFs55nMs=\r\n=WYag\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.5_1663004726040_0.6920812970280448"},"_hasShrinkwrap":false},"0.18.0-alpha.6":{"name":"@flexn/graybox","version":"0.18.0-alpha.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"fcc3d46166e925e96bdac168823b74bd7e736fb6","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.6","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-oYdxe2Ssb1g9P6GWrYxSmxgl2siQvxMXt9Hn/0FJwCPAvakAjLXv/j61YyzWHnugCW5nhoH8DWgZBrsR9+6E0Q==","shasum":"ea9f9d2846fb1f72a4358c608cdc39e259dd5a28","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.6.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICDkCTD/2E3TCZIaJ3mSHAiy5/oLn8PAQeXPM2PrUievAiAuoSN0ORjyYBvDz+FAtvBIRyriUAcZZrRs/kml8yPLsQ=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjH3NJACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrkSg/9HThISY5/FQncE5yecWbwaT/UAYz5EokVn/losOGlACKns4UP\r\n+yHZJvfuStUNz8JHpWYHqCEL8m+4WBq4ZHpe52ecUC6KIWIsu/QPBXt7YgUM\r\nqb60vEZAlAXZp8f0DRkKaY/tPXfZ4r/k+ZBavy0vwVBahImEA5w7BQHcTam+\r\nHY8E9Czk5WPcarceAmOcc4lWBXMb3mhYPIV3BI6V2RGP3lEutSWDmwc5MThF\r\nwiIs3nc4eY8BuZVYkMONRdi9I1JslG2KsxRdCzyjeVeGwezFObyHDEZ+Z1H7\r\nQbbCHBvMJmsRNf7ln4l1Zz189JjnwwBHPNAonEEzRXJwb18Iph/yyd1Oz1XL\r\nNP4WUvz7WIe3LQOooNNfJVupM/z511v//+KlQ7wfHMievBpyFY2ZMNFiMqJx\r\n07d51ZiQq7F5zNecLX30WwMy5cFl0Rfamx39XntqZLQKGxSs7CNpNnCTGXW2\r\nBocmNMYBkf39+J4jp5nw28FrhVuIQ1/Gp5j3QxJ+RlFWkcYCCaemoKlSpO27\r\niv6kaeEFYL7c0s412VbEhZxmrCjr7BIQpqPDhddeAf88gUEe/GnBzq0oaZ4R\r\nS5BBKouhOQ4Qtt+jjMlk1aLl73U8hv9FTV69XJ/Wx6M2LHkT63Ch2lSdo+nR\r\nKAuW7uaO0RJmFFuJ7oU/8eS3nPNIwcG/qLA=\r\n=kPh0\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.6_1663005512778_0.8493571488663483"},"_hasShrinkwrap":false},"0.18.0-alpha.7":{"name":"@flexn/graybox","version":"0.18.0-alpha.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"843d6efd694e24ee96ad9be7ebcd0c12ed589472","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.7","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-EGZ+KoKCR5ntuf1cE+ZMZHgD/41hEoXShFYeJhkbPgw60Djna/J5NJNcAjKPNiHG4J5tpTXwku/y9723euXcGQ==","shasum":"02df95c22c48307ec2a55de6a4543b8c655165a1","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.7.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDT82yzhnjp9ZGQZxiBlJtG8Hrf4A0laUKVvrZJr9kdnAIgRcWy63GqxtQDdu5alZDvqtMt5p3/gSxmrHJSxgfZVPA="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjH4YzACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmqdwg/+NUZQ3ctjWc8yMjAqBMWLqETGPgHV9tyuZe63daFKZyK/ZdB9\r\nKqjHaMB/QoNBdkErlLFVj8h6o65yBD+qGGA1d8+kGRfF84UOdZN7ykfsG68r\r\ngXGsFaNjSHSyPizD3qX9VV0btHpfhAWhIm5fQYvavUddH4RC/RFFgYQcOZmR\r\n5Va9EGIQ88BDFQh713jU6cYVOR0L3PCOpMVqF5qPEHyvXjJY5C99qnUp8ZgF\r\nOtnUXhTgQqRfhC52fnKl4NXbjzHNhESwbxYNpjPLHGADEg+giXCbTvvSMANQ\r\n79vLDMxX9TLLDfwY0RC1DGP8J06OIAcu2LzDUsTPY6o+1wP94JPfoMZG9Vjm\r\naTg2/XK57bt7kXPgAbhFBU3riC1Of1lnTymR55zD8eJreQEfzUGsTsK4S5H5\r\nFGQaXgRq95jubJ4HlpDdGfF1Q8aMPfohVh6I4XgbVrNt35diBd/hI7+ci2v7\r\ndsJxA25z84+MlPX04qPoWuTTUdPmJw2RybTr5EBcXALl7bbyXyf65S+Os/qU\r\n4TXXkGWhwf5YvBmHZfHaX6qjnuaMEm0xnzYHyFTG8be+TCWPjNw8/ZfILhbG\r\nsg5M9NYDrsAVfVWPO1IUOzEa2MrQ/iw6HgAs5abe8m9CfKee7KY06wnz+csj\r\nmMZAoRWf8ltSmIBiyplbO7WKbp6nn7SrRjA=\r\n=AoaL\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.7_1663010355241_0.35470706235124894"},"_hasShrinkwrap":false},"0.17.0-alpha.9":{"name":"@flexn/graybox","version":"0.17.0-alpha.9","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"f3dcdabec1c6b5eea5f0abe48cd8572a3101666f","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.9","_nodeVersion":"16.16.0","_npmVersion":"lerna/4.0.0/node@v16.16.0+arm64 (darwin)","dist":{"integrity":"sha512-Lfc1WgpJ4l648pF0Ke815zJ3pRsDCgVQxsGJoQD2z0p2KJucucHpVfP3K5L4OZTsJejZ+d4ScQIbEdVSoLLQFQ==","shasum":"f562ba401f6379ff21872d2060fa61f0478e5605","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.9.tgz","fileCount":43,"unpackedSize":86551,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC5SztD8AvNRBpvsKNHr+mh+GXqi9bGWsrivO4DAI5DYAIhAMoFP0kyOc6PclfJVxav52TOIAGchi6YmO9b/fl9nW2G"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjIXp5ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmotwA/+Js27fQVjfYAfhm47tRl9iXt+iqa2q2FyjEPyxKmRhVKAv7/z\r\nYljZAkiPyxVlf15uA5HtNf9/JXnTk2dc4Rtpx2ZQ2uL5yDvV7ODYuIJv7DIp\r\nv3xtB5CvGmRZhBgXFq0abeIAV3rvqL1jQnH1k8/2lufGG02U48cnuSPlVmEc\r\nkh37eAs3rApb7K0eTx/zs/ohcDrZdcAVS+yna+4xqEGzoEc9Qnojc7tfHCBK\r\npMlOBKKxnIi6IEm9Jb2jWpyO7xB8QRl2ICv4N2XqrftQ7ZDQP22sC3o3nJJu\r\nz1cu01tTrjrP1j5TApgvz00Vl0OVdZsnjAQjCCBXpaOBjefrM/xUbSvARLb0\r\nMX0LIAVeGRnYnIxcBhtBjAOE8R7JKFCe4bvsLloKWEbnrWh6Th7fFntM59TA\r\nhO+wezORftna7H+IdWD0YDIw+z/3c4dbTOzKPuNxIqb5Mhjg1vSg3NbO9p7h\r\n+OndWnHxEqax4Vs7hoO94ahd/6bMgmGV8bDvPQkH/SUphnwlcSzW2W+HUq6Z\r\nmSxEze3rO/u9sjAwK4XfCrzAJn7zx5AVARQ9IaW+GUxSl6BgzKO4oC9LmbDz\r\nFuvViIerNS0Q1Mpe157autgcmfCwPeKsTOMTnCrc/PoxFQ/uir9ppIYuSSB1\r\nWWJ5hBinTs4MN57VjP4KIehRDJNgWk5+OtY=\r\n=+cnf\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.9_1663138425256_0.33055502130194836"},"_hasShrinkwrap":false},"0.18.0-alpha.8":{"name":"@flexn/graybox","version":"0.18.0-alpha.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"bfe292e308ef229af072b3a2c4f7a13e22cadce2","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.8","_nodeVersion":"16.16.0","_npmVersion":"lerna/4.0.0/node@v16.16.0+arm64 (darwin)","dist":{"integrity":"sha512-FiEVxDtEniEw3y/rH/y4Ws3xC9Xzh2vi9/gH6ExrDhGOQ5Qh58PwbCsfy7ppwenpCSBsthubtuh/VCljNBbhGw==","shasum":"11d1e21d45e269fa5f98c312dc2d81f8b6d18d99","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.8.tgz","fileCount":43,"unpackedSize":87314,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDQpby16wnv5vEnLIyPfCi5UDZ9l+7Vs3NhHjSk2/CRuwIgSY/tcytPqkpJ844iS6GF9spjMn5aYJ6rXpF0Jmn5EL4="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjIYDzACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrK1g/6Anp/xXv974gQuySgh5LTDnXNuF/Gr0OdWC+qSi3YEVW4tj1I\r\njwOVoUyUoipkSPimcgfLedlWkZilB5aPd8/hT3hyT8idNc6d8GjIZALdGdGm\r\nl5zNmKmE2EurrJ7SrsZikvEsT6x6YLxQ0oMO5ABvW8y/lkbe7/WnS7COZ6tG\r\nFudvp+5gd5NHcfsfYMzfNrEwG5KCPU35FJlkWyaq5YjBo+qX/LyZM5+Idqv2\r\ncZnXKJN/qTso6YXF2doK/J4em4ecSPHO/OyaNhwtccV1U6Je1kuhRqhgEgH8\r\nQhyUmYniUfrD096l1ZXP5F3CYeJcCXIb7hAeulDY+t5Xoy5nKvlBWtdJuxJg\r\npySYiCM0H8YPVCEsChKDupto250nEs1OCMIo/eRqYr+XAe2AdsZhK6GBCPaz\r\nDiB6z1iNTypA570XYkYNUqEou27dGsDdSM2y6ysbQlkAhFvlmLn5q09VwORG\r\n6XxMnHl65ZrJVKgyWW9Bu5JxHiDxslMcEUvBPP5S8eXcGJI0A5bS06pJAehf\r\nqFUCx4Ee1DwBhhrXDabMYJgnOgtEueYLnwkdOK3qS8L5pJJ2gXM+a8zJVGLe\r\nQbu7ozzg0+qfq4M0LcMDKOChdBRnkNKOJ4b/0NDVoTQeOz6kfGLeYLXXJZ2j\r\nxw9Ldq76aczlEEZN8aUlj1gsRlS1pCfychY=\r\n=1Ysm\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.8_1663140083470_0.06241485132972713"},"_hasShrinkwrap":false},"0.17.0-alpha.10":{"name":"@flexn/graybox","version":"0.17.0-alpha.10","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ba7863b92b008dc129925d36f2a5b07e851f0b47","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.17.0-alpha.10","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+arm64 (darwin)","dist":{"integrity":"sha512-0CEQOg/gGycsfQ3B0wyZLq3Bu+ky57JVcXBU4EeYiMym5TzPMz4xFtJpoStN3+IRfKh017aK9RyVdbesQgBACQ==","shasum":"c7e3294b48da65071581ecba604c258f4bcea8e3","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.17.0-alpha.10.tgz","fileCount":43,"unpackedSize":86552,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD+7Ri71sbtlbxiQlGYyiSn8N4ZNOrxlXcD9pFSURNWNAIhAOyiciu2YbuBXCjcqv08DFFtdDhk6x0hymg/oLQFtnaH"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjIZEZACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqW7Q/+IMtueVDX7Fy4Z78ROws1EF2Auwfkv7dzSNc8yyxHT3g2md6Q\r\nEh5qWpVwrnxxO2NZQJzBnrnlbw6QbuZi3nVh8aw63ZzfZ6DKXS30EVEYB1WE\r\nUVr9dCblkikBrH48/iSpjWfwCjTLKYwo9NMEDqp9L8tpHT+9H00ULf4d/nDb\r\n3G5ltyF5xHzJPG8NHUXY+IgKGrA782H4fs/ALUplwQimWPSbfyRRnlyu2DCc\r\nW2ekyb8QvFkEQStwkrglb0ZPAyURpFweozf5EMGNJI24t4+TBo/fsN/N+CQv\r\nAjKyqMEj4o0j7aUFy5sAFzcb1zmD0T/9S3YbfUIYtbqOyaVwmeNxi91P73Zf\r\nAIQDzmjYm9KLOdFCXiQ2F6dAROXMhQS2Iz57fzasDuSPRADHdRhVO+V3KHFD\r\nybg4EUX7b82nzGDZrvVSySXqaS+2CQ5xE4EOoliJ8teYJvTanaubhdevfxuS\r\nhcyKc0yyYQdjt0EvMDS+9RaIyI5fP4aU+6KAa0WJ96zMfDpr15UhSvtfLYs8\r\ncL5+tCBiv+qeG1nwSQobe+RjR55Fh+FQ4dXdfXYUp7B2Lp4UWLcpp7AJQt0Z\r\nrBwrfK3qFQRUijx5qt0SCPHlXiLRdr96EN2anwb7Msc6wf/4Ywzb3d0kySK3\r\nCOW5pamqtSbjt7Hak9B8t4csPFacUFkds7o=\r\n=xpVv\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.17.0-alpha.10_1663144217245_0.6154192123429756"},"_hasShrinkwrap":false},"0.18.0-alpha.9":{"name":"@flexn/graybox","version":"0.18.0-alpha.9","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"96d75f8be569eb1f1a516e24774b1779f1620ba6","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.9","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-9WE/+O8bGJDyQmzuf0V+pWu5ZrZjFDXAoN3FbLIZJI/3EjC3Qdq9EGRQBiW2wD8h8p8/Hr1MdJHdZKuTZbTITA==","shasum":"f7e2e5f9e76ae29a3166f49ef730f2eedb2edc87","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.9.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFOGs7S8gK0Vf9r1gen9CJfVBr0SxeeYEpcR4GrIHlPOAiB4tZOM1BwSW/MLq+R4xNDg9k9hzWrS+GHyoYe6VGsfoA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjYn3jACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqxIQ/+LGEjffqAoIwz3LtM8ZYpXsdF2HiUY0YgISH40LYgyliSlL8J\r\npdIoiWe4SGZCm/SgleIhvvtCHIwqRJJ/eB9APwpxhg70e17PAq/+6PdWsryX\r\nXAwB+PCJtyoyY1wV6z48oFDz0ZCUhf56t7HmYKm7lT+Buazz8/+qHMQKUfK6\r\nC8G1EPab+gO/mgwgpzFd7Te6whvIr2ce0xVbNCVr91RrYpeBiuMgpCaCOIgs\r\nCwv11TSsi7j0w3fWF6gRQNBYC3pyr8YDQTtKiXOpe8RCcS/2jQ7Aj7a+AO3w\r\nz+fMaLjajp32/ZZFAwv9xw5m8O5rCWRTkPm7qIZ4W+9WQh7mpEaY5BFktxpW\r\n1AFigB7oXCwSvC+fuEwCZKwkR9JawvT9uGC34nycTnQjmcFJCAtTumMNis1i\r\nz43F1EZjsiDCeiuk7BTApb1Z+Ws9dPkthIXDopZcAcqZ9yJ4zZEMFQwH/st8\r\nw8uxVG6s0Mtw/9KHK/nSHEDVCsOvOt+5TFya62N5RxtaDlap/8SQR+W7alXE\r\ngAFSYXTo+l6zhLHgzxx4uH7yncf6XsgbIc2hpNtJ3+WG/+CBsbwKdOYORvNW\r\n9UDvlGsupgplTd6M+MYnENlx2CcAnk5O+27s0HWnfvUmVosjDs7N0KToZAYJ\r\nPdj7B8lO/vC8/jDJS/OZlFGqdPu0V2QnZn4=\r\n=aEEX\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.9_1667399138854_0.03658949469909789"},"_hasShrinkwrap":false},"0.18.0-alpha.10":{"name":"@flexn/graybox","version":"0.18.0-alpha.10","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"21c0a05722821e9d9da07ccb353040249ce61fc7","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.18.0-alpha.10","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-N/QZ0zVefhHXsMEY3R0XerRMGCrqVCi4GvqXZidDAoiXXwbE4UZIXJxrxkbgQc3fOsU6eBjC/bx7XELqpQ8pmA==","shasum":"b589d29b8f8f22b0b0f0e400aba602742054d652","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.18.0-alpha.10.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCYNspvqQjzGUmHwAiHWtv3UVFWr2j5ZzF2qpH6C1g/uAIhAOiAZsYdYYg5n+YdbBrKJynfqmltQnFkDN+oy5YAtZtv"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJja4CpACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoRew//drNcumWI0Bfgme47jU37s+J2IQo79znqBatQhdx3jMTVMeje\r\npo0iHIsrWHLPXrxuLV0zlwcqNjoZ6uEoHsuuHNZnAICSfJ5JlqxaIO5zY+Xv\r\nnBWbFXhK5fobfb2HV/njBeKeVl/p1u52uxsdX4gOCzab8etLDf4k/6svvdF7\r\nEpxMF0I5no/02Kr3QG2EcewI7sMy46VUEJTNC2nwwe9CD0KR4fvLxvc/Gi3X\r\nL86jiQB71ynXLaXelw83+7yZ2Ry9MHKRGmO7/Dax+tilOEkcTtYsiI6iNCUc\r\nR9jryGYJjLA3/6/gSz8ELmbcJHzgv93Iwr+xRJDWQ4kSEfpmyG+d8374SyJE\r\nPOmV68cdNYIDfz+gbFG+T/Ej1LGau3bv/ehB0Gk4vAtIPW5utJLtoRO28WUZ\r\nxH0Ovd0VW4mcitkZXdJ/w1EI/sJOLv8IDrxs1FTBDUqq4MXCbYc/WhwSM5A8\r\nUwVsvdDOP9YxWNtlf+NdMExlbYU4nMkqBdnJXjoDOxK2Z5rfAljJR+Fnq1Bw\r\nOX2M8lz0XIlFHozXLVaVd9WV0irWjvWPcvhe8rE+XXmM4Kd+sCCd9tBghByn\r\nFEwtrYkjtp2DxgsOd4/pwC/XyM+9p7aMCCLJCwdOcgqWDyyEgyU2EkLOi8Le\r\nokV2VZSLhl9MOg9xVdIgwvmz8iQ/EliptnU=\r\n=kjK1\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.18.0-alpha.10_1667989673011_0.843368849965509"},"_hasShrinkwrap":false},"0.20.0-alpha.0":{"name":"@flexn/graybox","version":"0.20.0-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"36dbf46205d6b9c60b03b12de2d524a63b2abb65","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.0","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-O4GkH0tZX18ytqnTn+/cxSxU0OfebM5f2DLcrRZSNtofqUXNzBl0uP/xsdoz3S8mYAP9zGUPy23SpimW40SR9g==","shasum":"68fd9b9365663643c640b010d5d6ad960a87f162","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.0.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD0gKioCKmXdp1VjSGPKtvaoY6jNm/wH23oLCFVNqrWaAIhAKkK+6h8eO4g9ypz6IK/hOGYVYazHLOkW1yYrba0QgSS"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj8gT7ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrMDQ//ba2FHx88v2qwgIv/pMNfavA3nhLYOCW+e7lCnZmxysILIYqU\r\nCVuxKokLzlDFaPf3GlITEoVdrbzhOZSyXOxQn/Esxsc9f+T1A3tle6IH7hRA\r\nQiQnxgxOpIIEoVERaafJAlXprIh1Cr3lnsv95OpMqFvmmoAEYtvk3oE6tZAi\r\np4+QVCON9FjU/hyrAvQZMLmLx+MQ0mWGQXbZDnFgxuUBss1vqLXzfbYEhPLn\r\n7QATwPM7khgCdcWoA7XlOTClzUQTvICLs4t4XeE9c2NeDQZ/UPH0PFV+xYMy\r\ncl4+SzQ8IHbcZUBGXoOWyTLc7bdwtksMUTvuuM9YTa20fu5Km8K56WK9H3ic\r\nwH0ctRP4MVyYQRKd8Qq/1XUm8fkHleJpoZj9b/IHzfFBiJRWUBC2ZieA/a3k\r\n6KN+YngBjKEhmAY88N8ypICOfDTPAnYhAn1Jpnpm7Lmeu8pBazwkgZjYpm3t\r\nquutlsSbSuAq4b2zY+Kq6uG8kZdXntTPYKC+wEa4pBHfUKS/ANWEuvF8RX/G\r\nWavY5jDXu0tYYBGWBCN90UNhVwEbVe0eiX6oPlfN4nCuyR1XA0WXaW4CfGMw\r\n5FacOyJ/AeDA/4VKJE0iq2ewkFiPp9H6n1h7F7sAukAY7uFI4doC0ofLlpoO\r\n+ZhLc6JFS/H3tyhnMNO208pCe3Kqbj0O5hs=\r\n=fIc4\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.0_1676805371584_0.22845700380839218"},"_hasShrinkwrap":false},"0.20.0-alpha.1":{"name":"@flexn/graybox","version":"0.20.0-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"88786f23b1bd9c2e6aa287d75172425b48e5283c","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.1","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-NVQrlZKlnQy6/Bhk4vl84I6x3PMwvwDLDzprErJ9dF2Hku0yaV6TbEmcWaF4fqxoAIo3sP/BFwsgJnie9e+FLg==","shasum":"9d2a7265aa3e2b6c8bc9ee0f13618b7b7d448825","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.1.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIAwiTyOWc6mD5/4obbH8V1oKBl1I+agBMUhhk2LgYlOmAiEAr6t+9okzWGjHFXc1h7b3pyxv8R2VwRlM0AY8ti49yLM="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj8lMcACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp/7A//daaOT2E80d5F+7jhDgFuMFj9jNdU1e0kzgK/iwDlDaEExzob\r\ne0C+QOWixeT9hkL0YW4kB/RC3UgfrE5FiCuaZ20PSpkvv+WCB81+pQ6PnKkV\r\nPaX3e7St63hsgOhO6Y+bImKxPiIWWEaxgm0pQFewGzSfYBHIFy37eEIk/xmK\r\npNRdU/au6hf5vfPMoQ3z7Ahgvql8dDtGkiJ+BkgOjHlN2wgRDg+S+yvGbFZS\r\nF4duqupGEnn8UUrwcg951fRIDqgZpm+VFuPG9B4dQq4YGH1hvXyg1XxzIYPl\r\nRk3hFK9ibsmwvWh+6NiTY3fdmPbfdHLhhCLEE3Q703zTRuZj5vjqYFzsxt66\r\nBTI/i2Crw1WCZOz+9nBLP6B7aotZijFffMiCHtN3BlNKWWnt2/RdTWpFrid9\r\nkXmqTv7lSkUYXW4iLSfa75MCciq6HbD90hNXRViC7zHTyK08yhuwWD6l9LVY\r\nC7YTJnSOQ206gwg6z7CNmEC1YQ5Of9YhtJPNv3j7w9hPMOnsCAqlfWvlAfxX\r\ny10giuO500/fcD2YRDnVCB195ZxSLP1YBuw1jvjHO0QnWevQAEOLD0dZ3DQy\r\nNVOIeDdfPPKf4VBqBfQ0rsi3uw8UBz/r6qY4UjtCePkkv4sfibo+VTHo50bc\r\nFjkWqehUhu7DZrptoThZ2QCCrqEVcgI8djA=\r\n=f4jP\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.1_1676825372759_0.05391977755036215"},"_hasShrinkwrap":false},"0.20.0-alpha.2":{"name":"@flexn/graybox","version":"0.20.0-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"6fe03640da055105b330138bdd257d87ec249bcd","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.2","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-YZmZvKroj6fAV2ipgHdRKUzUqzphSc/VvTCd+Cki2eOrB53VmlPcu0DoZPnSthBl8FguZ4Br+BI07GLdEGMRgw==","shasum":"6008eb67fdc6426c3f9064a94c4cdfdc20ea6643","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.2.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHmH4TWBsSX5232/a3J2CSIGwxIzEWoD/2rL9wcj5h1KAiEAobDwy85VqiGtDSnH3ICy2O/qyRuOgytWsFCsTseSAxQ="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj8nfCACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqSGw//cYjFVa7Wa314gIxS1Zr+NKac+kLdHLPuk4HE6uYZ4je7fAcj\r\n/oKSFaRvwDjBqag+iOwmXrHJnouq2g/iy6LW6/n1NmfjHxh5MIz5/BDTnulS\r\nSF9P9SK6fhJihjKpkSreYGcHLNB+39ZOqpJ7Jahf6IHMljAmEbPh2IM7cu7B\r\noU1RWthOXWzCZji6VnN8KvuBk8NiDbvmffHzjKTOTFk1Xj6Y1GunOyta8wh/\r\nz9DW4ZCj2FLtyG/S7t4bfYTj5u4ih4sQbGRgxTrJxyed0p8r0aUfPvEtcTHt\r\neBjq448aHhk27pVxR5fkiyQuJCaqlbx4JEtCW4IkPUc1G/GexmWewA0CujgA\r\njVw0Vp5t5OoAKHWh3JtA9PsqXY3StnuKXVrc39eUQK71P5odVFFHrfk7uHBC\r\niMrPRWffL+TT1vRdiynjY1FMl5SOVKtfVLkcbNFqlsV9c8TdyHPMk//cwnmD\r\nPAPggzQG1OZgb9owKk48xGKCFt9C74YRa8EJguQdfczBRX9+XTz5laJjUfgn\r\nF3EPg9Q/3IFtOnEQ/JjhmcVf90UHsX14ZIUFx82Id/BmIFQFCVOB700atUC3\r\n09hI9HaFxNrKF6nemLuMEunQQ2D9Zoqq1byhbjxbC1hLTRumxSHqGYJ9+ND+\r\nF/ekMs2Ovq6yY+f6NX7MRPVAWQdMZrzxmds=\r\n=KG0E\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.2_1676834754465_0.061285414786768744"},"_hasShrinkwrap":false},"0.20.0-alpha.3":{"name":"@flexn/graybox","version":"0.20.0-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"3c48512b16651ffdbacc9d0af36bce14bb7e508b","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.3","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-ZcVonchEJ6FIQrbWyDplK+hd+NyEawYyIGX9+aBIrXC4+6/QELyloH3v8PUKfhCGZUMtLxc9bHhq1PapX24oSg==","shasum":"2181b8459318ecc4c3048d008771939d408a1bf2","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.3.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDnWnoPIw9oBcwjS3UKtzsOPSKHWzX3yQLiNRuQGaHA7wIgPn7wd2NNiBpBBHL3XNrVKOf84HrqzkbsopygFnhG/Ak="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj89afACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrwqQ/9GI3WS1Us+0FcszrodVf5HheM9onCu8OPZ9aaAaPZr1/D75ZD\r\n87OAmlwPg61ecbLHzRyiWW0Tl/v9jUUc9z/ru09n5CQOcu2c+5aZwdmvpC3O\r\nfSkTZkQjDk1DRzK1ClFoor58mxUrSk7uDQpFoOFjuxksU3Hc5l+ivNrcJyJZ\r\nQM758JqwVlTK3Vp/I0Zi0pVUNQEy8kXUmMwZZOwxVE5A+a8E/mAqu2XVaGAN\r\nz0548myd4yWlsNnFL5fiehOpLfGO17v775sGe/VbSRTyXAaXOd76oWt30cyX\r\nma+WK26YsYXgy09fvKu9PEJflJY1xr4I5ZbeiyKHhIXeS+kgJT+OnZBdJ1GI\r\n8jEcXTNMatoYJ+vWeIL6NuHlTZiHiK0zi3FFSZ/bSWUQ6OXz4bmzfH3kHyHZ\r\nOFZQ3bb1fovTjv9W0BBgdyIW8RbZESjzyFbHeej+oWs7volm9mZgSsYNfqUG\r\n77XESpRzzLyPyxyzyykP2EQIVtkDIh/Uc0ZywOOZgZtrc19Xf7grU+a250kd\r\nTT2ngY79Aa7RMY4OW00q4JquPtMGN65D/Ic0MPk0Xsczir3VSlCozyqZpGhg\r\ngKScSE04FZ4HvcXI0f8IbnmyE8R1XOxwNQfB8EiivAItSpBaDrIZFc4B3kK5\r\nH0v1pjj0mI5qFMhli2LMsqHpVbvUgazYbFo=\r\n=nBTx\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.3_1676924575536_0.20261701270975951"},"_hasShrinkwrap":false},"0.20.0-alpha.4":{"name":"@flexn/graybox","version":"0.20.0-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"a4ce0ed35b0cd8f3e1d0f86794012464b0fdc886","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.4","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-2rcZRIOUu1gaWAHIiQtf4CZZD+g7/6vbQS0oZKtwIhzyunrN+Y4zThQwWkc9i/YYfN/BpHDDxOgj/p8GmxCRbg==","shasum":"5292bd644b0ce40c39b8f7dfe366e3ebe7d6c2e5","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.4.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDv5wiWDhSvnEVFXpQ/2IhDmd1BtOblHWYjc6QgkhQtRAIgDWS4SL//pK9BVjY41f2nBkIUYvcS9aXcOt4JKqod0v4="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj89lrACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrfxQ/8DN1KSoo35Jc/k58rFBY4r9MpDxK19bUtZy0v3AJEN7eKsbfc\r\nHa04LHWnr/rgipG5uiRvBMyOoh3JvrrOKgBBOufMyAOTC9sQDf7mCfK1tHvu\r\nTAl1k4VoaoOeuMGHzbTLtR7fqYcgY8TdzAFfJ7ZMg8iT23Hh19xRNYFyUUuE\r\nCiL1yro8ELnLzoNULRHbOca1txcqjtxZBfM9Jew46qDwirrfDq9L0xiPeoCQ\r\n5a7j5xlvf2FuuZ4C7hS6WGU26q9ih7dq9Vs3+hR3/nu9zmGV+PMcfwGiQO73\r\nCa8lwiDaIOJkEUvMu2ZB26QZOwtko2ScsVrvjCnFsuQ9oWBPVPMmKSuQs62f\r\n2CbEGOi9vL8yOLBN3Ge5aiAQKM1zOAc88NsMoLcrigHe2n8JV97lPu1LErzU\r\nMcpoZT6E8lVxXjUfEWlnly/xu8Xb+ExzMYYUIFYmRn5Q/eSGM3EUwxVSkg1A\r\n4+ZaFdoxaTWlou5dYEEGbnkYNhl8Jy+MpewVgvbbsTWxV1fZzPOT5ddK8A9d\r\n1J0p9s5/Y+AlCVQM63Aay0nLrmW/QSPhSV61hyX8AMdMIBUQJJQ0kRAtpCIc\r\n3QGz3p3VoBQHNU901/OA5JDAhU5FaXYzbpPXN9o/mHtK+BbAAY6RmklUBknL\r\nDGImXkGhh6hKoIRwxobrH2p3QO+QgxPgKtA=\r\n=aV0d\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.4_1676925290943_0.46638436763698277"},"_hasShrinkwrap":false},"0.20.0-alpha.5":{"name":"@flexn/graybox","version":"0.20.0-alpha.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"d9d3308a5c93b0b9d162923e531dcad7e2ca3ae9","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.5","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-Cyt1jf1+Uek0AplyBRJVrRsGB6Giv67tfL77Do9fsLJ6HOhKqwd0AsxzD1SuaBeCUPXgzB+LxhjiPnfFInqerQ==","shasum":"1518f05b02498ab4cdc4d3502b4c26edd86a0f08","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.5.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCawksBEIQZhb5fLKraM2kScfdFMwCaRvOKtoYEHKVtmAIgKaf3NwWgsmOxx7mSn+xh+ExDja7J06v3lXABI3Rd/GE="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj89qdACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqXKhAAmXfborhJZo4V4QWSQYf4tgfNTUed53WEEFXrgBwc92mVZlWC\r\n6JB9j3cMOmK+lcxxBAfLdoWyFyyZz+NOZbla96o/DPbcvfe6swb3RTN6LOVd\r\nepjoiZfnPvKhCb1pp4RnffXh/KUouvyq5S9yzP238uYSY8L+maackYQ3uLGZ\r\nIo6BIHBUYwTuU/ofNBuLDHZliRfTLMo/YapdoBj8lyyxeYuNfGPttKFOic4j\r\nr4JxQnS+e/74N0++I6LOLGsT8OAV9jrn25h/sMd5fKkRZqBM9P31nQhT/6x4\r\nGWSQcCNOJMGju4djvD85OyJw+yMSzwGbfxh38izPpsao4bFeKYY094dOYDIU\r\nnL9v8UrIHxJEeYL67/+3bXel31s765b6IBGfx0pAsNkjCcEOIyARmJWtDg6P\r\nwf87RI8S1uPetlvvgdrOsf6D9O8sOvpQtTAWQ0uMv1MOXZO+Mn76wVYaN3Uz\r\nvA15+uH/9n/ukjs7AlD1+pqS4fTnq1g5zZ54GV/awH5+Qj6k1tHRJ9ox0aSZ\r\nP3kBbM/mFoy7aUk4d1fuhh9RZu7V+pHiNe7/IySE+hMIEY3/t4+L65zw7tnf\r\nMDG3UZu5PdGMUS9x2EohOpXd1r2Ls3826hUmfRL01nfjS4jE98KhFX7R2eSf\r\nfV1tWsh+ZAxLKSxTaVdKo6J6kjoYYQmRi4Y=\r\n=rOcx\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.5_1676925597590_0.4220470478910212"},"_hasShrinkwrap":false},"0.20.0-alpha.6":{"name":"@flexn/graybox","version":"0.20.0-alpha.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"7caa53ac5eba94c8ffa9046604ddf665d4b39585","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.6","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-lnG+Wvhngflmw7o6z5/p+XgbTZrxUiQJK5QXtCr1tDnE189dl1+Tp4XqiYlXcV+DF4iKjZnQjPIBE8kUpwl+mg==","shasum":"b8be44ae9493eedce9241ad2a6e071dde9af0e44","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.6.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDsAu9zzCxC+UXlzv1EhY+e8ncQLGVhdMWbCzaUoqRxSgIgEuarMjUNoAQS4b4mdNZ+As6UpfEI//DjNi6CTyXP1wQ="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkELIzACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqjDw/8D5vcPXRsmctleFlR/s3vnx3upBjGnL15Pdo+y9xsOc+J/ntH\r\n/c+HdXqDZQONpYlQVzZ3HIyKE5N/hIUQCFQFCbeMH9ucOhYlRVw/karx6Zu1\r\nplAZ12i66X34/6nvOU1mpaVR53jyoH5FPjpV6u0ggXsJXeP89JIcr+tXHRaO\r\nEz8zhy7b5kXCMXo1lxaovagOujypLn1dXshRGlvhS7QwX50FV/3HPA+cfoFe\r\nNZ8Tz5X7+pfKPIbRYm295bWRB4djTsy3Yk7zZNxpJ39GlWxNq3HPAPKq+x9L\r\nVERIPesALff/TFK7THUUNlK9debzvC6MrmlMRdjtx4iL7lACeHcnZzdr2sxH\r\n0t6+1yNSukXdo9gO/pBkobBZ9FgQ0iCqftrumFaPxV+t5Evi0H3q63KI6YMa\r\nNRF4wd4cgkxoOKTgiRiP7dfc85ryiR8kXo9WNklu3Sb9roBMVN7MNN5sd8Zq\r\nu4Ijz9naEr7AknMD/f1EmjkPuiksOXON7UHO1h+0v7ZHqpPH0iy7Ggmd+LOE\r\n13xzQBQfTVEPd8jCHQkm/2/VjaeLnXqr9DMmbOE6FY1PbUZea0FAGbAOHnv+\r\nLxsa0xlmAS++BZo+yMX3NvTK4VFPCY9TN9tBjCnp1lNb31t1F9/OKObhM4Sr\r\nCoRZr18Svj7tAkT9oWYyLpQ/Qsu77p4ZfnA=\r\n=Unt3\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.6_1678815795488_0.03159733979896906"},"_hasShrinkwrap":false},"0.20.0-alpha.7":{"name":"@flexn/graybox","version":"0.20.0-alpha.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"165f1f0f040f33c51175c63efd784641bf9d1525","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.7","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-OMGJJqIn+odtpzwa9+ACLQ6bj/3YxuXzOhBMVB+ihSnOPN6AwfGD972UmBkAQthCUtx6jfnISeascekX/nbM9Q==","shasum":"283e61de1330748eae2541abed1e0253b7d42b87","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.7.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDoDHozkTxqwcFtIuzNx5ZMhku2PCpS3H/UVGfk+JZC1QIgLvnWJ8CkhZclsKUJrybalWtxHFjsEcu2hzYNie1SgNA="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkE08nACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqYLg//SzdGQSYVXGLeixQeOq/4Adku5IQ/NvJ7GPq8fL7WVKEqsF/Q\r\nBQGWiMkWL6sqmh5bGzgkI8EFIoNnWxXxrEhztLnPguzh/HO1I4z3+Ms5NuWU\r\nfS9GjtnnClnB7NtNemeRAXOvhq5XNx/rI8FGRggLEEdIkQjj9namM2tXqgU7\r\natMZV6/swW6K3HW1jBeF+NXm/jBVbD9Rd237Yt7Z637QT281dt0RsLlQXcPZ\r\nDsUXvtNaU4Q9trabkt5CYstDc9tY93mZdEIijeqLOjnLNWKBbJm7GZuJFFv1\r\n7ezwhIZmR3WfijhqsN93IJNv7mWb9pinqnUDrB/VVRv3kTpH9j2IxgnqPm7A\r\nKktIZRnAbYH/6ef7eikLz1QW6kdd7lEfJQYf0qmpXh19rOpcr86tqUPjUsHp\r\ncYyt1ORIVghbr3Ubk2tQ023lJNcvggIojxxtPZ71EMvLM6cnhtsPjG2GAQ2t\r\nDxI6jV8Om+8m/uH1kK9VFCbRu9KTtI+4frF4rjhiwaaOJD2VasDsG2srZYN1\r\nucRd/lfk0mEX8uiTqZeIALypO9C2/ZX6hg4zYAEqg/z+L2z2ckClcw7GtIAX\r\nWdTRtjMRRKVn4iJXXgVaHG5Wgt1QglMtTqpbDc1IztZVNhC5VAUm945Wm7cb\r\n5/VidceVuAZIqFKAujbiPZIiD8IPv64Fs94=\r\n=wXgm\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.7_1678987047548_0.37417065829789453"},"_hasShrinkwrap":false},"0.20.0-alpha.8":{"name":"@flexn/graybox","version":"0.20.0-alpha.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"68841c49f78d85459b80bd79ec622dbffc6ac971","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.8","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-6+K7DF8gJIQs3moO1VNfsZX8a46ieXd+SC0JJKThxDIIxweHoCjG4aRrdkXxOy+1Sc/WFBkaVmS2rMZl3cAlAA==","shasum":"8b90e97020764502e47ff61c5c098fbe62ae3497","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.8.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDkuQ15xjE4qqvGjTu1iWzHYHpO9t41JyW3Oiwm3hOgRQIgTh5FLNVUHezt/08y/1f9wp1v9uMaVzOeRQMzVM7J1u8="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkE1BfACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmq1UQ//Y10q1gpF1Ld2MLYpbrzWumIs6J9MFk9mfDy4sZLBAh6LPoWC\r\ng0QyGamm9W8jtzOnYMRv5B8ub9qCc8vVu/PQ215PN2N3KSrHmawuMwdHce0X\r\nZwqgljFdaA/XOmgr++yZ+Jbj8ymfA/b+fwwx9OxNKtoU/eHt1j7toaasPIp5\r\nS3vDEFnCsEdk1uxSJ0Kqp/IJnYN7OwMrlwulIi1wv/LlkU/zh9GSHxqa3M9t\r\nSy12DW3qsGJAieBbNOJUHGdgAI7y/zoOaXIVGaAMHYOGRj7dx+g8zXLEVhLr\r\nO/FEuT8tnoEsAc2gI4TJVq66sNDIaZnz48XxM7oYgiDOoSZQXWH3U84bIpZN\r\n1r+hPTeXpoi2PkXZbOV+b9PBz6aJKW/RdZ//z1YZlcF0I4Bsfae89G3/twks\r\ncsoSThseg23NovJ9lf+BYHXKc3ktSiFJ2EKA0YvuDaJDNxS6uVsrIKvih3KU\r\n/+JNQwrw+f72b/JjjFzG9XYwioMX+QmA9hMakIwkZMd14+FhWgupaBygSkkG\r\neOJ/2vd26/cUagbEUr6mBcYD3Cq9+8sDNh8KLyuLd4tOqRng8434wJo9Erhz\r\nB7KN3CEOb30neq0qmc4tazNW/U4WzGlIidw0udBrLmukvqsKgpOty4rsbsIY\r\nnQbcbC2+aIMzTCha8Wpwn1LO+1tkjsTs5Sg=\r\n=sNDX\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.8_1678987359137_0.3763874253321631"},"_hasShrinkwrap":false},"0.20.0-alpha.9":{"name":"@flexn/graybox","version":"0.20.0-alpha.9","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"a8488852095c84a6940f8768e111f4d1364bebcc","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.9","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-8SP1IIqvWef0cVr97GfRwgmtQLNxYgFp0J/7pSRbGfX0fRA1HRVllfNjhCxW/OMHu6UZelIBwIp4zzs68SHogw==","shasum":"5a02c497a5b005fd3e9d63dfac8acb7bf2dc834c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.9.tgz","fileCount":43,"unpackedSize":85906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD3JtfF4NnjLA60Ds4w/2AHe46VRMJDmXObi3KUrdsgUgIhAJwAU3tOltLlig0r8qcrW4qsY46eCLESxOpm9P+qqg8J"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkE1l4ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqPdRAAmX2C6LBCfwsX31WKbZzp/ZZ31VNOL+pZisdt8q0iROEAfHDC\r\nQVPY7UePYNPh8HmhuGhkMrjST5qWbtFco65fHFDHoBzIWsboDmJPNjBQlCjm\r\nsXWSWf16VmfcSTNlM91RcqldGX4Vwzrl7Xgi24lLbGmg/vkAnCchvuIeKYzI\r\nnhbrtJo+9RvTwK7MwQyciMK3gzI3gLD0qThUqTEZRl89Tv6OaHNZyWCZrm11\r\nGSLJDCWwsJJBL23MXCEFjfAhkQL1uHX5SXuNY/9H9HOCbPVdmN6QUXLC9bue\r\nNm3CX+I6A737pyqIboE0wHPjqsEfMXFEcYeEeX3uxdXy+lj73ootbJTvSUSr\r\nYld4UXsp0cDm1R7aJuQlOIBVzS51mnaRXiikW0yPbSMg/Lsz+PETXJJvlHo0\r\n/aX0IguYjlp6AWIxLvqT9U1oD+pvpCfTRVp/YXmr32FHE7k9UlaIh3Q09MvO\r\n6e0meSWhIK4Kyz0k6xRPDzugJhGIwzmTUO8Vc9z7tLdUZTUmAY/EAIWaupHv\r\nsXb96i0ZOdsA77MZ0gALPbNM7qlUxrZN/YWDY2Y+T1w4emuZfOfeCCC/AOB2\r\nbhbm3qyH/XM3gnA/lbq83aJTxfLWXoxpKces9/AcDjmndVCcRGEtAYRdgrKM\r\nw1/Iyijyy16HUrvzPuOD6z/plnlUF5AXqjw=\r\n=tv6+\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.9_1678989688548_0.8002545315671974"},"_hasShrinkwrap":false},"0.20.0-alpha.10":{"name":"@flexn/graybox","version":"0.20.0-alpha.10","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"62f23dbe4635463fb7ca1fc7402ab32d71e0aad5","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.10","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-ReqoEyPAiC76HUIhlY4rpzRn9uPdL1mgRwJn83WUTmiwaTEF07kPI0MCepHhmN4ChVwQraYWpobsyq0kXxsCPw==","shasum":"a8f55adab41866f58e509188d2eb865e275e1a54","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.10.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGrWqgb8RVN5XB8mOa1I0KSGcfj3obqTSNxyT+5yyqTCAiBpxWnplx3gCcUbxulBn4T0PUmbEFJCGVLKXlO80i/kKw=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkGC2KACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpOUxAAgmEEUA/Rk3Kz8zvrvu2nvMDXABi/QX7WE1rHqcZEhPSQcvZG\r\n5OqWm0NmB8Yob9aboAslgb7YcBkJFayER8QAaE5ysyKkT9lJKcLYWbAavq3E\r\nDuSEH9xeVanVeOzAdwp38iFyURjWEj8pjkD0eECwDkKR8a37s8v2uSYXMV/c\r\npvPCrNVyOsYvxxPE84D5OdQN/W20vynl4sm885+9DHAnZ96qSx/IYAr/Mb/1\r\njo+7pn2lqBeEOw9g6eHczodzfEsFWxGK8a0LDk702QCrPw7GucGxgMRFHrU2\r\nAdYeK88t2ytTpw1eEAUQoXmCCpy5IEyxYeiISA2S4MPHRY6y0CH7+PKeW5HZ\r\nBgdD1Q9IRnXfsOUTPaWfOkRXoaEE6s090ypGv5xechqjHerF5A8hMsgyIo16\r\nZGHMIkjXc2tqHKk+cDRqO4g7tOdqr02IuhHA54ro7TKiUE3Ni+HVcUQwhSYn\r\nkE1Nyl02TYsGuWZJxncX1MmI/wd4S/yq/sQPdkMYfovWQ6cuCj02GRzZMBJL\r\nXYkdafpSp7vVMyVbzXdeonGtt0Dgo23u+5hCkjr2z9e0Ik3USBIzwyoQi6dy\r\noHBEeNr3ruvwIEFnbL0gyve185jEwpUNtb0KGqvhn4az1AV4xxmHPyhDlvr3\r\n0tsZC/3tYQPxDfD2hdgabu57yZnz1EaWdTY=\r\n=qgug\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.10_1679306122201_0.8247863612708726"},"_hasShrinkwrap":false},"0.20.0-alpha.11":{"name":"@flexn/graybox","version":"0.20.0-alpha.11","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"b0423f1bdbeba8930a00c7b43b8d0c6ccc2ad4ab","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.11","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-gwREMA6g2hVWzkQVRzAtAd/PEMobn+QM6hjBTrEbb0gJl0V/aIVozXKZaQbiuq77wVtpKRX+g6gwQx7SJPjnpA==","shasum":"90b74a3b2706a7cd04fd3051db65438bb3285d50","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.11.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIEMh4nR3l3c4BK6KJ/tGcLs79WrOFMHV5uv2K5EqvcuaAiAk+eCJAfjx7kv0W5AfA3ZW8yY6IO8oREtRWBua50P4fw=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkGDJMACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrwjBAAivsRPxYrapKzHdtsqjmkOVxOpzjPlMNlOpht9QFGrC0+lodg\r\nrjPM1jwrjqsQkTsrCRQEWOVl6v+BaOfpSnMrcmohBtFGp8Fy3CxHLdp+SGfn\r\nioHmr9hNynG87D90DFNKLuPVScjijajZrp7vDpGY76uwaKCh1vWOrE8kTCuj\r\nxtcKIahEsfBg0d7h2rOlr47eTAozydfE9inPC76IR76E1vBeREl3rsAMyQC7\r\n9HwU0vfod7Pky+cCwWi752xujnUj15wyz8Ps08x9l3gsjiMDEAoA1F/d0LZD\r\nc9zThKKJNVCYzNW/YpVYebAxVtJLcgBXQ6bkmpCUlArYHBCcBi7RlkKxxwAl\r\npRb5xYdBChFRkRllKAoFpq1lz0seAaRmPj2ZuFBlyY9hVxJJPk62iyx97H2n\r\nEnLrU7nnauYMPFQOLOmqPa5ClEK4X3ATUVBxNkIgLMdjAh47MRsJaEVRYf0O\r\n/dVZ/+PL78YdB8HJZA2vvQKFo2IXuW/+mTN9DUDtVF3286hQU3T1J6hEZ8Ki\r\nFqfjJ72JubT73TnaA77eVhvmhTIu7fvQQYteGNmIGyvfkJ4LEShiQ3o1356K\r\nzH4CyPJ6rYS/V4gktVT9RefW7D+wfUN/lBj0gMNP/UHEZtZ2Y+vuv9xCLCa7\r\nn/AIAmQzuA2WHsb9xIbckSs9IsbPlrvWDEQ=\r\n=pH8S\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.11_1679307340727_0.30459145025629475"},"_hasShrinkwrap":false},"0.20.0-alpha.12":{"name":"@flexn/graybox","version":"0.20.0-alpha.12","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"5bb7afb013c69cff72f73badc23b3b6e9b97d7ec","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.12","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-K57qRPb5XGxA2dBQlBejgH6dSXey1088BUWsHqxMcsU3hpYCAjeXb55Iw0jG0uPLFNDxaAhuVQlzYpuyZDE3fQ==","shasum":"3867f52449309309e9b98c58166f30baf1525b19","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.12.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCbJMB+vQYJIBDf7/wtSlxgq6fe4lXm1QrfnOZHbllKcwIhAL2ZiJUA0RAH2A/RDyXpLOMII+WY4aA98qi1aySQFX6w"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkGFlOACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqryA/+OiPAw+sd3ttKeVF3uSgDNzVEugifTFsbKj6WwewnDU9Ig/5M\r\ngXrb6ElYKk7Wrg2JjkZ5VrC3yjWE9dhVAhQah7paYwGOXGv3c5xJ9V745jOA\r\n+ADmP7aTRjUlrlRoYPc9eV8zIc5BEy5myKP8AUz3UZQMEHlOhAKRewuq5QOF\r\nEkID09Y8b4jGRxyF6AO0ZxTlF2O+NRbQeMYXYNXyylxb+s8FPexT7N1SwcDU\r\ncMg6Ie5QN8dONVN814+CrfG20xY3ArkyST+qsSqcV43rlRwztDryMUq/k5q3\r\nA2JcQMKYsjIKPj6EKqRaNYh0bLa3+LzVxvescbB4PVtmvN3cHL49/GxYOyR8\r\n2B8DzzI33ba2JqHlABeYKIVjDUY7d4RGV8t0xpYcYve5kTl1jyCg+JxtAy31\r\nl16abOntJPZnHvdR28TAdsRbV1PE++XaIVPzfZ1lCvHVohZz1zwbH8Ua0KkL\r\nT8T7OGY/kuoAWEhUvocIIjXnNRZHKYZsqXsrWFCsuiVXHYkNSpuBsz7+PjBQ\r\nczyShJg/LJKRk4/mrGBBRTLEjGV1omwIa2tJUJwzO7pRLfiUUJQ0bnEyhh9p\r\n7rYkJW47PNxePOAlYwHebGzNmw3O605g5ErZJEdJkEIhrq+QQf6WeoeIj6ca\r\nmxyPpOjo3ZvTklS61Tm+iVHVyoD/hdWGVEk=\r\n=B8Ql\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.12_1679317326390_0.6378801061640516"},"_hasShrinkwrap":false},"0.20.0-alpha.13":{"name":"@flexn/graybox","version":"0.20.0-alpha.13","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"2fc9649e7a5f9f7cf99874b0eb8c63b259bf8619","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.13","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-y3zC6Cb8y/1b18TY7NBdQzC86UlEEdaG+fgOppsTHmw8zM/qLyBgZ7zwMErebMV7BcFynBAFrmMwyBjaq/qIfA==","shasum":"a13ab32b044eb280aa40f0985fb446b44aed5df5","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.13.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBT7ggIMVtyXoGGMC0/sYg8NCxF8vvfThJzHeMMlupSGAiAGtakX3LcAQ3++Bttjws3eqMoRY3RQP5MnMwma3NMNlA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkGFzGACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpjBw/9E4l1Px5+3+1Df5uSIAlL4UzjkC7VQnc+JftnlDGO9adkifuP\r\nWSSzp5x6lw5yiOLEzKzdGjYYh62Z2Qy0rbRpBzgNg+ijdGfgmRqf7G1kBCOz\r\n65EzPSuWbwuWToUgPqhx7V70n541NdorirNVAmPkHmGC1IC5eleOpzoZhe1h\r\nrBNREdNDJBgy0+fTo8cx10Gz/hImAFRxzYpsoNp+X6ZPdCzDTTkUNbKfB8TE\r\naluYBr95CTAOvn7WG25fJ8Yjz4x+/I53ao0XpBRS2wLbrYLqPb7tqoD6pfW3\r\nVZNXnOeITFiZpSJF8UWdZrMs/KPdMCcd9ATj98yeTMXT08Mvry9xpxFWWVIF\r\nVkJga6MtT31RNiaFsTcc5ftMXgiy6dlxtIZxyIaUfZL4/Lp8OAUUU5UYuNSC\r\np6PQiVcQZyOClPjgfRa0A1EkGx/XYJ1Svk5cbvBRwl96OAiu/fC0bFHBK8L+\r\nOqpV1tPsUw32bFMq4GA164qa5u493tBc5a27rk5kqtAU+W6IojCWmuGTBb6P\r\nNdRqbOhiIL72UXhcHQAebVIkR9M8GjVTtQmn59xg7GPCMAQKpD5Xx2ZukNEG\r\nxv8xmRJAq5bbc6omXLRYmqlRcMPL34EMspwwdnZNrGxdYN9YM5s7QMsPDT31\r\nLQuyv+Y4QefXtMA23q4ILXS6BRrEy2TfoEY=\r\n=23yx\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.13_1679318213931_0.11686966534052279"},"_hasShrinkwrap":false},"0.20.0-alpha.14":{"name":"@flexn/graybox","version":"0.20.0-alpha.14","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"e660095981b8014634bb0c7fc890814bb476af74","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.14","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-J8HhR3qa4ZzK8HOHSFJnGs32uz/+khgW0mMpwlU+umBQFqbVsKMVz/ABMZaTIzY1X+cN0jP5oe9CNOOTkYMJhg==","shasum":"690b3bcebea2e14a127cd70d254ab4003a9a60d0","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.14.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICpdDaxtjQ9b3jlbI46BEbbpS4ssqIVqy/2JYfw9HwYkAiAZsE2Nflg5b1LfMkD/D7YIn4Uxr+oF8fO+IEFwGF2NQQ=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkHr0/ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmre+BAAnVrHCzkZYgzbzP7MNP9HDfigxTaqs5qVAYHxHTfJiSnnjJH2\r\na2c00ml08P8SofE+g4EyqFBwlppb3lgM+3b2Ezg6iWUbf0mvxSPyn70jDXjB\r\n9Zu8BtDQluGr+T4O391zl3Cfs8/KaM0qQ/cVX9dzdHGMnyC97WPySkHPdP4T\r\nhtyN/fobHl7PgQo4kCD9/oIg8Cn3u1FE+gXVM68tF6fWQSVvopbWiuojVU6A\r\n9tbTLUO2hslJQTQfPvt4yySQimKWoI1ynx9ct0a5q38q21H4YL/qcgrQkXcT\r\ncioOB3SgOiMEpkZMs4sxQ0EEguEXSyLp36yKHQSryvncZHy076mjWG3qz2MM\r\n4XydJQbUdCV9RUmHVjgjjVlgrFwBzYf79N9QD/HjwDnxtiIVCPpXiFvgH68D\r\nsJN4hZSoUZoX4qTx4hoRnoKdLxABP0rCdDzjzS3jQYL7K8Hy1liYh+d9oTIc\r\n35KEEBvB0B2HKPBxrf30rdY3f43QqirDlo8Lg3F1PTDWjRj/2l6KlZalp4w1\r\njb9O+1B5WVh/N8buIWSLocJSFI/KqimDoDugcsZyN97B4SruDD3J1bSSMkNS\r\nKhyZyPdy2apQEsFc7cwrT/86e2TfcYRJn1Cd0uwG1W+ROLlctHnkuykOqUeL\r\ny3VXJYJM+yKtGv/BdOhsIdiZ9cXOfeu17E0=\r\n=mBHE\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.14_1679736126814_0.12167316285432306"},"_hasShrinkwrap":false},"0.20.0-alpha.15":{"name":"@flexn/graybox","version":"0.20.0-alpha.15","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"5847ab0fe4e409a67f7b204ec3abb71971340d5b","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.15","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-CWoiqTtNbP0ITHk0kN8e5wPNeGePsI5J07K5JcQ8lC/FLXOmIm+xMnf/hpps4qzgAw7X24ATHtBn+8p9y9FIFw==","shasum":"26b797997159c04a71a1e9940329400be472a032","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.15.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFLS7eG9QpBHgI3iP5MEn2szrwCbzhEJblP+qJV8RsLnAiEA/7H4xeXZjiYioNCon4Cw2gLmopcKAkvtwd+6dZVllqA="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkHse6ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqRsQ/9ErGtlPJrgI4Ym5WSAnTuJ39UjLmPDPkdgIBwbV3erjRR/XMI\r\n07Zy4BZSEj474Ear3gJvFTlHETqQHH/hxvLdNZ9BB5etG76aGw96awsiv0gg\r\nk00OWEh5Vak8ql5QkxPQCAyCzhIBU55ZDvEsTuwNFSsPVfH+Ik/EaYm8W/b9\r\nOU+/vXqTS5opiGSivvWIj4+R1jVT9daD7i48bFT3E5+6xLm22UNo7/bmQnDe\r\n5OSWwZ3vHa+ufsD8sKT9uTS0DCXfDkISLc3qiiqecUof00qVVA1bTsaCAIS5\r\ngXNXAUhQasalCsoC2+BXBrL+eJRo2crlR/foM5JjqjoHykwHGJohhYCP7+KT\r\nUscaZZ0ChJ4oDfC52vCmfZq9pZczG8n426C/kSm5mZOMW+l099rFks9YdQ77\r\n9uZ9+Be84fgafbUHsw9s6TmjXJSD0IV0mbXqh35EwN03frxBbvxcGr96fICm\r\nwd/z1CT9pS/5PQIO/rk+Y224wOHLTGF25DefWN0+o5er7efjbzRBT4CY+H30\r\nVS/nh/wgyNALnKTLEl35NsW63Z5vLldW7qz4XCxgGHblvY29JNKy+sJ+4Zg+\r\nfHZTmL7QIwBTOM89GUD+/CCrxjMZa4HMHq4SRIBJLEkXGE9j5hhbXohxUclG\r\neKat9X0Tb/PnKPCN7tTscgi6dQMxR8PRMOE=\r\n=Ur4E\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.15_1679738810334_0.665814026140235"},"_hasShrinkwrap":false},"0.20.0-alpha.16":{"name":"@flexn/graybox","version":"0.20.0-alpha.16","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"8.6.8","@wdio/appium-service":"8.6.8","@wdio/cli":"8.6.8","@wdio/local-runner":"8.6.8","@wdio/mocha-framework":"8.6.8","@wdio/selenium-standalone-service":"8.6.8","@wdio/spec-reporter":"8.6.8","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --- | --- | \n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element|\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --- | --- | \n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [Element with certain text](https://webdriver.io/docs/selectors/#element-with-certain-text) strategy selector with predefined `div` attribute |\n| Web | [Element with certain text](https://webdriver.io/docs/selectors/#element-with-certain-text) strategy selector with predefined `div` attribute |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp()\n```\n\nIMPORTANT: must be included in before hook:\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.getElementByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.clickById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform *Home* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform *Back* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform *Up* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform *Down* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform *Left* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform *Right* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform *Select* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `THEN:` |","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.16","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-EKwH3PLYTM4V3Ay1ZKBVR7T7yo8amtIJhq/7XAvGPpQ+MZHPXmyg35tryVXgG7D9Uj2b++yk0nf6nxVI/SjuPA==","shasum":"2bceffe96a22028538fa4efdecefdf987b458793","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.16.tgz","fileCount":43,"unpackedSize":100975,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDIAq6CmCOnRTZvAhsFxP47QvP/ZbWykdr8Z6v0Io3kmgIhAK4e7GDQTbPSA8EvzSKVnS0DQmm75J61PHucgi11mVW5"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkJFudACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmr/rA/+K3zHB6Vx9JhtND7DvuPDdSHlhe3kJ6QmWwHYVhUr0jlbTyrT\r\nImqRe4LDBdJSYymIiwuyhVWGgRYc2eCpbeHDieG9RU0T9+oZeIHAISMHibmi\r\nERILP/Lh1fqOfO6fSOIxKnvNr3wB5MKd4WndNszkRByFbH72h3T43vKwbWRu\r\nQigSshm1mQnM3qIFdxBJIgvObL/D1hmzvTAKLz6T7XVQoqPfFTzmN3JEGupd\r\nyOJCwcgFRQDsFG6G6nrgTdP2fFpELDc1oKrMkSHYjfWmOtUvwq8Y9030z+9n\r\nggvYDlNHdo7MColB6rNSJsBx/vK5ALGxcR0q1CdqzAEiShYME8c/us0xpfVE\r\ngLidYE0LPRGxLZMc9be6eYi52tMmU3zv6hNBkfKNfGZF9pM2ih36v4qQ1kcr\r\np/6esZgYWcDTUBMzqi27CKH/FpWIDoiB4bLTWdKG/tMx1J0rTpn5AtSHyvzU\r\ncpCytnCrM3kmGfsEFWGvYhVzVTE9xaSiG97VuPJoGIGO9/0LCvKkS2ZvheGR\r\nwR98bxpUiRXvQc0bgd8ra6H/IAPZG1KbmDyGhKfinclTUvcsgRhDxRDM92fH\r\nlSOB5VVzRQ34yRj0dpgK50vyrrw3RHa/HiprNZeA6muqo7CqOxUM26G/xFom\r\nQALfs8q3KXKhqCXKDJhzmVbQKhDCWuHLd00=\r\n=GCGb\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.16_1680104349624_0.3189164739802677"},"_hasShrinkwrap":false},"0.20.0-alpha.17":{"name":"@flexn/graybox","version":"0.20.0-alpha.17","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"8.6.8","@wdio/appium-service":"8.6.8","@wdio/cli":"8.6.8","@wdio/local-runner":"8.6.8","@wdio/mocha-framework":"8.6.8","@wdio/selenium-standalone-service":"8.6.8","@wdio/spec-reporter":"8.6.8","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --- | --- | \n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element|\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --- | --- | \n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp()\n```\n\nIMPORTANT: must be included in before hook:\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.getElementByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.clickById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform *Home* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform *Back* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform *Up* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform *Down* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform *Left* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform *Right* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform *Select* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `THEN:` |","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.17","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-jZ+VFh+0igWz1Ol07MAgME5eLroST3oFsQCeMs8BzknUVzWS6yzF1ZkLupq5snto1I2cEVyy/PoLzlxAM7kIzA==","shasum":"2173c6144c00c0ee8ac6daf233581d55603d5b24","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.17.tgz","fileCount":43,"unpackedSize":104752,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDfxlpFzs5ASU0T2jNFqor27DNBJdNhYyNSDPlazQ8TzQIgYU9VfBylJLcXO0t5c/slzCSA4uWBd3nOFPQ19gOQhHQ="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkNVFlACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmprHQ/9GazfTdtxhQroNkw0X+ZI/T+7DEHEH4SURESYnynH2sdjQYN3\r\nV3d2pqLGxd5+8+ntNbmFDItQgMmGpGymYcbEE2AgDsa3VErL4EUtIenV3u4I\r\nJjZaHj0IU6x+Xh0XlzC5z7FQf5nS1s/YvNV0Ys7wR9d6fBVcANHOznJELqbW\r\nW2MWt4gYlDaD+/frHVDonOrsOmWp6+ykEF5s1MsaUxPft9dyMglnMUzWekTB\r\nZwAJlmHtcnSCBdY9FK11cqf1SLWL7n9XM0BRJCd/Y59UDzFIXAIYa14gm8gd\r\n8dsnJW2M7uhQc1ViD9W1pnomZjFjEYYQna/wz4u6sHkh4zr+ZZgqDIrFYMXh\r\nwfWZ8rot59Gh8dykpKvDTmSAZtjTJjQRDBDfts2vaAXV/LP6i3YgWFSV4Uvz\r\nMl5785x8rvuuGj5Jbulrubl5qDGmIT0G23vAUN2ioB1/xSk9J4IaEm5fhcU3\r\n++z3NmRgVIPyVZwbVBcKhKwc7FSbtq8X3n8bvjrqElwCAatGRbMHEeNnjTJx\r\n6EgxKZj0DUJRUBNnVMu7rFE/doZ6fSJ7sUW2MvkKruTU5DnJ7x1TOImDP4eS\r\n7f2YFAkrqZcNfM7wdI1vjLxhvP66TY2u52PpRQuhy9Tjkglejl+Mc69VqE0s\r\niCkWBpbFY/TW8BL+lv0qHKii7T4w15xssVI=\r\n=/mq7\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.17_1681215844998_0.52107284973234"},"_hasShrinkwrap":false},"0.20.0-alpha.18":{"name":"@flexn/graybox","version":"0.20.0-alpha.18","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"8.6.8","@wdio/appium-service":"8.6.8","@wdio/cli":"8.6.8","@wdio/local-runner":"8.6.8","@wdio/mocha-framework":"8.6.8","@wdio/selenium-standalone-service":"8.6.8","@wdio/spec-reporter":"8.6.8","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --- | --- | \n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element|\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --- | --- | \n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp()\n```\n\nIMPORTANT: must be included in before hook:\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.getElementByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.clickById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform *Home* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform *Back* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform *Up* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform *Down* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform *Left* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform *Right* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform *Select* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `THEN:` |","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.18","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-lzgme78qYZkdGxOYz4L6d/VnkwxTj/EKtobvw12NG0Uvs3YA/YE2M4dKf5cAZk0lgXC5JTrnXWC51v3iOQzqtg==","shasum":"d694717a0952603fa1329e1f2f27dc7ff3d69a85","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.18.tgz","fileCount":43,"unpackedSize":104678,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBXJdDfQ8znKa5aaOLhKm59DQSKq2lCdRUny4DEUvD38AiBWI0gGTOEh7ySGJVH60tmM3AMmgyWbILCG1BKx0PifvA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkNW6DACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrCehAApJA8wfrucQve247MOci0u4nPFT64ftO+BwfskPpd5dv6wyYw\r\nkzOP20Mc4wDFAIPnRQnI3qerJT4gEphyLazF8zaAZMgkoGFa3HwxYhrFNipF\r\niqzJHhHz+qc+j3cvlm4UxOswOFpRWk2jLKe0kHOixU0evi84kKF93qncNo1O\r\nzsFHV7H5NvSlWAtvQXYULId2gYjG0we6y8F6sqbcKIrfmYz7mwsMpr+nizvM\r\nxbNtUF6Jl6ZApMF1DeMWhOF8Ahm1jz3DKQSmyVrTuOPhL9YMuLhGTf8+iib7\r\n957D4nJn8s1eUZsg2b+0qqeJBQ8Si6Xxtym8uopEw6qn5N8eu73h6Gax9c98\r\nobfXF4UNRJPEWFDX/k2DZosPBo5o4n37FvCSm+RedOWe7hJsY7qc1utLRvDZ\r\noaYpKKNjK76fw0Y/vZpXEn719W/jmKX7VOSHMm9HO9XTXqE9+rRrHTSszcSl\r\n3OgQtSgsoIVk12lVqenbEECig7kLBhibOivTVKY9bPYiR20xOAZuT/W/u14p\r\nZFa6r1VFlZ9GHeZVsS52KbQcEU8sOKlHRyTXhH5tpo04Glegj8PhlskHmhPo\r\ncccOkFUlNpNFBiihl+cgC345QsLdvVHl03FKNKUum2mbFoC6qsWJ6+Dcno/x\r\nP8/gI0m8B0acYgzFk6khFb7GuT0ChvwQrqI=\r\n=If+I\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.18_1681223299738_0.15704908489735092"},"_hasShrinkwrap":false},"0.20.0-alpha.19":{"name":"@flexn/graybox","version":"0.20.0-alpha.19","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --- | --- | \n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element|\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --- | --- | \n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp()\n```\n\nIMPORTANT: must be included in before hook:\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.getElementByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n\n```javascript\nFlexnRunner.clickById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform *Home* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform *Back* button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform *Up* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform *Down* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform *Left* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform *Right* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform *Select* button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message)\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| message | string | text to be logged to console with `THEN:` |","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.19","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-J2Iq5CTgAWyia2Tmumbpe8Ebk+XGKSUxr2caVixuQtjl1EB7/k2n2/3m+cw1a8rhS3+uQF2JhSgtlA/hAQHZjA==","shasum":"6e9a6986d839afb74c7fe45994bb478c59201a3d","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.19.tgz","fileCount":43,"unpackedSize":105000,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCQjSG4uREdUsVJNvohS5+wghaQ+eBn3MBMODiLkGXcAAIhANrSYQh3WF91wpKfnRrLLDGw5sK4F2VhyOvfZ4eeRsJb"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkRlWVACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoAERAAllqDoWreDp2pTJ7s93AOo6rt7ktTDNOd4MtrWnwM79tM6jXy\r\nbIUtvdCJ7P8CpVf1qvJ6q8L9VddYZrVNs9G7AboJ1uwpbD0/mZPWm90lpdYR\r\nH1eAIJ1icKDw0blm97Hp6bV9nSDxOHoQASUGJQ/CRRb7HtQPVEP0wH+0RKUc\r\nd65parhE2VOKnR8vqI8xJGveLzGIEdo4u2wsKg7gCcel/Ih+SAkmr7vkjg+z\r\nvLtlDSLp2NqYIAyyDVTxOGTrEY6K5gb5fAdPwiB35F57s4LO6LHkxvNLEDek\r\nesbuwlp46MGY2YoP18CCEzlCb9quy9x4Sy4DmR+I6W5KAti5GIMqFPIQfqoe\r\nMKfjgC0JEJDISjn1TUu49DjnULsQrBbWEFjJpusZ7ttJath1Qc89Hxsdb0ro\r\nAA5+VHTFlKA/S9e+n0rg8DxAkajToJWlHR4iIkN6kOax3sx46Cwesy4jf5s3\r\nNYFeu6bw9r9TDTfzj3TDHYMxKohOpRWxNOw2DQIyKWe5oDf0fcix89J3QB0l\r\n3sQ4AJW0wJqq/BUzvGAihxRYeuKKxkXo6yvhfjWlmo4Xq237FRiB8xaE7P/f\r\nkwEkdaW27vSz2eYWnS5DlWZWN9ANX4c9M7xCKCi9LnuPUH38Tk8RC4Y3hhs7\r\nswqvR8eRYUAN/LdiyVoOO37aEfvgGAcknLU=\r\n=aB4V\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.19_1682331029083_0.11195908298430735"},"_hasShrinkwrap":false},"0.20.0-alpha.20":{"name":"@flexn/graybox","version":"0.20.0-alpha.20","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"23af7619ab130b183c6653245aa13f45d364e781","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.20","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-rri+ZuoYj738TLkLg0RLOdyjsuZ/RmtHTu+/WH8DIOdbR7wDkES0s0Nd1wJU5EZG9YwpUdOtVHfyqs7hJ38PyA==","shasum":"9a2b67f4c7e0617e7c8e0154a0107e7eb11677fd","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.20.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDNd996eNmDzR7GYCkGCfup070KxSx7CyLUnu5lygNEmAiEAzTr/fJUzzgUH51mvMe7kLqPUgzcynH0RKfvnUkdpAGc="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.20_1683478957495_0.8043526537963324"},"_hasShrinkwrap":false},"0.20.0-alpha.21":{"name":"@flexn/graybox","version":"0.20.0-alpha.21","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"3117d7e4f1127de5ef9db86187b06dfe1aba47b9","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.21","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-wOyYnLVhzgLJA3kq348R/HIbNPLtvksNRr9ARxvPYHlBKe253y8PWwL2jtpI1w8pKeVEAhkGM6kumD1N3G832g==","shasum":"ddacabf70fe7ee227c5b608d82a5f3cbe29523d0","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.21.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD4cWR9YP3fF/4ZF3yv3khebDCf/Z57mk88XT/1mHo9WgIhAMtnVxOy9Hq/a1Bn1e0qSCz3lHWFqhhPg5qzLwb/Z3LG"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.21_1683529180479_0.9867101794295161"},"_hasShrinkwrap":false},"0.20.0-alpha.25":{"name":"@flexn/graybox","version":"0.20.0-alpha.25","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/flexn.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/flexn/issues"},"homepage":"https://github.com/flexn-io/flexn#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"1f79727ca50635ff565db13c7ae69f21dba03a28","readme":"# @flexn/graybox\n\n### Overview:\n\nTesting environment using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium server to run and Web uses Selenium Standalone Server. Reporting is done using Allure reporter.\n\n### Setup:\n\n1. Create wdio.capabilities.js file in testable project's root folder\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app'\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app'\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId'\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n5. Install packages with `yarn bootstrap`\n6. Build or start (only for web) project for specific platform\n7. Run test command in testable project's root folder\n\n### Real device additional setup before running test command:\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\n udid: '',\n xcodeOrgId: '',\n xcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cmd command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n### Running:\n\n1. ios: `yarn e2e:ios`\n2. tvos: `yarn e2e:tvos`\n3. android: `yarn e2e:android`\n4. androidtv: `yarn e2e:androidtv`\n5. macos: `yarn e2e:macos`\n6. web: `yarn e2e:web`\n7. all above: `yarn e2e:all`\n8. generate report: `yarn report:generate`\n9. open report: `yarn report:open`\n10. generate and open report: `yarn report`\n\n### Prerequisites running tests on macOS app:\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.20.0-alpha.25","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-zVWMlNWGKnRAVf0J0FnBzoLJ/O7on6rEGa+hxVXTDRGouhdLoyGQ3z242N7LgfptLD50tz78gBIuTbFzbH4z9A==","shasum":"64749c7914fa69001426135269abfed4ecd14fa0","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.20.0-alpha.25.tgz","fileCount":43,"unpackedSize":85907,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIA0BbpnKNw/RSYyTCJgScSTew4E9X+OhPc3d5qWnLKSoAiEAikPwRBgd100/xOWzOYhwU4xprMyQ50IVotwljDLl8PU="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.20.0-alpha.25_1683535559635_0.11227468764321413"},"_hasShrinkwrap":false},"0.21.0-alpha.0":{"name":"@flexn/graybox","version":"0.21.0-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"92e457740ee0a4d2b4856dc1e1234e5468419f49","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [Element with certain text](https://webdriver.io/docs/selectors/#element-with-certain-text) strategy selector with predefined `div` attribute |\n| Web | [Element with certain text](https://webdriver.io/docs/selectors/#element-with-certain-text) strategy selector with predefined `div` attribute |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.0-alpha.0","_nodeVersion":"16.14.0","_npmVersion":"lerna/4.0.0/node@v16.14.0+arm64 (darwin)","dist":{"integrity":"sha512-+GbZ6GrtNouvfu3QITHfFFsh6aJp4nA3FX2/gy3fT9MPs66jaut0oxHaGtGFBIugeC+i96uI0z/eGZtMy+bkLA==","shasum":"7ffd98689474f0c445303d7410dca0ad9e614e10","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.0-alpha.0.tgz","fileCount":43,"unpackedSize":107601,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCBFOiZbwHRa/qKQHx3Ug19xBPYvN+yjxgnAkLGbfxXdQIgW2SxRInS0CkXQuKCbiXZFrGQPr44g7fi58zyKMoTBD0="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.0-alpha.0_1683712429269_0.38540608033815094"},"_hasShrinkwrap":false},"0.21.1-alpha.0":{"name":"@flexn/graybox","version":"0.21.1-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"54e8435b459efbeb9ab0cb7ab0232293fdda7def","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.0","_nodeVersion":"16.14.0","_npmVersion":"lerna/4.0.0/node@v16.14.0+arm64 (darwin)","dist":{"integrity":"sha512-FN8cWlq76jCzSTRgzQltqaBGHlwmBnK0egUUOGmML21eZVuXLt5oMboM45hccH7JeBB1R7Tg0w5iUtYfdgTY2g==","shasum":"25f63f062170eb3894a8704e4d8ac81ce04815a9","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.0.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDxoYuyqkyWXduUjrCDWR6PlzF92Oxfz8ca1HO7kbVRsgIhANTpnvZZU3SHPQMTE2LUs1XFc2BxXP/nUm3iN5MbanLm"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.0_1684119834853_0.8705360464560643"},"_hasShrinkwrap":false},"0.21.1-alpha.1":{"name":"@flexn/graybox","version":"0.21.1-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"8184af449d009628511eee50d22e6052498fee34","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.1","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-t8l78Fs4yTgrd2dkkvre7SDqTVr3G7TGSx+AJ1BiJ1B9S6l649qu3mAYykF3QOnRW0SW5AzKGtSZ6rrVkSSdew==","shasum":"58741329c37158fe71917ee3dd758020376ff83a","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.1.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCmdBwVfxRZ7+wd30AJ6fho9G1PJngKSxGNYDWG9tFtkwIgZRBr/grQuvCJwP/z0wiidRz5QJ1JRL8KnYo0ReqQCJg="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.1_1684494999129_0.7887499051883982"},"_hasShrinkwrap":false},"0.21.1-alpha.2":{"name":"@flexn/graybox","version":"0.21.1-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"f6e586826ddc7dddb33e6f928d5f20b973cef126","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.2","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-DKQ2pGm6nre/SP7jfVbGul9z/fnJOPymSd/JDBKtVNiyVNjYfgdWtLoO2jY9OtiNcSjE2e+EIrIBWt3/BqaGbA==","shasum":"b652445f8ecf12613de8b92633168ed63f6ecffc","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.2.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD6QNxht0aFCkNbK9zOZsvJSWBFiMub+nRLDksJ7UTdpAIgMCj9z8D+o4doh8lcBNgB5hMIJGljP2qVBIsuobIYOrQ="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.2_1684772191907_0.22036863407827756"},"_hasShrinkwrap":false},"0.21.1-alpha.3":{"name":"@flexn/graybox","version":"0.21.1-alpha.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"d16d86f8773e431252fe39d7c5cd686366dcbb92","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.3","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-9CFN/Ij5sqgGz3z41dQ3zCtYZewcQghcHltIyDxjSp4bXYI0wD27k2TThHnjGeQumz0BJI87XdKWK12Nz4O3nA==","shasum":"67818fe7c1e1c4e9472311465e90eb6f17ce7a16","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.3.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDNBUIoi8I3hLBMyjKx+PtqoOvcn1GMq3uw1SAp9fjFMQIgJcqGzZzVhwHwQagKE2oIFqyXssmtpln1R1OK1mzJKl0="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.3_1684834464092_0.3509851402331503"},"_hasShrinkwrap":false},"0.21.1-alpha.4":{"name":"@flexn/graybox","version":"0.21.1-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.4","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-OrgyC1wDRg4DXqttN5d5YIn1a2W/p2oBV2U6hj86p/eVdl3QUcRX+YuAMFC+5DkI9KcHpjgNKE4WPIsU431LBA==","shasum":"827c6d7ce4137b226462309937da6c61e012c20b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.4.tgz","fileCount":43,"unpackedSize":147631,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDcKvyiwk75BT5f41GoNxL5+igvd3CWpsu2dJ8MmhEKEwIgU2Q+9QssY1vyxs5BfnQ37LWPr5qs0dZGoZYDGqZilHg="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.4_1685090064985_0.8693701776741483"},"_hasShrinkwrap":false},"0.21.1-alpha.5":{"name":"@flexn/graybox","version":"0.21.1-alpha.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"8ff1a3c9b983cea3651a505e40c1451bfd4b1b85","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.5","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-OWIlSlrW2ctn9ef7Vgjdc52fqBy66GIowYj7pwJnsEba99VFzPC/cclkGI6j2NFAjmhL+DtslPO785GMRFDc4Q==","shasum":"d2de9a98450bb80fc1b749c95e518c34199cd504","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.5.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCvF8WD/j+Ojsob4CGFdhFy9e7SVf4vq6mpVHqWHxkrmgIgNR6IYB+gBkCg+lce8BWv39zIXJMPnGkKk4DozLyhpSI="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.5_1685126374915_0.6543948039088476"},"_hasShrinkwrap":false},"0.21.1-alpha.6":{"name":"@flexn/graybox","version":"0.21.1-alpha.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"edb63f51da62054f12849c4dc34f51dc145af65c","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.6","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-zrwAz8W00qz7o9cbQGGY9BBe/7mhyTF5ULwxQcy1hotWA0rHjAa45f1wiyNVhRFnnWrPa1WehV0kRagyGbECWg==","shasum":"a3c0f55342ff91eba18b5424c76aedc482dcaba1","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.6.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDYCbnbuHqoL9KHHExHH58Z1YD1ljirrPU+pfSA4Lo1HQIhAOKRm7cvhbokyQkL9dJDUPrG0ZBoDdMWPjIQIY25T9Tl"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.6_1685185239604_0.6543872038511664"},"_hasShrinkwrap":false},"0.21.1-alpha.7":{"name":"@flexn/graybox","version":"0.21.1-alpha.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"d51572ab9bd1abe134e333a229995cbd53f1854f","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.7","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-NytV4+n1Bld2jw7szTrgGR6xGSpKzha508iKfUfiLnA9SbOHjmp+Cb1ECmOF+Gl883CkVdrE4OM2csaUli+oYw==","shasum":"7187fb8c3047b7fc8d90b21b216b359935968b4b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.7.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDdYScsqS2vsEzbuYpjPqVTzuWu7NHGlsT4iBXC3bLqTAiEAmqzGJhCbsEVR+VDT6ypduCoEvjopWWt3XQQ37W8+xs8="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.7_1685191830441_0.20951740984346778"},"_hasShrinkwrap":false},"0.21.1-alpha.8":{"name":"@flexn/graybox","version":"0.21.1-alpha.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"25bb4829412f9caa69df2e1b3b8883dab9a2e5ef","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.8","_nodeVersion":"16.14.2","_npmVersion":"lerna/4.0.0/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-yZziE/ik0ME7QOyQchruj3H2WQy/E+P7J1HxS+WMLp31syANYN4MZ85fTesrmY9Qrr1bGTIlPYrRKYASHKyoAw==","shasum":"f31620da890c80a1558be93a00510be404ff84fb","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.8.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIF3csJ1ezLfGCvqbiiqy50FCeSovPAYe0HiPmeRLKOQ1AiEAqhmE50iDri3lidfODKI9IednXkk6d8tmVvawXoUmS5w="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.8_1685340729957_0.8245262514239649"},"_hasShrinkwrap":false},"0.21.1-alpha.9":{"name":"@flexn/graybox","version":"0.21.1-alpha.9","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"npx tsc --outDir lib","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"18eb11eb3e87455b3d3ec0af8e102aff2b86383b","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-alpha.9","_nodeVersion":"16.18.0","_npmVersion":"lerna/4.0.0/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-8mtYGJYDlDqgimICrWDSyjSEHnTelfQTW/hqtIKTIxxZ3CLnYG8Q3Qit6QbWbjkrHk+8sIBXhwZivzazro4mzw==","shasum":"c7c8796b0aa9090de4a4169c4ef9d46e714629fe","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-alpha.9.tgz","fileCount":43,"unpackedSize":111268,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCjCZTL3obG+Xt2X16VexUhtQU5gl3is04zYpnVLHcgYQIgMe6KuQIoNMX8W3xeV6mOQFvwhq7SajF5LAP8DdOswPg="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-alpha.9_1685385699641_0.28139236409375656"},"_hasShrinkwrap":false},"0.21.2-alpha.0":{"name":"@flexn/graybox","version":"0.21.2-alpha.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ff59f840f250739ad81697e5a3f29c10c3d9058d","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.0","_nodeVersion":"16.14.0","_npmVersion":"lerna/6.0.1/node@v16.14.0+arm64 (darwin)","dist":{"integrity":"sha512-0VffBMesNeCbCgSAGBgPXzJe7iNcbEmSVH0hus9H60GlB9FU3hzHJu2i2X2Pb3Cp7hp9nAY+M9NpP3KV+BEKRQ==","shasum":"ec370b046f3b32d303f9bb5fddd49f134a3fbd30","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.0.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCNTSPgV/TahTG4fIN5KF1Bc/B5vwnVJ8/o7HqEPP2vZQIhAIjOH3JA08Y/0b95HomyJXStQa8EdQr0KWqbHJdiq7vq"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.0_1685442893250_0.41845764526529927"},"_hasShrinkwrap":false},"0.21.2-alpha.1":{"name":"@flexn/graybox","version":"0.21.2-alpha.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"0734b6336db9d446b16890b4521fe0fa49a471e7","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.1","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-nZOyTvF5UvNtsiRriK/nKmIxTPlpvaP4leu9s/AtRMpo40wq6Qhek4rhLQzTgSwM/mTS75qLHO0sygAmoXDHrg==","shasum":"6f2b31b9b0e945e2cf91e8af43f51c6cece25eaa","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.1.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIA+1CzNOD6i+8jBmsYDqEhvGUJUBeWTOqg/+n6qyskK+AiEA9LtQLrh11TcQahPeVTtGjk4nlAa8JKoJuyKGXjxzM78="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.1_1685465814473_0.4215718633606096"},"_hasShrinkwrap":false},"0.21.2-alpha.2":{"name":"@flexn/graybox","version":"0.21.2-alpha.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"834c7c8065127a3988a0b1fb9a7cd9cd12515640","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.2","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-yGvkL3bhOWD/BLYfF+k2YOMw4M+ocqRYPECAQaObnUFFKNyp/1w6Aj4GE9Y51ulrwOmEZEcZe4H+dt8xJfmj4g==","shasum":"ba8849ed913f2eb404a08ef41153c8989a51ee6e","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.2.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGtrO9nC8ZaOPPsNWXBH//7FIBeJLwgyyrwiuIeHw7EtAiA7MXftEJvBn0bILnW+LNkX4OTYkqGWgRaT6yspdHi4fQ=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.2_1685478545199_0.9152170277075795"},"_hasShrinkwrap":false},"0.21.1-feat.0":{"name":"@flexn/graybox","version":"0.21.1-feat.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-feat.0","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-BYerRdFBA03nlDW74zGz8FLY/M+tT7NEYSWcD4sDLCmkW6Osl8rwDX0rinCJzAslG2MpVXbbfa0iVYXa45eH6A==","shasum":"5dda336a1c8ec68460e2b8b7e6fba6cdd78a0fd6","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-feat.0.tgz","fileCount":43,"unpackedSize":147709,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDTctRfx7r0OGhiYYX0IMw+kvp67DQDQFdIya6glbLjcAiEA1qUqcNKkkpUhDPms4R9EAfn1FqiB6UnY8aQLKQlTTeQ="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-feat.0_1685558879930_0.1244437882939573"},"_hasShrinkwrap":false},"0.21.1-feat.1":{"name":"@flexn/graybox","version":"0.21.1-feat.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-feat.1","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-RMllyevQ+UNOHdcDGv/4leF+bYHSeGr2JZZh79Uzs+jzAVgxw0tMPsRCOrjpfF6SyWQeHJYImm25VFQc+czthQ==","shasum":"62b9eecc84194a3947c2a4e981377b86e62ad6b8","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-feat.1.tgz","fileCount":43,"unpackedSize":147663,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCdM8ep0YOjkQkRkxUltag+WkgKoncG5tMoJiwgf4ClAwIhALChfk3cCVHpe8r8zR0PL7gyC4hDYTNZCktLfOmp+WjB"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-feat.1_1685559623363_0.4777785672746173"},"_hasShrinkwrap":false},"0.21.1-feat.2":{"name":"@flexn/graybox","version":"0.21.1-feat.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.31.1","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-feat.2","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-CtYNvWZp0C36CxzdkYKQ8R8xta76A7ileqCX+1tANCcfmYBu44Z0OvmjQj3HEvxUbt3CGLptxFaBl1XTPPI6rA==","shasum":"52524e52ece6aabcb2b9ea6f0b90ebb3a24a9d76","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-feat.2.tgz","fileCount":43,"unpackedSize":147663,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIHMRcykcfKbBgX/e6IpjpAk4Bd09O8IjRbqvf7mCweYhAiA5BQuzQdf6t0418z2poagRBzfbZ4Pv3FoY1J+YHkNIHA=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-feat.2_1685561362058_0.8682403571421493"},"_hasShrinkwrap":false},"0.21.1-feat.3":{"name":"@flexn/graybox","version":"0.21.1-feat.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"8.10.4","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.1-feat.3","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-DqLrd2+gitcOzazcFuZMXPS6Qezxam7ZVTKLjRVaHegMg8HNmqjtmFitRyfgAwdhy3uslU6QkAiQeJDBwJq7Mg==","shasum":"620347afc7521e97133197c7cf934ab974706f83","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1-feat.3.tgz","fileCount":43,"unpackedSize":147663,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQC3UXqqxxj+19bOsVP5fywmSGCREfZ19b7+2LlZ7vBwNAIgZccYxGwoxQ7dbdd1yFl7eXs3YFK25Ppa3iv9fA+BEt0="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1-feat.3_1685562524462_0.056760271296919296"},"_hasShrinkwrap":false},"0.21.2-alpha.4":{"name":"@flexn/graybox","version":"0.21.2-alpha.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"3bb23e7767d6fca570547b2440d5663e0b87575e","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.4","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-VITKpNya4WkQUtjHZorOrTebQexSe/AFKkZ/0PvUy96quidoifwEpitXWqeta1PFm8/Ii4AJSN17j9GOmsil5Q==","shasum":"5350c2630c80edad389243d18326d6c3eb9bf0af","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.4.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQClheJht9xd0ddfO4fCSbUyLV8BpMcu45m2tWpp9y8ihAIgQrU5HO2ViE3Zg5THvBpsU3rJwuqI7uYTmlQJv3X5gNE="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.4_1685640354913_0.20684933683004836"},"_hasShrinkwrap":false},"0.21.2-alpha.5":{"name":"@flexn/graybox","version":"0.21.2-alpha.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"668559bc348a85a7eaf455a96f035afc8458df47","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.5","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-/X/RlsIXE86c+luPRGDa+0a/G7wjDYUWNbxxqahylTL/cKWDP6BsYdia6HIVzubWEnYpGxFkQ2avsf6mb3zWcg==","shasum":"24e2be0d2c3cbb4324081035df35af731d92f848","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.5.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCKtq3KXB0mUeUQd6ZFEkd1vxriu8ifAszP8lFSPbXAHAIgEJ0zIC6FpygUS3ID0Q2Rly8BkQuey5VZE6aX6OOo4JU="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.5_1685641929990_0.19209725635770658"},"_hasShrinkwrap":false},"0.21.2-alpha.6":{"name":"@flexn/graybox","version":"0.21.2-alpha.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"4581453fea2eb8c74618ef8f4fd4a0d1e34dd3bf","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.6","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-ZAFFe2FtaEDyZKi/32SqUkkHU2mZnze4AMLpTph4LlFQdFRfKxcmrCc3kBBRlTOPyrFHGhh5O7lKyvoh9hLdXg==","shasum":"968d1f2a28053972601a723083251640d5f93f61","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.6.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCzwv39MZ58pZORc/EGxl4fvRRQoGmUNFg23Fk6NzCsMwIhAPHGE2Gz3yAbNrSrXwcwqbmKr5waYI5pjPuCRXqRt/7k"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.6_1685644567855_0.5695301906584078"},"_hasShrinkwrap":false},"0.21.2-alpha.7":{"name":"@flexn/graybox","version":"0.21.2-alpha.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"12bd713d556333e862af9b4d8dcd58dcabadb729","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.7","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-pMV9UuzLbDKtaP59VmqhExGwVmBmchbu+wJ8cg+Tsh2x4Sw0Bobr7f/ZaA6ddmSSw82FeuhGAiGTFk/KQOvaVA==","shasum":"5aed4fe3cdeea52d97f1c7564b3c0e25e07d7d6e","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.7.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIF6JKn6uOdq8cxtR/4SSXioEiqpEccVMj4rJmnGHE46rAiEAwQe7qLPZGuTGG2iTrUJjzy964SUHjDhjsq2sXjUbkIo="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.7_1685646633977_0.46686593048088265"},"_hasShrinkwrap":false},"0.21.2-alpha.8":{"name":"@flexn/graybox","version":"0.21.2-alpha.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"e087ce4f2ea89279c7b64b58a304b03cf1dd5b77","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.8","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-Zt0o1DR0/9SlSW5kFIrwcbFiCSZWpBNSYcO4eL9mFCbSkyI1ik2KnN/P7mvXuWnEWOW5ll7TO+3gGouWnzOKjg==","shasum":"e17bc8ff708e0b12a0d3b87cfd0adbe4ecd8de63","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.8.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGpw/XdQSqvEKyiW3bxJ6WRRawZmyV89A/KctHugXybbAiBRZQSOogI7+ZbBpnX7YEKXTfp99VzzfPmR+8Ick3wrBQ=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.8_1685681654257_0.4687513201002267"},"_hasShrinkwrap":false},"0.21.2-alpha.9":{"name":"@flexn/graybox","version":"0.21.2-alpha.9","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"131e51c329f5c68e8490981ef58ed4063947f47e","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.9","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-IadGQuDaxxrJHg7CWmGUBgYjfL8qXbngoOD8A6AbgoH6Au/YROE2cOnXqbUT8MDOVvr5L5LZZUB0Vhl+LDLy8g==","shasum":"3a09852b8d6c9db5d52c0aac581c70754d8cb705","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.9.tgz","fileCount":43,"unpackedSize":111381,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCHdzci1VExf9RoePt1jJ+NxiH384j9Z8jX+CHEH4C0ggIgJW3bhPPlp++6PHaNpk/6jOY3KBx/AxTLpSmXimz4D8w="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.9_1685810388634_0.659510262176497"},"_hasShrinkwrap":false},"0.21.2-alpha.10":{"name":"@flexn/graybox","version":"0.21.2-alpha.10","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"087c660ecf0b1ea4fa4ea31ca467679b7366668d","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.10","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-SCMB4XvjcLRihUm7j+f41c+VQeUJW/ci/ZR72NGmECGp8HQWjhRGN6IeOMFMA1MaPcwWZxMbkkkWTRHKTJWXtw==","shasum":"9d39901a82fae6131c0cdd6ebbf00a12303cd98c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.10.tgz","fileCount":43,"unpackedSize":111382,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCZCe9mBQGCKhpD2GnW5unXEaqDoeVwleTUTOWoTkQikwIgCeHlZNRXLqHP5MFrUKmso7fzE8ZLYFnBRf7crU+5AQU="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.10_1685821745946_0.6896723998949876"},"_hasShrinkwrap":false},"0.21.2-alpha.11":{"name":"@flexn/graybox","version":"0.21.2-alpha.11","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.11","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-AQwMktdCJcoUYiQft9GfUpTQ3ql884nThI1RfifeixbUbmAKj2Vj6+uCxu/7j7V8LAZMzo8iMkROKiKPFazt9Q==","shasum":"e321bac93f8d693b3d9454e9d75b6089328216c4","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.11.tgz","fileCount":43,"unpackedSize":150572,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIAPyR1JUC3jhEBbJpzZBaCyXiDKFPFtEkRZDL9oqZ60sAiEAhabwfyYZ/96qNwKeOBZdlNtUut9Mk5pCSXAK0msOrzQ="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.11_1685951194001_0.5397030350312129"},"_hasShrinkwrap":false},"0.21.2-alpha.12":{"name":"@flexn/graybox","version":"0.21.2-alpha.12","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"b689744b9f720a02c9a9a33307210802209f4b44","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.12","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-gakj+03E3KlFO/QyNpE5i6CCsKmMAUvhXmiBNaSUBAPLzZM4yqGQOsxryMmMMXYBSnO56hn59TjdOCb+FKt/vQ==","shasum":"76185e8916dd4abfd3a3dd29bf9e02434f421455","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.12.tgz","fileCount":43,"unpackedSize":111382,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCgXEjadludAabWnaV4KGFpFGxb+TMWetXZmsk41MOZCQIhAO6DbjtIEuDxb09+B4y+VtPdabq1iJ7oxylPRn5KRsf1"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.12_1685995538386_0.47563971280657125"},"_hasShrinkwrap":false},"0.21.2-alpha.13":{"name":"@flexn/graybox","version":"0.21.2-alpha.13","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"0f36cafa66dbeda3662c3e8a89f48cb9591eb5c5","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.13","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-O8rAEK9Q5wwFBRhvtbkS5Z0g/ZluJMNTs+NWpkErXhb1yGJq3tFVYc2MRZOn3qasHaG2HTmouzcf7Ykb8Jkz/w==","shasum":"4d21811184798e816153d0665a79b0cf5455ffbf","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.13.tgz","fileCount":43,"unpackedSize":111382,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDOghkrr0SyvYd5h43oZsdcHFNTdBl4IMopvgtQlTuaDwIhAJxTnbtd2cw3XiNpdYq+l0tf6BkVbs/yuJSbmQYiHmey"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.13_1685997993766_0.013385154756097029"},"_hasShrinkwrap":false},"0.21.2-alpha.15":{"name":"@flexn/graybox","version":"0.21.2-alpha.15","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2"},"gitHead":"ad76216d3c0149d7d36e02fb07f9fa8411045868","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. iOS, tvOS, Android, AndroidTV, macOS use Appium Server and Web uses Selenium Standalone Server. Reporting is done using Allure Reporter.\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.15","_nodeVersion":"16.18.0","_npmVersion":"lerna/6.6.2/node@v16.18.0+x64 (darwin)","dist":{"integrity":"sha512-4MuUMSJ2My4+CJD7kiaMekVwuaRRSf2K7xvyiojIMAoM+WmWyn3CUzku5L4dytfcwG8fyLaizJycJaq7OZ5RWQ==","shasum":"3a6b0851669468cad016c7dbd3f8c4bc808b1826","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.15.tgz","fileCount":43,"unpackedSize":111382,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEnM+ZQ3ctAcdfFdkjrvOa54uzJDd4LpK7bQ1jgenuHMAiEAyeJUMhi5oa0e6bl+zlLRhgV85Rwgbc7R7rhbqfeS4qA="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.15_1686166662856_0.5548651757950955"},"_hasShrinkwrap":false},"0.21.2-feat.0":{"name":"@flexn/graybox","version":"0.21.2-feat.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.0","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-HBVD6m/o4+zX1smcXzo/IuwrM1NEVD3tTudAadJx3RW9MlvXWA8sfo7s/2v053QNLIstSMBJHp6i3iJkqTxqFg==","shasum":"36229780a4c48de04257f75b03153811604025b2","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.0.tgz","fileCount":43,"unpackedSize":150571,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDng5wkFabz+RMo8cH53OiCU/7Htqde5a3Xq1kCIUvC7wIgUGOTqeAWbpMf8XEDoUeU0NpPoKxrc2K9sbpgd7Om+S8="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.0_1686218676918_0.17551037164868677"},"_hasShrinkwrap":false},"0.21.2-feat.1":{"name":"@flexn/graybox","version":"0.21.2-feat.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.1","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-ndQMisAH2/VWJberkKuWIXDHYrVKlhVRZ0hT699qPqzXKPRE10JFUtXqyUUGZWt+0Q/TdL0rCqoS7QqYlfcRrA==","shasum":"22f2de1c9b6d907bc28eb4b02928efaac2bf63e3","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.1.tgz","fileCount":43,"unpackedSize":148843,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCnzVUW4RltDgDYR1qTK0Fv6CsmSipO1UmWwpcJqvUcuwIhAMOeC8OChUaWQnVL8b8syMn7iPMRq67JVUqy8zEtpJkT"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.1_1686267915319_0.5748392935966069"},"_hasShrinkwrap":false},"0.21.2-alpha.16":{"name":"@flexn/graybox","version":"0.21.2-alpha.16","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-alpha.16","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-3KSAe9VEsmSOD5G8tB1Jv6fAQUJV92LI89/n9LMmg4j8xtmvbeeRL7oQaPPWSmgyNWpuYDwymdVBa2rLVLz+fQ==","shasum":"46031fdee7b1042c2ce8f0837d848ea312ee4f3e","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-alpha.16.tgz","fileCount":43,"unpackedSize":152174,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCPQMLR2XDMXW71nxFeg4Rj70MDMFebE1nETxW9uwAPQQIgKXnI9koYYcg3ptojSV0FegDwCxA1FC+JpzE5B5Fle7c="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-alpha.16_1686309390823_0.8963970526269651"},"_hasShrinkwrap":false},"0.21.2-feat.2":{"name":"@flexn/graybox","version":"0.21.2-feat.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/create.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/create/issues"},"homepage":"https://github.com/flexn-io/create#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.2","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-eL2hXl401qm2fQmsdcymEukpR4AEQ63D8ZLMphkz8yLnKlLjv5eWPWPKK6VyyiQEheZZcQK2zaCfWrW/rJjo/Q==","shasum":"4cd92ff077aa4b8a0e531f0bb3a216874fa8a0f2","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.2.tgz","fileCount":43,"unpackedSize":152173,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIAemthWhH6FyV2otbXYRKiA/QPJl6x7zEljzfiaDHEhUAiBjJXTNThCxFHBWb951iD9ahB/rnwNdVxAgdYgE2iL51g=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.2_1686309886544_0.5423697903916642"},"_hasShrinkwrap":false},"0.21.2-feat.3":{"name":"@flexn/graybox","version":"0.21.2-feat.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.3","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-ovW2w+zYwITvHC9Ln0nYart9lT53ZH+2MHqlDDdCSJTinxYKPrVJ6QvYFUac6gpGla09Et3DkRrKD+yDTkDk/g==","shasum":"8270ddd90b20b52bdd5ad23cb596ce66547c18fa","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.3.tgz","fileCount":43,"unpackedSize":152176,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCdMmuUbZu3Ar/slGXHHO8IiDblbsvR6eSO9onZYOgNUgIgNpnn29pdpX66MeSQI03BGdU5ytRLjyc1AGGOeltgAkA="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.3_1687425521015_0.1827492351376483"},"_hasShrinkwrap":false},"0.21.2-feat.4":{"name":"@flexn/graybox","version":"0.21.2-feat.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0-rc.3","appium-xcuitest-driver":"4.32.9","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.4","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-rxqbZtzWShSt91sUZUCpadE0Xvoz4DbDu9uM+Bd4TsR0J33vURzdUs/F7prSPlNFnGJjBtJgrU19x/NrbNbIag==","shasum":"c8dce5c621a93cb649ec2a13ca3e884751d0c665","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.4.tgz","fileCount":43,"unpackedSize":152223,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEqkTkm6XGocECgFAs3EUixcC8LRXglGglSDw8JHRe1GAiEAtCyRVrL56l9vvOHUCP6rpj91GYG+KySw1bTbIqAkk7E="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.4_1687786748370_0.5310943153619359"},"_hasShrinkwrap":false},"0.21.0":{"name":"@flexn/graybox","version":"0.21.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"87.0.7","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"6f6fb2b66834c6701a3828d90d9ec4a7f1554783","types":"./lib/index.d.ts","_id":"@flexn/graybox@0.21.0","_nodeVersion":"16.19.0","_npmVersion":"lerna/6.6.2/node@v16.19.0+arm64 (darwin)","dist":{"integrity":"sha512-ChN61shU1F2GDhsevYgiUGhIe/PyrAjEY8FnCgoNwAj2jb4heuOi2Peookglt2oxF6LoEjFtAngQ8sCqAyvD2A==","shasum":"c502a657d44725f41010354e8ae94d7bd965a255","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.0.tgz","fileCount":43,"unpackedSize":152168,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCwN5D5jvMPljVgT3s5sLEXyc0lYhwVXTBL6JXjFZbX0AIhALqvqFIHTTp2szbrf7oeMDz9cH9sPzCGxTJHSyFrMIih"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.0_1687864055542_0.6693686684560223"},"_hasShrinkwrap":false},"0.21.1":{"name":"@flexn/graybox","version":"0.21.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"1.22.3","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","_id":"@flexn/graybox@0.21.1","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-vMr0M3C+S5RNXYR5xuZY0SzYPpMuli5cNzPxiFuyCzKS5+XLEPt3MqJWTcmBUENUs8X/ZlcqgTmvCNszkHCb1w==","shasum":"c780b3d311e52f8e027a9f2287509fa8bdd2c6d7","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.1.tgz","fileCount":43,"unpackedSize":152169,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDtE4caWRkoSXQNAbXcbqiaw6holkfgtpIu73xGHiGIPQIgOuuhNfob+H3u6vAh/MH5A54IDnYpzMIjBen8uS7fwMI="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.1_1687941653837_0.3047628789277692"},"_hasShrinkwrap":false},"0.21.2-feat.5":{"name":"@flexn/graybox","version":"0.21.2-feat.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput","appium":"APPIUM_HOME=./ appium"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-xcuitest-driver":"4.32.11","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.5","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-9rAUqeNR4hL6ZubT441k+CHoFTjD2dtt7hKeC+JYndsdlAoxiQ+uUvT/w0A7OePW3pM2u9IypGR76Sj0LKV4bw==","shasum":"376eed509ca045e90d598648650e74961ca043b2","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.5.tgz","fileCount":43,"unpackedSize":152263,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDobXam4CAo1eO6A03JaJXfM9rPl6cUrrQrQ6wlYML5LAIgUrraKkEDHwERPGc+awcCVdneadHQkRjqBK1wzogThwg="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.5_1690198537589_0.512016479357503"},"_hasShrinkwrap":false},"0.21.2-feat.6":{"name":"@flexn/graybox","version":"0.21.2-feat.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-xcuitest-driver":"4.32.11","appium-uiautomator2-driver":"2.29.5","appium-mac2-driver":"1.7.2","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nTesting package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Package import\n\nIn specs file add Graybox import to use the package:\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n## Local test environment setup\n\n1. Create wdio.capabilities.js file in testable project's root folder.\n2. Copy capabilities object from testable project's wdio.conf.js to wdio.capabilities.js.\n3. In wdio.capabilities.js remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In wdio.capabilities.js file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of wdio.capabilities.js file can be seen below.\n\n```javascript\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to wdio.capabilities.js file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to wdio.capabilities.js file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible: true` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.6","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-qB7/RIeIzXMF7/O6iZZBNgfdizDdHOB1mpO/fFB+9sUnpq0cXqBT2WlTxrmxcVPxlanAYCkh7qTsralV+Pe55w==","shasum":"d2ef35dad31517a27df0bcfbfb860f7c68a9c1bc","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.6.tgz","fileCount":43,"unpackedSize":152307,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCifs8j3YDBM3TbhxyJE3LZEWzy5dPUrVOYnsA3UhTPxAIhAOcDdMYuZoBqE+yeVBOzUb7EfLF/BWEcO4wMQPnv4ZjS"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.6_1692709082800_0.3993806794281285"},"_hasShrinkwrap":false},"0.21.2-feat.7":{"name":"@flexn/graybox","version":"0.21.2-feat.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-xcuitest-driver":"4.32.11","appium-uiautomator2-driver":"2.29.5","appium-mac2-driver":"1.7.2","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to monorepo package then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.7","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-99ZTSHR67mx406kWJCOAJ1qgmDta+He8pqiv2nkQ/3BSeyv95YDCbuvEp06XP9m+legpPRwf5q44DJ/mWQzT/Q==","shasum":"f7a5a9d28ba7e82413f6c1cf6cd415adcb709863","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.7.tgz","fileCount":43,"unpackedSize":170562,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDRONFKFrIgVTbusgQCI7SVojNBU7QMNzVvh+5ud055DAIhAONomEFhJsAQC2EAMiAsg1ZxNGpcQQDlpHtiDYfewCME"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.7_1692778327165_0.35589305341609134"},"_hasShrinkwrap":false},"0.21.2-feat.8":{"name":"@flexn/graybox","version":"0.21.2-feat.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-xcuitest-driver":"4.32.11","appium-uiautomator2-driver":"2.29.5","appium-mac2-driver":"1.7.2","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@0.21.2-feat.8","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-bBLaKa77/4VFzIQHf554zIedbnXMZjI5KCxCvYgr8eCLo+UcREocMRDvaEf/5a9Fu7/80jrKNXV/UACj/oxj5Q==","shasum":"07181e3ee13615c3ab68f8fcfa74070e11e9569a","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-0.21.2-feat.8.tgz","fileCount":43,"unpackedSize":170631,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDaQ1GP8S/qQF7qKrRxyoNzEMavaNrmpiBYI3RJNDZerAIgEOcU4B9Z8E1w9D/hnIEKTctFE77UuR6ScGzA7DJ/f1Y="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_0.21.2-feat.8_1692861700300_0.7254229317275385"},"_hasShrinkwrap":false},"1.0.0":{"name":"@flexn/graybox","version":"1.0.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"e66d2b705b796e76d50e7ab7fa0ecbf7cfd143bd","types":"./lib/index.d.ts","_id":"@flexn/graybox@1.0.0","_nodeVersion":"16.14.2","_npmVersion":"lerna/6.6.2/node@v16.14.2+x64 (darwin)","dist":{"integrity":"sha512-Z0PJCCmnmBMIImzXK8tEcz0g8x2Iuw8+r3Og/5+VZIfNwaOtsI8du6nOaz/Po5OUDx8FP7OtQU0iP3yD0sqJeA==","shasum":"b55c64bb2f9d03d354595192bab490aff2c00aee","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0.tgz","fileCount":43,"unpackedSize":170623,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIHZE6GDuxIFtNA6HYtH9OulWSnAg2GrwxZOkUqTf4HfUAiEAr4ICKyttXzH/+r/uFFsgVeXS0R7IeAoGa3pNII10ylA="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0_1692862796767_0.3403181805603761"},"_hasShrinkwrap":false},"1.0.0-feat.0":{"name":"@flexn/graybox","version":"1.0.0-feat.0","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.0","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-6/C5lCo3N7Vw4d0SLeot1iQwCrdbARlk1G+oj1qEPB1gfPxqZg1/bWF/BCAimuSsDIb8klcW+0k4y8J7eVE1Cg==","shasum":"93bfb57f47d4b787f740b37d3e53359537ef1f2d","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.0.tgz","fileCount":43,"unpackedSize":176494,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDluyX6g2Oi2bJWJr56XJV9zN4LJ2a1AZ7AT/fDS1lDGAIhAN+f7lw4N/EMj+0CIWtKxlh/vvaAxc+KUuusyBVJnEMp"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.0_1693911788068_0.8866204323007034"},"_hasShrinkwrap":false},"1.0.0-feat.1":{"name":"@flexn/graybox","version":"1.0.0-feat.1","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","appium-tizen-tv-driver":"0.8.1","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.1","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-8hjkn/IgZ6kRCSehNGIf+u9Eyudzip+vIrNX3pTyt36pl7VOmKxcT1sC5rYVSL69pwDynHWIj6Z3s0fVqgQ50A==","shasum":"7ff629e81aed7e2d9f2717a7c268881ba4b5304b","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.1.tgz","fileCount":43,"unpackedSize":170673,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIA9xoQWZ6jXyEbVRIeb+yNfcs+oJaa+1l0AOL9j02s/2AiBbAB2zsc6ecOuRWJU4S9lAwmlQ0wQJQtvDlJeVrvTCig=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.1_1695036131602_0.6237072700269459"},"_hasShrinkwrap":false},"1.0.0-feat.2":{"name":"@flexn/graybox","version":"1.0.0-feat.2","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","appium-tizen-tv-driver":"0.8.1","appium-lg-webos-driver":"0.0.6","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.2","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-hoAepHAUe0XP6c5Hvp94GpTC8xycjUnNRsLr2WFBt3mKSWuqQWqyRi0JUOly78G6AVZwpwwlTTRuiDB6f3hIUA==","shasum":"3e5d91421ee2de26473327aca8d1057baca4ae6f","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.2.tgz","fileCount":43,"unpackedSize":170716,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIF2QFAixpDUH2JjTxQKRX6gZVlogDXqywtn2WOq3mvpdAiEA5hl/k5pNEdGdZ6LUAt5D4Fgr0gbszr7Q8c36YrVyfjI="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.2_1695104557346_0.2634098640591891"},"_hasShrinkwrap":false},"1.0.0-feat.3":{"name":"@flexn/graybox","version":"1.0.0-feat.3","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","appium-tizen-tv-driver":"0.8.1","appium-lg-webos-driver":"0.0.6","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.3","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-ff+3au8rTPKrMdPoIujwFzxq7yS7s8mQgbuV5yp0ygbz5nArOCLLIQ+7fIy0IgtJageGoXgfTdDo32lGU0ZpaA==","shasum":"86971620bf9f7d9a8f1e922aa29fc91ec65ac5db","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.3.tgz","fileCount":47,"unpackedSize":184424,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCjcksLZQHPkTYzr3vpSr3ABp1C5DxpFXBXA7pvIRbcpwIgAwhXoU7eUOh18t7kvkhSLoj0aNSQ1ayi1ax62TUNgfE="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.3_1695136764779_0.39293660784540796"},"_hasShrinkwrap":false},"1.0.0-feat.4":{"name":"@flexn/graybox","version":"1.0.0-feat.4","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","appium-tizen-tv-driver":"0.8.1","appium-lg-webos-driver":"0.0.6","chromedriver":"102.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.4","_nodeVersion":"16.14.2","_npmVersion":"8.5.0","dist":{"integrity":"sha512-HatFt60FlsJ6Swu80cdXDDctqw6AM8psX2OCqsnLUI2dLx1+cZP7KP9XXKOotNcMuKmejUoqpa+WqD3nmHPhLA==","shasum":"11adeeb84f0fcdd480578a606247705b34f31e99","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.4.tgz","fileCount":47,"unpackedSize":184419,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDmN5BgwwMhYTyl6JQzLvHeRjx+UKHGTVk4jloAoJJ6sAIhAPRno/mOZ2xIpV7PPtb5I42yBBqSVgbI2j+0uVhc47qP"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.4_1695283474560_0.042041325752752545"},"_hasShrinkwrap":false},"1.0.0-feat.5":{"name":"@flexn/graybox","version":"1.0.0-feat.5","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"8.24.2","@wdio/appium-service":"8.24.2","@wdio/cli":"8.24.2","@wdio/local-runner":"8.24.2","@wdio/mocha-framework":"8.24.2","@wdio/selenium-standalone-service":"8.14.0","@wdio/spec-reporter":"8.24.2","allure-commandline":"2.24.1","appium":"2.2.2","appium-mac2-driver":"1.8.8","appium-uiautomator2-driver":"2.34.1","appium-xcuitest-driver":"5.11.0","chromedriver":"119.0.1","wdio-chromedriver-service":"8.1.1","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.5","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-QPvjDraItTMlaZ4MsPjt4sFzrclB+sCmSpgLzhWsd6Yujd0dQ3f51azY0NqomI/YdZ03vwOcDOgeh4xYYLzdxA==","shasum":"94d143daaf7cce6cf5fe3449c001fd299605951c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.5.tgz","fileCount":43,"unpackedSize":169502,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIAYpRVwwaypuOg51+/dgN6V6vhSX0x98CMQtTJU2DQFBAiEA29xWYFUFZMOFml0Tx9R34WdTSkx0HW00U9KctjWTpPY="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.5_1701086716260_0.43563956424664285"},"_hasShrinkwrap":false},"1.0.0-feat.6":{"name":"@flexn/graybox","version":"1.0.0-feat.6","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"8.24.2","@wdio/appium-service":"8.24.2","@wdio/cli":"8.24.2","@wdio/local-runner":"8.24.2","@wdio/mocha-framework":"8.24.2","@wdio/spec-reporter":"8.24.2","allure-commandline":"2.24.1","appium":"2.2.2","appium-mac2-driver":"1.8.8","appium-uiautomator2-driver":"2.34.1","appium-xcuitest-driver":"5.11.0","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0","wdio-electron-service":"^6.0.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.6","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-SNAWDaXwvyHJZgb9C0EbSpImj3BXMLyoob7+5KPL51CUzV4JbB+dNHIAW42sTVnhMIDc6HIx4GrW1MI/oRvuMg==","shasum":"dc703ac65dd5bf3de2dadcb83c8e61e4cbb1eb9c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.6.tgz","fileCount":3,"unpackedSize":50216,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDnKDCCK2NhF0yuP7zY2Oglnq9zvpVSLQhf7tO8nMC8jQIhAK5ZMbtGsvDPXKQkPEWwkxdbJF8qsHPNlHIzA0OLqTrT"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.6_1701814999416_0.7424703691901435"},"_hasShrinkwrap":false},"1.0.0-feat.7":{"name":"@flexn/graybox","version":"1.0.0-feat.7","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","wdio-electron-service":"6.0.0","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.7","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-a0SeymwnJQpyAAoH1BKnsof05+1SOUTQbvpg0Xowo3C+ja/Qg7rs28UdT7q3uanQ/Prjam6qi2W33V6jMkrS7A==","shasum":"699f6b8084da1211dc561c0ece21d950f46339d9","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.7.tgz","fileCount":43,"unpackedSize":170591,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD57NyRVdyxk3U5ny0g95gJ/jsRQRkMomznGQLrmjfB7wIgGTju2dVHl5zm5E8aSmxV55cIzXN8RczZeXhFTgPhgN4="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.7_1701819256913_0.9110929952798443"},"_hasShrinkwrap":false},"1.0.0-feat.8":{"name":"@flexn/graybox","version":"1.0.0-feat.8","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","@wdio/globals":"8.24.12","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","wdio-electron-service":"6.0.0","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.8","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-y4WBzWvyOz8J9IW7EqpMjGGYl5CJDjUNFEc7ApWCfZMfC+xu04q8nFvCNz25+QJbvVjzjwov300TwrEyw3nOfw==","shasum":"48a64ee3d892d9d677ba48357a7a98eaf377fc35","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.8.tgz","fileCount":43,"unpackedSize":170627,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDl0/UkDTcwwuUIwFKbL3ymFPVD8ZwUjZen+5agZ1E4lgIhAPLZCNT0/ytQCPp2HfQkuhzTkt6wJy0wFAl6l3KrGejx"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.8_1701819822598_0.16170782357218183"},"_hasShrinkwrap":false},"1.0.0-feat.9":{"name":"@flexn/graybox","version":"1.0.0-feat.9","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"7.19.5","@wdio/appium-service":"7.19.5","@wdio/cli":"7.19.5","@wdio/local-runner":"7.19.5","@wdio/mocha-framework":"7.19.5","@wdio/selenium-standalone-service":"7.19.5","@wdio/spec-reporter":"7.19.5","allure-commandline":"2.17.2","appium":"2.0.0","appium-mac2-driver":"1.7.2","appium-uiautomator2-driver":"2.29.5","appium-xcuitest-driver":"4.32.11","chromedriver":"116.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.9","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-Hapm2hMf3nzXPbzTNwdY28jE1BTz8Wqm4r/C1umc00VEVDnyX7m86054ykU+wGNnjObIFgFZClE7Yf2eOV9wyA==","shasum":"d4404b2c94188b6bb2538a36f56d4292f43ee01c","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.9.tgz","fileCount":43,"unpackedSize":170630,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQC9A1YfSvdITFjflltP6E0X8B3fa47H5mZr++qVcmnTOgIgPinXOIpc9mPrIUsAw2lBmeWN/KAc9Ih3h0iZ0mvDFGA="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.9_1701820488085_0.4648119979307932"},"_hasShrinkwrap":false},"1.0.0-feat.10":{"name":"@flexn/graybox","version":"1.0.0-feat.10","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"8.24.2","@wdio/appium-service":"8.24.2","@wdio/cli":"8.24.2","@wdio/local-runner":"8.24.2","@wdio/mocha-framework":"8.24.2","@wdio/spec-reporter":"8.24.2","allure-commandline":"2.24.1","appium":"2.2.2","appium-mac2-driver":"1.8.8","appium-uiautomator2-driver":"2.34.1","appium-xcuitest-driver":"5.11.0","chromedriver":"116.0.0","wdio-chromedriver-service":"8.1.1","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.10","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-SUBxnLcnpXy1QBAwIBBDpW9chwkcDoHpX0gOpR8dt2RKZfkpqzCzRcOR99g837LmmRVeBzZRHeix0NL4cV33OA==","shasum":"3b31f01da34539b4947cab195da548475e19e314","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.10.tgz","fileCount":3,"unpackedSize":50255,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCF8WiHjAdRf1oEI+rYUdsSvXw1WFtqewNNVgVgb/jA9QIhAO3D4pQ5vG4M6cNlmhvqd+LCHBZ741OZb3jvEBFckHQR"}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.10_1702026099954_0.2858619166555254"},"_hasShrinkwrap":false},"1.0.0-feat.11":{"name":"@flexn/graybox","version":"1.0.0-feat.11","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"8.24.2","@wdio/appium-service":"8.24.2","@wdio/cli":"8.24.2","@wdio/local-runner":"8.24.2","@wdio/mocha-framework":"8.24.2","@wdio/spec-reporter":"8.24.2","allure-commandline":"2.24.1","appium":"2.2.2","appium-mac2-driver":"1.8.8","appium-uiautomator2-driver":"2.34.1","appium-xcuitest-driver":"5.11.0","chromedriver":"116.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.11","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-N1ARxfrGWA6Riy35WiwOb6BSw8XlRPgq03Q86xBWa9oYWJsWoxxZ7ycTPv8nW7zWyM7TvBAlqtS5VOkTrGMkeA==","shasum":"cb566f04e6aff034038a508cb312d9b4b0cfc2af","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.11.tgz","fileCount":3,"unpackedSize":50255,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFHUAr0ieNsr4bCu9zpmVrSdoXk6gpr7qzomT7GF+JehAiBeNRr9RVkQkZth1iJ7JCZJF+njmbc98hkwypy4/ivRsg=="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.11_1702027312834_0.04874961100091113"},"_hasShrinkwrap":false},"1.0.0-feat.12":{"name":"@flexn/graybox","version":"1.0.0-feat.12","description":"Flexn Graybox Tester","main":"lib/index.js","scripts":{"build":"yarn clean && yarn compile","clean":"rm -rf ./lib && rm -rf tsconfig.tsbuildinfo","compile":"tsc -b tsconfig.json","watch":"tsc --watch --preserveWatchOutput"},"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"publishConfig":{"access":"public"},"keywords":[],"author":{"name":"Flexn BV"},"license":"MIT","bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"homepage":"https://github.com/flexn-io/graybox#readme","dependencies":{"@wdio/allure-reporter":"8.24.2","@wdio/appium-service":"8.24.2","@wdio/cli":"8.24.2","@wdio/local-runner":"8.24.2","@wdio/mocha-framework":"8.24.2","@wdio/spec-reporter":"8.24.2","allure-commandline":"2.24.1","appium":"2.2.2","appium-mac2-driver":"1.8.8","appium-uiautomator2-driver":"2.34.1","appium-xcuitest-driver":"5.11.0","chromedriver":"116.0.0","wdio-chromedriver-service":"7.2.2","wdio-image-comparison-service":"5.0.3","wdio-native-app-compare-service":"2.1.0"},"gitHead":"589bf39903ec751b50788e579e452e7a292e89cc","types":"./lib/index.d.ts","readme":"# @flexn/graybox\n\n## Overview\n\nE2E testing package using WebdriverIO. Native apps use [Appium Service](https://webdriver.io/docs/appium-service) and [wdio-native-app-compare](https://github.com/wswebcreation/wdio-native-app-compare). Web uses [Selenium Standalone Service](https://webdriver.io/docs/selenium-standalone-service) and [wdio-image-comparison-service](https://github.com/wswebcreation/wdio-image-comparison-service). Reporting is done using [Allure Reporter](https://webdriver.io/docs/allure-reporter).\n\n## Adding Graybox to your project\n\n1. Do `npm install @flexn/graybox --save-dev`\n2. Create `wdio.conf.js` file, example can be found below these steps.\n3. Customize `capabilities` according to your platform scope (in the example are all supported platforms by Graybox), simulator environment and testable application.\n4. Customize `services` according to your platform scope.\n5. Customize any other needed properties like `baseUrl` and `specs`.\n6. If Graybox is added to yarn workspaces monorepo then lines below must be added to monorepo root `package.json`.\n\n```json\n\"nohoist\": [\n \"**/@flexn/graybox\",\n \"**/appium-*\",\n \"**/@wdio/*\"\n]\n```\n\n7. Set test ID's in the application's source code (if needed). Android and AndroidTV get test ID from `accessibilityLabel` property, also `accessible` needs to be added to the element. All other platforms supported by Graybox get test ID from `TestID` property. Example is below.\n\n```javascript\n\n \n\n```\n\nAlternatively method can be created and imported which returns specific test ID depending on platform. \n\n8. Create test specs file and import Graybox package.\n\n```javascript\nconst FlexnRunner = require('@flexn/graybox').default;\n```\n\n9. Write your tests using FlexnRunner. How to execute written tests look at [Test executing](#test-executing).\n\n```javascript\n// wdio.conf.js\n\nconst fs = require('fs');\nconst path = require('path');\n\nlet customCapabilities = {};\nif (fs.existsSync(path.join(__dirname, './wdio.capabilities.template.js'))) {\n const { capabilities } = require('./wdio.capabilities.template');\n customCapabilities = capabilities;\n}\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n 'appium:options': {\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n 'appium:options': {\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n },\n ],\n android: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n 'appium:options': {\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n 'appium:options': {\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n //\n // capabilities below should be used when electron framework is used to build macos app\n //\n // browserName: 'chrome',\n // 'goog:chromeOptions': {\n // binary: 'path/to/electron/binary',\n // args: ['app=path/to/my/app'],\n // },\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n ...customCapabilities,\n};\n\nexports.config = {\n //\n // ====================\n // Runner Configuration\n // ====================\n //\n //\n // ==================\n // Specify Test Files\n // ==================\n // Define which test specs should run. The pattern is relative to the directory\n // from which `wdio` was called.\n //\n // The specs are defined as an array of spec files (optionally using wildcards\n // that will be expanded). The test for each spec file will be run in a separate\n // worker process. In order to have a group of spec files run in the same worker\n // process simply enclose them in an array within the specs array.\n //\n // If you are calling `wdio` from an NPM script (see https://docs.npmjs.com/cli/run-script),\n // then the current working directory is where your `package.json` resides, so `wdio`\n // will be called from there.\n //\n specs: ['./test/specs/*.js'],\n // Patterns to exclude.\n exclude: [\n // 'path/to/excluded/files'\n ],\n //\n // ============\n // Capabilities\n // ============\n // Define your capabilities here. WebdriverIO can run multiple capabilities at the same\n // time. Depending on the number of capabilities, WebdriverIO launches several test\n // sessions. Within your capabilities you can overwrite the spec and exclude options in\n // order to group specific specs to a specific capability.\n //\n // First, you can define how many instances should be started at the same time. Let's\n // say you have 3 different capabilities (Chrome, Firefox, and Safari) and you have\n // set maxInstances to 1; wdio will spawn 3 processes. Therefore, if you have 10 spec\n // files and you set maxInstances to 10, all spec files will get tested at the same time\n // and 30 processes will get spawned. The property handles how many capabilities\n // from the same test should run tests.\n //\n maxInstances: 10,\n //\n // If you have trouble getting all important capabilities together, check out the\n // Sauce Labs platform configurator - a great tool to configure your capabilities:\n // https://docs.saucelabs.com/reference/platforms-configurator\n //\n capabilities: capabilities[process.env.PLATFORM],\n\n //\n // ===================\n // Test Configurations\n // ===================\n // Define all options that are relevant for the WebdriverIO instance here\n //\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n logLevel: 'info',\n //\n // Set specific log levels per logger\n // loggers:\n // - webdriver, webdriverio\n // - @wdio/browserstack-service, @wdio/devtools-service, @wdio/sauce-service\n // - @wdio/mocha-framework, @wdio/jasmine-framework\n // - @wdio/local-runner\n // - @wdio/sumologic-reporter\n // - @wdio/cli, @wdio/config, @wdio/utils\n // Level of logging verbosity: trace | debug | info | warn | error | silent\n // logLevels: {\n // webdriver: 'info',\n // '@wdio/appium-service': 'info'\n // },\n //\n // If you only want to run your tests until a specific amount of tests have failed use\n // bail (default is 0 - don't bail, run all tests).\n bail: 0,\n //\n // Set a base URL in order to shorten url command calls. If your `url` parameter starts\n // with `/`, the base url gets prepended, not including the path portion of your baseUrl.\n // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url\n // gets prepended directly.\n baseUrl: 'http://localhost:8080',\n //\n // Default timeout for all waitFor* commands.\n waitforTimeout: 10000,\n //\n // Default timeout in milliseconds for request\n // if browser driver or grid doesn't send response\n connectionRetryTimeout: 120000,\n //\n // Default request retries count\n connectionRetryCount: 3,\n //\n // Test runner services\n // Services take over a specific job you don't want to take care of. They enhance\n // your test setup with almost no effort. Unlike plugins, they don't add new\n // commands. Instead, they hook themselves up into the test process.\n ...(process.env.PLATFORM === 'web' && {\n services: [\n 'selenium-standalone',\n [\n 'image-comparison',\n {\n baselineFolder: './test/baselineImages',\n formatImageName: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerInstance: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutToolBar: true,\n blockOutSideBar: true,\n },\n ],\n ],\n }),\n //\n // services below should be used when electron framework is used to build macos app\n //\n // ...(process.env.PLATFORM === 'macos' && {\n // services: [\n // 'chromedriver',\n // [\n // 'image-comparison',\n // {\n // baselineFolder: './test/baselineImages',\n // formatImageName: '{tag}',\n // screenshotPath: '.tmp/actualImages',\n // savePerInstance: true,\n // autoSaveBaseline: true,\n // blockOutStatusBar: true,\n // blockOutToolBar: true,\n // blockOutSideBar: true,\n // },\n // ],\n // ],\n // }),\n ...((process.env.PLATFORM === 'ios' ||\n process.env.PLATFORM === 'tvos' ||\n process.env.PLATFORM === 'android' ||\n process.env.PLATFORM === 'androidtv' ||\n process.env.PLATFORM === 'macos') && {\n services: [\n [\n 'appium',\n {\n args: {\n ...(process.env.PLATFORM === 'ios' && {\n port: 3001,\n }),\n ...(process.env.PLATFORM === 'tvos' && {\n port: 3002,\n }),\n ...(process.env.PLATFORM === 'android' && {\n port: 3003,\n }),\n ...(process.env.PLATFORM === 'androidtv' && {\n port: 3004,\n }),\n ...(process.env.PLATFORM === 'macos' && {\n port: 3005,\n }),\n },\n },\n ],\n [\n 'native-app-compare',\n {\n baselineFolder: './test/baselineImages',\n imageNameFormat: '{tag}',\n screenshotPath: '.tmp/actualImages',\n savePerDevice: true,\n autoSaveBaseline: true,\n blockOutStatusBar: true,\n blockOutNavigationBar: true,\n blockOutIphoneHomeBar: true,\n },\n ],\n ],\n }),\n\n // Framework you want to run your specs with.\n // The following are supported: Mocha, Jasmine, and Cucumber\n // see also: https://webdriver.io/docs/frameworks\n //\n // Make sure you have the wdio adapter package for the specific framework installed\n // before running any tests.\n framework: 'mocha',\n //\n // The number of times to retry the entire specfile when it fails as a whole\n // specFileRetries: 1,\n //\n // Delay in seconds between the spec file retry attempts\n // specFileRetriesDelay: 0,\n //\n // Whether or not retried specfiles should be retried immediately or deferred to the end of the queue\n // specFileRetriesDeferred: false,\n //\n // Test reporter for stdout.\n // The only one supported by default is 'dot'\n // see also: https://webdriver.io/docs/dot-reporter\n reporters: [\n 'spec',\n [\n 'allure',\n {\n outputDir: 'reporting/allure-results',\n },\n ],\n ],\n\n //\n // Options to be passed to Mocha.\n // See the full list at http://mochajs.org/\n mochaOpts: {\n ui: 'bdd',\n timeout: 60000,\n },\n //\n // =====\n // Hooks\n // =====\n // WebdriverIO provides several hooks you can use to interfere with the test process in order to enhance\n // it and to build services around it. You can either apply a single function or an array of\n // methods to it. If one of them returns with a promise, WebdriverIO will wait until that promise got\n // resolved to continue.\n /**\n * Gets executed once before all workers get launched.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n */\n // onPrepare: function (config, capabilities) {\n // },\n /**\n * Gets executed before a worker process is spawned and can be used to initialise specific service\n * for that worker as well as modify runtime environments in an async fashion.\n * @param {String} cid capability id (e.g 0-0)\n * @param {[type]} caps object containing capabilities for session that will be spawn in the worker\n * @param {[type]} specs specs to be run in the worker process\n * @param {[type]} args object that will be merged with the main configuration once worker is initialised\n * @param {[type]} execArgv list of string arguments passed to the worker process\n */\n // onWorkerStart: function (cid, caps, specs, args, execArgv) {\n // },\n /**\n * Gets executed just before initialising the webdriver session and test framework. It allows you\n * to manipulate configurations depending on the capability or spec.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n */\n // beforeSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed before test execution begins. At this point you can access to all global\n * variables like `browser`. It is the perfect place to define custom commands.\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that are to be run\n * @param {Object} browser instance of created browser/device session\n */\n // before: function (capabilities, specs) {\n // },\n /**\n * Runs before a WebdriverIO command gets executed.\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n */\n // beforeCommand: function (commandName, args) {\n // },\n /**\n * Hook that gets executed before the suite starts\n * @param {Object} suite suite details\n */\n // beforeSuite: function (suite) {\n // },\n /**\n * Function to be executed before a test (in Mocha/Jasmine) starts.\n */\n // beforeTest: function (test, context) {\n // },\n /**\n * Hook that gets executed _before_ a hook within the suite starts (e.g. runs before calling\n * beforeEach in Mocha)\n */\n // beforeHook: function (test, context) {\n // },\n /**\n * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling\n * afterEach in Mocha)\n */\n // afterHook: function (test, context, { error, result, duration, passed, retries }) {\n // },\n /**\n * Function to be executed after a test (in Mocha/Jasmine).\n */\n // afterTest: function(test, context, { error, result, duration, passed, retries }) {\n // },\n\n /**\n * Hook that gets executed after the suite has ended\n * @param {Object} suite suite details\n */\n // afterSuite: function (suite) {\n // },\n /**\n * Runs after a WebdriverIO command gets executed\n * @param {String} commandName hook command name\n * @param {Array} args arguments that command would receive\n * @param {Number} result 0 - command success, 1 - command error\n * @param {Object} error error object if any\n */\n // afterCommand: function (commandName, args, result, error) {\n // },\n /**\n * Gets executed after all tests are done. You still have access to all global variables from\n * the test.\n * @param {Number} result 0 - test pass, 1 - test fail\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // after: function (result, capabilities, specs) {\n // },\n /**\n * Gets executed right after terminating the webdriver session.\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {Array.} specs List of spec file paths that ran\n */\n // afterSession: function (config, capabilities, specs) {\n // },\n /**\n * Gets executed after all workers got shut down and the process is about to exit. An error\n * thrown in the onComplete hook will result in the test run failing.\n * @param {Object} exitCode 0 - success, 1 - fail\n * @param {Object} config wdio configuration object\n * @param {Array.} capabilities list of capabilities details\n * @param {} results object containing test results\n */\n // onComplete: function(exitCode, config, capabilities, results) {\n // },\n /**\n * Gets executed when a refresh happens.\n * @param {String} oldSessionId session ID of the old session\n * @param {String} newSessionId session ID of the new session\n */\n // onReload: function(oldSessionId, newSessionId) {\n // }\n};\n\n```\n\n## Optional local test environment setup\n\nOften it is useful to be able to customize local test environment. This is also supported by Graybox and can be achieved by following steps below.\n\n1. Create `wdio.capabilities.js` file in testable project's root folder (make sure to add this file to `.gitignore`).\n2. Copy capabilities object from testable project's `wdio.conf.js` to `wdio.capabilities.js`.\n3. In `wdio.capabilities.js` remove `...customCapabilities,` and after object add `module.exports = { capabilities };`.\n4. In `wdio.capabilities.js` file change `deviceName` and `platformVersion` for iOS, tvOS and change `avd`, `deviceName` and `platformVersion` for Android, AndroidTV. Example of `wdio.capabilities.js` file can be seen below.\n\n```javascript\n// wdio.capabilities.js\n\nconst capabilities = {\n ios: [\n {\n platformName: 'iOS',\n deviceName: 'iPhone 11',\n platformVersion: '13.5',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n tvos: [\n {\n platformName: 'tvOS',\n deviceName: 'Apple TV',\n platformVersion: '14.4',\n automationName: 'XCUITest',\n bundleId: 'my.bundleId',\n app: 'path/to/my/app',\n },\n ],\n android: [\n {\n platformName: 'Android',\n avd: 'Pixel_4_API_29',\n deviceName: 'Pixel_4_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n androidtv: [\n {\n platformName: 'Android',\n avd: 'Android_TV_1080p_API_29',\n deviceName: 'Android_TV_1080p_API_29',\n platformVersion: '10',\n automationName: 'UiAutomator2',\n appPackage: 'my.appPackage',\n appActivity: 'my.appActivity',\n app: 'path/to/my/app',\n },\n ],\n macos: [\n {\n platformName: 'Mac',\n deviceName: 'macOS',\n automationName: 'Mac2',\n bundleId: 'my.bundleId',\n },\n ],\n web: [\n {\n browserName: 'chrome',\n },\n {\n browserName: 'firefox',\n },\n {\n browserName: 'MicrosoftEdge',\n },\n {\n browserName: 'safari',\n },\n ],\n};\n\nmodule.exports = { capabilities };\n```\n\n## Additional environment setup for testing on real device\n\nFor iOS/tvOS:\n\n1. Add the following code to `wdio.capabilities.js` file under ios/tvos object. `` must be replaced by device udid. Device udid can be found under indentifier on Xcode by navigating to Window -> Devices and Simulators and selecting connected device. `` must be replaced by Team ID. Team ID can be found using developer account. Sign in to `developer.apple.com/account`, and click Membership in the sidebar. Team ID appears in the Membership Information section under the team name.\n\n```javascript\nudid: '',\nxcodeOrgId: '',\nxcodeSigningId: 'iPhone Developer'\n```\n\n2. If the first step doesn't work, then open `./node-modules/appium-webdriveragent/WebDriverAgent.xcodeproj`. Select WebDriverAgent project and select WebDriverAgentRunner (for iOS) or WebDriverAgentRunner_tvOS (for tvOS) target, then under Signing & Capabilities tab select developer team.\n\nFor Android/AndroidTV:\n\n1. Add the following code to `wdio.capabilities.js` file under android/androidtv object and comment `avd` property. `` must be replaced by device udid. Device udid can be found using cli command `adb devices`.\n\n```javascript\nudid: '';\n```\n\n## Test executing\n\n1. Make sure application is built (applies for iOS, tvOS, Android, AndroidTV, macOS) or hosted to server (applies for Web).\n2. Run in cli `APPIUM_HOME=./ PLATFORM= ENGINE= npx wdio wdio.conf.js`. `` must be replaced by `ios`, `tvos`, `android`, `androidtv`, `macos` or `web`. `ENGINE` environment variable is only needed for macOS and `` must be replaced by `macos` or `electron` depending on what framework macOS application is built. `APPIUM_HOME=./` is only needed for platforms which use Appium Service and it is not necessary when project is not monorepo.\n\n## Prerequisites executing tests on macOS app\n\n> Xcode Helper app should be enabled for Accessibility access. The app itself could be usually found at `/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/Xcode Helper.app`. In order to enable Accessibility access for it simply open the parent folder in Finder:\n\n```\n open /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/Library/Xcode/Agents/\n```\n\n> and drag & drop the Xcode Helper app to Security & Privacy -> Privacy -> Accessibility list of your System Preferences. This action must only be done once.\n\n## Selector strategies\n\nTest ID selector strategy varies from platform to platform. Table below shows from what property each platform maps test ID so some platforms need different properties to be set in application source code when adding test ID's. When writing tests user needs to provide only test ID itself to method and Graybox handles everything else on every platform.\n\n| Platform | Test ID selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| iOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| tvOS | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| macOS using Apple SDK | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `TestID` property |\n| Android | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where test ID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| AndroidTV | [Accessibility ID](https://webdriver.io/docs/selectors/#accessibility-id) strategy selector with predefined `~` where testID is mapped from `accessibilityLabel` property. NOTE: `accessible` also needs to be added to the element |\n| macOS using Electron | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n| Web | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `data-testid` attribute which maps test ID from `TestID` property |\n\nText selector strategy varies from platform to platform. This strategy doesn't require any additional property setting in application source code assuming element has visible text in front end. When writing tests user needs to provide only visible text on the element to method and Graybox handles everything else on every platform.\n\n| Platform | Text selector strategy |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| iOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| tvOS | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `label` attribute |\n| macOS using Apple SDK | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `name` attribute |\n| Android | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| AndroidTV | [Name Attribute](https://webdriver.io/docs/selectors/#name-attribute) strategy selector with predefined `text` attribute |\n| macOS using Electron | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n| Web | [xPath](https://webdriver.io/docs/selectors/#xpath) strategy selector |\n\n## Methods\n\n### launchApp\n\nLaunches application.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.launchApp();\n```\n\nIMPORTANT: must be included in before hook:\n\n```javascript\nbefore(() => {\n FlexnRunner.launchApp();\n});\n```\n\n### getElementById\n\nReturns element object by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### getElementByText\n\nReturns element object by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.getElementByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### scrollById\n\nScrolls to element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.scrollById(selectorTo, direction, selectorFrom);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------------ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| selectorTo | string | test ID of the element to which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n| direction | either 'up', 'down', 'left' or 'right' | direction of the scroll |\n| selectorFrom | string | test ID of the element from which scroll is executed. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickById\n\nClicks on element by provided test ID.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### clickByText\n\nClicks on element by provided text.\n\n**Platform support**\n\nSupported on: iOS, macOS, Android, Web.\n\n**Usage**\n\n```javascript\nFlexnRunner.clickByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pressButtonHome\n\nPresses native platform _Home_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonHome(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonBack\n\nPresses native platform _Back_ button.\n\n**Platform support**\n\nSupported on: iOS, tvOS, Android, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonBack(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonUp\n\nPresses native platform _Up_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonUp(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonDown\n\nPresses native platform _Down_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonDown(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonLeft\n\nPresses native platform _Left_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonLeft(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonRight\n\nPresses native platform _Right_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonRight(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### pressButtonSelect\n\nPresses native platform _Select_ button.\n\n**Platform support**\n\nSupported on: tvOS, AndroidTV.\n\n**Usage**\n\n```javascript\nFlexnRunner.pressButtonSelect(n);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------ |\n| n | number | number of button presses |\n\n### expectToMatchElementById\n\nValidates whether actual screenshot of element by provided test ID matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementById(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchElementByText\n\nValidates whether actual screenshot of element by provided text matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchElementByText(selector, tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToMatchScreen\n\nValidates whether actual screenshot of screen matches baseline screenshot.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToMatchScreen(tag, acceptableMismatch);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| tag | string | tag used in screenshot name |\n| acceptableMismatch | number | acceptable percentage (default: 5) of actual screenshot differences from baseline screenshot |\n\n### expectToBeExistingById\n\nValidates whether element is existing by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeExistingByText\n\nValidates whether element is existing by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeExistingByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedById\n\nValidates whether element is displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeDisplayedByText\n\nValidates whether element is displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeDisplayedByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableById\n\nValidates whether element is clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToBeClickableByText\n\nValidates whether element is clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToBeClickableByText(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### expectToHaveTextById\n\nValidates whether element has specific text by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveTextById(selector, text);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| text | string | expected text in the element |\n\n### expectToHaveValueById\n\nValidates whether element has specific value by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.expectToHaveValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| --- | --- | --- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | expected value in the element |\n\n### waitForDisplayedById\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForDisplayedByText\n\nWaits for an element for the provided amount of milliseconds to be displayed by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForDisplayedByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistById\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForExistByText\n\nWaits for an element for the provided amount of milliseconds to be present within the DOM by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForExistByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableById\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableById(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### waitForClickableByText\n\nWaits for an element for the provided amount of milliseconds to be clickable by provided text.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.waitForClickableByText(selector, timeout);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | ------------------------------------------------------------------------------------------------- |\n| selector | string | visible text on the element. For more context look at [Selector strategies](#selector-strategies) |\n| timeout | number | time in ms (default: 60000) for which waiting action is executed |\n\n### setValueById\n\nSends a sequence of key strokes to an element after the input has been cleared before by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.setValueById(selector, value);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n| value | string | value to be added |\n\n### clearValueById\n\nClears the value of an input or textarea element by provided test ID.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.clearValueById(selector);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| -------- | ------ | -------------------------------------------------------------------------------------------- |\n| selector | string | test ID of the element. For more context look at [Selector strategies](#selector-strategies) |\n\n### pause\n\nPauses execution for a specific amount of time. It is recommended to not use this command to wait for an element to show up. In order to avoid flaky test results it is better to use commands like `waitForExistById` or other waitFor\\* commands.\n\n**Platform support**\n\nSupported on all platforms.\n\n**Usage**\n\n```javascript\nFlexnRunner.pause(time);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ---- | ------ | ------------------------------------------------ |\n| time | number | time in ms for which execution of test is paused |\n\n### GIVEN\n\nLogs to cli `GIVEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.GIVEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ------------------------------------------ |\n| message | string | text to be logged to console with `GIVEN:` |\n\n### WHEN\n\nLogs to cli `WHEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.WHEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `WHEN:` |\n\n### THEN\n\nLogs to cli `THEN:` with provided message.\n\n**Usage**\n\n```javascript\nFlexnRunner.THEN(message);\n```\n\n**Arguments**\n\n| Name | Type | Details |\n| ------- | ------ | ----------------------------------------- |\n| message | string | text to be logged to console with `THEN:` |\n","readmeFilename":"README.md","_id":"@flexn/graybox@1.0.0-feat.12","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-GGfsm5YGu9REZXnbx2L+F5NNbQ92uvj826vxpoyHFqZJANmqDHgRtLkjkVYv+o17ZFK7yvFaSQxqWJqbuS8RMQ==","shasum":"7d4985714b57a0cac58431995e55c777fe37ead7","tarball":"https://registry.npmjs.org/@flexn/graybox/-/graybox-1.0.0-feat.12.tgz","fileCount":43,"unpackedSize":169278,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCKvI6FwTOFFGTcwooQ2lOhiKiFyewuzr3NS7iz3r2x6wIgDlfAvyCTFNKsSHgRYw0kyqVXQhUprTajaKPZfS23IyM="}]},"_npmUser":{"name":"pavjacko","email":"beherithrone@gmail.com"},"directories":{},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/graybox_1.0.0-feat.12_1702041891155_0.28832330635230297"},"_hasShrinkwrap":false}},"time":{"created":"2022-01-29T11:04:07.304Z","0.8.0-alpha.4":"2022-01-29T11:04:07.611Z","modified":"2023-12-08T13:24:51.550Z","0.9.0-alpha.0":"2022-01-29T13:37:01.852Z","0.9.0-alpha.1":"2022-01-30T19:56:38.555Z","0.9.0-alpha.2":"2022-01-31T07:31:23.061Z","0.9.0-feat.0":"2022-01-31T15:55:46.325Z","0.9.0-alpha.3":"2022-02-01T11:32:57.813Z","0.9.0-alpha.4":"2022-02-01T20:48:52.148Z","0.8.0":"2022-02-04T15:40:43.125Z","0.8.1":"2022-02-07T09:47:26.574Z","0.9.0":"2022-02-08T07:34:58.345Z","0.9.1-alpha.0":"2022-02-10T21:21:15.858Z","0.9.1-alpha.1":"2022-02-11T08:32:06.158Z","0.10.0":"2022-02-13T18:53:03.805Z","0.10.1-alpha.0":"2022-02-14T15:34:41.323Z","0.10.1-alpha.1":"2022-02-16T19:28:51.374Z","0.10.1-alpha.2":"2022-02-17T06:57:07.362Z","0.10.1-alpha.3":"2022-02-17T08:24:13.448Z","0.10.1-alpha.4":"2022-02-17T20:13:35.812Z","0.11.0":"2022-02-18T13:49:40.288Z","0.11.1-alpha.0":"2022-02-22T18:28:32.421Z","0.11.1-alpha.1":"2022-02-26T18:01:14.219Z","0.12.0":"2022-03-04T13:50:20.249Z","0.12.1-feat-visible-id.1":"2022-03-10T12:35:36.095Z","0.12.1-alpha.0":"2022-03-18T08:23:13.665Z","0.13.0":"2022-03-20T09:08:10.158Z","0.13.1-alpha.0":"2022-03-20T10:16:37.553Z","0.13.1-alpha.1":"2022-03-20T11:02:19.321Z","0.13.1":"2022-03-20T11:37:02.286Z","0.13.2-alpha.0":"2022-05-05T12:57:02.086Z","0.13.2":"2022-05-11T20:44:53.474Z","0.13.3-alpha.0":"2022-05-20T06:38:13.711Z","0.14.0":"2022-05-30T14:18:10.075Z","0.15.0-alpha.0":"2022-06-02T06:00:20.306Z","0.15.0-alpha.1":"2022-06-02T15:38:25.520Z","0.15.0":"2022-06-05T16:15:38.915Z","0.15.1-alpha.0":"2022-06-06T09:10:01.182Z","0.15.1":"2022-06-06T09:37:28.564Z","0.15.2-alpha.0":"2022-06-06T09:45:34.015Z","0.15.2":"2022-06-06T17:17:35.815Z","0.15.3-alpha.0":"2022-06-06T23:36:15.320Z","0.15.3-feat.0":"2022-06-08T10:16:17.082Z","0.15.3-alpha.1":"2022-06-08T18:29:48.041Z","0.15.3-alpha.2":"2022-06-08T19:45:27.512Z","0.15.3-alpha.3":"2022-06-09T08:56:43.521Z","0.15.3-alpha.4":"2022-06-09T12:02:43.562Z","0.15.3-alpha.5":"2022-06-09T18:57:07.644Z","0.15.3-feat.1":"2022-06-10T08:29:02.140Z","0.15.3-feat.2":"2022-06-10T08:53:46.859Z","0.15.3-alpha.6":"2022-06-12T17:08:13.614Z","0.15.3-alpha.7":"2022-06-12T17:23:02.228Z","0.15.3-alpha.8":"2022-06-13T08:49:27.830Z","0.15.3-alpha.9":"2022-06-13T09:23:54.884Z","0.15.3-alpha.10":"2022-06-13T10:09:11.071Z","0.15.3-alpha.11":"2022-06-13T18:11:03.154Z","0.15.3-alpha.12":"2022-06-13T20:03:06.098Z","0.15.3-alpha.13":"2022-06-14T16:22:24.086Z","0.15.3-alpha.14":"2022-06-14T19:21:15.535Z","0.15.3-alpha.15":"2022-06-15T12:42:29.880Z","0.15.3-alpha.16":"2022-06-15T16:55:08.162Z","0.15.3-alpha.17":"2022-06-16T19:57:30.696Z","0.16.0":"2022-06-20T10:46:54.482Z","0.15.3-alpha.18":"2022-06-22T07:27:43.965Z","0.16.1-alpha.0":"2022-06-27T19:09:41.054Z","0.16.1-alpha.1":"2022-06-27T19:39:35.845Z","0.16.1-alpha.2":"2022-06-28T20:27:32.637Z","0.16.1-alpha.3":"2022-06-29T12:15:43.148Z","0.17.0-alpha.0":"2022-07-03T20:50:33.702Z","0.17.0-alpha.1":"2022-07-04T18:35:41.196Z","0.17.0-alpha.2":"2022-07-06T09:55:18.504Z","0.17.0-alpha.3":"2022-07-11T21:50:06.969Z","0.16.1-alpha.4":"2022-07-12T08:40:41.211Z","0.16.1-alpha.5":"2022-07-12T09:18:22.029Z","0.16.1-rnmq-upgrade":"2022-07-12T09:31:10.793Z","0.16.1-rnmq-upgrade.1":"2022-07-12T09:37:44.515Z","0.16.1-rnmq-upgrade.3":"2022-07-12T09:50:43.974Z","0.17.0-alpha.4":"2022-07-12T20:09:42.194Z","0.17.0-alpha.5":"2022-07-18T19:31:33.703Z","0.17.0-alpha.6":"2022-07-20T20:52:25.910Z","0.17.0-alpha.7":"2022-07-20T21:00:04.142Z","0.17.0-alpha.8":"2022-08-07T06:37:17.574Z","0.17.0":"2022-08-22T06:17:06.671Z","0.18.0-alpha.0":"2022-08-22T06:28:23.271Z","0.18.0-alpha.1":"2022-08-22T06:54:29.824Z","0.18.0-alpha.2":"2022-08-24T20:05:26.676Z","0.18.0-alpha.3":"2022-08-26T06:36:42.097Z","0.18.0-alpha.4":"2022-09-02T14:12:40.676Z","0.18.0-alpha.5":"2022-09-12T17:45:26.163Z","0.18.0-alpha.6":"2022-09-12T17:58:33.005Z","0.18.0-alpha.7":"2022-09-12T19:19:15.379Z","0.17.0-alpha.9":"2022-09-14T06:53:45.392Z","0.18.0-alpha.8":"2022-09-14T07:21:23.615Z","0.17.0-alpha.10":"2022-09-14T08:30:17.455Z","0.18.0-alpha.9":"2022-11-02T14:25:39.118Z","0.18.0-alpha.10":"2022-11-09T10:27:53.236Z","0.20.0-alpha.0":"2023-02-19T11:16:11.725Z","0.20.0-alpha.1":"2023-02-19T16:49:32.934Z","0.20.0-alpha.2":"2023-02-19T19:25:54.621Z","0.20.0-alpha.3":"2023-02-20T20:22:55.658Z","0.20.0-alpha.4":"2023-02-20T20:34:51.141Z","0.20.0-alpha.5":"2023-02-20T20:39:57.763Z","0.20.0-alpha.6":"2023-03-14T17:43:15.696Z","0.20.0-alpha.7":"2023-03-16T17:17:27.719Z","0.20.0-alpha.8":"2023-03-16T17:22:39.370Z","0.20.0-alpha.9":"2023-03-16T18:01:28.714Z","0.20.0-alpha.10":"2023-03-20T09:55:22.354Z","0.20.0-alpha.11":"2023-03-20T10:15:40.855Z","0.20.0-alpha.12":"2023-03-20T13:02:06.542Z","0.20.0-alpha.13":"2023-03-20T13:16:54.109Z","0.20.0-alpha.14":"2023-03-25T09:22:06.990Z","0.20.0-alpha.15":"2023-03-25T10:06:50.487Z","0.20.0-alpha.16":"2023-03-29T15:39:09.823Z","0.20.0-alpha.17":"2023-04-11T12:24:05.229Z","0.20.0-alpha.18":"2023-04-11T14:28:19.950Z","0.20.0-alpha.19":"2023-04-24T10:10:29.227Z","0.20.0-alpha.20":"2023-05-07T17:02:37.645Z","0.20.0-alpha.21":"2023-05-08T06:59:40.703Z","0.20.0-alpha.25":"2023-05-08T08:45:59.817Z","0.21.0-alpha.0":"2023-05-10T09:53:49.435Z","0.21.1-alpha.0":"2023-05-15T03:03:55.058Z","0.21.1-alpha.1":"2023-05-19T11:16:39.303Z","0.21.1-alpha.2":"2023-05-22T16:16:32.063Z","0.21.1-alpha.3":"2023-05-23T09:34:24.244Z","0.21.1-alpha.4":"2023-05-26T08:34:25.125Z","0.21.1-alpha.5":"2023-05-26T18:39:35.058Z","0.21.1-alpha.6":"2023-05-27T11:00:39.813Z","0.21.1-alpha.7":"2023-05-27T12:50:30.602Z","0.21.1-alpha.8":"2023-05-29T06:12:10.134Z","0.21.1-alpha.9":"2023-05-29T18:41:39.898Z","0.21.2-alpha.0":"2023-05-30T10:34:53.466Z","0.21.2-alpha.1":"2023-05-30T16:56:54.647Z","0.21.2-alpha.2":"2023-05-30T20:29:05.334Z","0.21.1-feat.0":"2023-05-31T18:48:00.149Z","0.21.1-feat.1":"2023-05-31T19:00:23.603Z","0.21.1-feat.2":"2023-05-31T19:29:22.317Z","0.21.1-feat.3":"2023-05-31T19:48:44.639Z","0.21.2-alpha.4":"2023-06-01T17:25:55.100Z","0.21.2-alpha.5":"2023-06-01T17:52:10.220Z","0.21.2-alpha.6":"2023-06-01T18:36:08.009Z","0.21.2-alpha.7":"2023-06-01T19:10:34.327Z","0.21.2-alpha.8":"2023-06-02T04:54:14.461Z","0.21.2-alpha.9":"2023-06-03T16:39:48.856Z","0.21.2-alpha.10":"2023-06-03T19:49:06.109Z","0.21.2-alpha.11":"2023-06-05T07:46:34.194Z","0.21.2-alpha.12":"2023-06-05T20:05:38.629Z","0.21.2-alpha.13":"2023-06-05T20:46:33.936Z","0.21.2-alpha.15":"2023-06-07T19:37:43.044Z","0.21.2-feat.0":"2023-06-08T10:04:37.135Z","0.21.2-feat.1":"2023-06-08T23:45:15.481Z","0.21.2-alpha.16":"2023-06-09T11:16:31.045Z","0.21.2-feat.2":"2023-06-09T11:24:46.696Z","0.21.2-feat.3":"2023-06-22T09:18:41.175Z","0.21.2-feat.4":"2023-06-26T13:39:08.666Z","0.21.0":"2023-06-27T11:07:35.812Z","0.21.1":"2023-06-28T08:40:53.994Z","0.21.2-feat.5":"2023-07-24T11:35:37.818Z","0.21.2-feat.6":"2023-08-22T12:58:03.098Z","0.21.2-feat.7":"2023-08-23T08:12:07.338Z","0.21.2-feat.8":"2023-08-24T07:21:40.633Z","1.0.0":"2023-08-24T07:39:57.021Z","1.0.0-feat.0":"2023-09-05T11:03:08.284Z","1.0.0-feat.1":"2023-09-18T11:22:11.740Z","1.0.0-feat.2":"2023-09-19T06:22:37.524Z","1.0.0-feat.3":"2023-09-19T15:19:25.022Z","1.0.0-feat.4":"2023-09-21T08:04:34.787Z","1.0.0-feat.5":"2023-11-27T12:05:16.476Z","1.0.0-feat.6":"2023-12-05T22:23:19.577Z","1.0.0-feat.7":"2023-12-05T23:34:17.126Z","1.0.0-feat.8":"2023-12-05T23:43:42.821Z","1.0.0-feat.9":"2023-12-05T23:54:48.368Z","1.0.0-feat.10":"2023-12-08T09:01:40.149Z","1.0.0-feat.11":"2023-12-08T09:21:53.035Z","1.0.0-feat.12":"2023-12-08T13:24:51.355Z"},"maintainers":[{"name":"pavjacko","email":"beherithrone@gmail.com"}],"description":"Flexn Graybox Tester","homepage":"https://github.com/flexn-io/graybox#readme","keywords":[],"repository":{"directory":"packages/graybox","type":"git","url":"git+https://github.com/flexn-io/graybox.git"},"author":{"name":"Flexn BV"},"bugs":{"url":"https://github.com/flexn-io/graybox/issues"},"license":"MIT","readme":"","readmeFilename":""}