npm - @serenity-js/protractor - Versions diffs - 2.32.3 → 3.0.0-rc.1 - Mend

@serenity-js/protractor 2.32.3 → 3.0.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (333) hide show

package/CHANGELOG.md +72 -0
package/lib/index.d.ts +0 -2
package/lib/index.js +0 -2
package/lib/index.js.map +1 -1
package/lib/screenplay/abilities/{BrowseTheWeb.d.ts → BrowseTheWebWithProtractor.d.ts} +52 -160
package/lib/screenplay/abilities/{BrowseTheWeb.js → BrowseTheWebWithProtractor.js} +169 -218
package/lib/screenplay/abilities/BrowseTheWebWithProtractor.js.map +1 -0
package/lib/screenplay/abilities/index.d.ts +1 -1
package/lib/screenplay/abilities/index.js +1 -1
package/lib/screenplay/abilities/index.js.map +1 -1
package/lib/screenplay/index.d.ts +1 -0
package/lib/screenplay/index.js +1 -0
package/lib/screenplay/index.js.map +1 -1
package/lib/screenplay/interactions/UseAngular.js +2 -2
package/lib/screenplay/interactions/UseAngular.js.map +1 -1
package/lib/screenplay/interactions/index.d.ts +0 -19
package/lib/screenplay/interactions/index.js +0 -19
package/lib/screenplay/interactions/index.js.map +1 -1
package/lib/screenplay/models/ProtractorCookie.d.ts +11 -0
package/lib/screenplay/models/ProtractorCookie.js +39 -0
package/lib/screenplay/models/ProtractorCookie.js.map +1 -0
package/lib/screenplay/models/ProtractorModalDialog.d.ts +11 -0
package/lib/screenplay/models/ProtractorModalDialog.js +43 -0
package/lib/screenplay/models/ProtractorModalDialog.js.map +1 -0
package/lib/screenplay/models/ProtractorNativeElementRoot.d.ts +5 -0
package/lib/screenplay/{interactions/EnterBuilder.js → models/ProtractorNativeElementRoot.js} +1 -1
package/lib/screenplay/models/ProtractorNativeElementRoot.js.map +1 -0
package/lib/screenplay/models/ProtractorPage.d.ts +24 -0
package/lib/screenplay/models/ProtractorPage.js +92 -0
package/lib/screenplay/models/ProtractorPage.js.map +1 -0
package/lib/screenplay/models/ProtractorPageElement.d.ts +23 -0
package/lib/screenplay/models/ProtractorPageElement.js +112 -0
package/lib/screenplay/models/ProtractorPageElement.js.map +1 -0
package/lib/screenplay/models/ProtractorPageElements.d.ts +16 -0
package/lib/screenplay/models/ProtractorPageElements.js +62 -0
package/lib/screenplay/models/ProtractorPageElements.js.map +1 -0
package/lib/screenplay/models/index.d.ts +6 -0
package/lib/{expectations → screenplay/models}/index.js +6 -6
package/lib/screenplay/models/index.js.map +1 -0
package/lib/{promiseOf.d.ts → screenplay/promised.d.ts} +1 -1
package/lib/{promiseOf.js → screenplay/promised.js} +4 -4
package/lib/screenplay/promised.js.map +1 -0
package/lib/screenplay/promisedWebElement.d.ts +11 -0
package/lib/screenplay/promisedWebElement.js +27 -0
package/lib/screenplay/promisedWebElement.js.map +1 -0
package/lib/screenplay/questions/ProtractorParam.d.ts +24 -29
package/lib/screenplay/questions/ProtractorParam.js +26 -33
package/lib/screenplay/questions/ProtractorParam.js.map +1 -1
package/lib/screenplay/questions/index.d.ts +0 -13
package/lib/screenplay/questions/index.js +0 -16
package/lib/screenplay/questions/index.js.map +1 -1
package/package.json +21 -23
package/src/index.ts +0 -2
package/src/screenplay/abilities/{BrowseTheWeb.ts → BrowseTheWebWithProtractor.ts} +216 -241
package/src/screenplay/abilities/index.ts +1 -1
package/src/screenplay/index.ts +1 -0
package/src/screenplay/interactions/UseAngular.ts +3 -3
package/src/screenplay/interactions/index.ts +0 -19
package/src/screenplay/models/ProtractorCookie.ts +41 -0
package/src/screenplay/models/ProtractorModalDialog.ts +49 -0
package/src/screenplay/models/ProtractorNativeElementRoot.ts +6 -0
package/src/screenplay/models/ProtractorPage.ts +116 -0
package/src/screenplay/models/ProtractorPageElement.ts +167 -0
package/src/screenplay/models/ProtractorPageElements.ts +86 -0
package/src/screenplay/models/index.ts +7 -0
package/src/{promiseOf.ts → screenplay/promised.ts} +1 -1
package/src/screenplay/promisedWebElement.ts +28 -0
package/src/screenplay/questions/ProtractorParam.ts +29 -38
package/src/screenplay/questions/index.ts +0 -13
package/lib/expectations/ElementFinderExpectation.d.ts +0 -11
package/lib/expectations/ElementFinderExpectation.js +0 -24
package/lib/expectations/ElementFinderExpectation.js.map +0 -1
package/lib/expectations/index.d.ts +0 -6
package/lib/expectations/index.js.map +0 -1
package/lib/expectations/isActive.d.ts +0 -13
package/lib/expectations/isActive.js +0 -19
package/lib/expectations/isActive.js.map +0 -1
package/lib/expectations/isClickable.d.ts +0 -13
package/lib/expectations/isClickable.js +0 -22
package/lib/expectations/isClickable.js.map +0 -1
package/lib/expectations/isEnabled.d.ts +0 -13
package/lib/expectations/isEnabled.js +0 -19
package/lib/expectations/isEnabled.js.map +0 -1
package/lib/expectations/isPresent.d.ts +0 -14
package/lib/expectations/isPresent.js +0 -20
package/lib/expectations/isPresent.js.map +0 -1
package/lib/expectations/isSelected.d.ts +0 -13
package/lib/expectations/isSelected.js +0 -22
package/lib/expectations/isSelected.js.map +0 -1
package/lib/expectations/isVisible.d.ts +0 -13
package/lib/expectations/isVisible.js +0 -25
package/lib/expectations/isVisible.js.map +0 -1
package/lib/promiseOf.js.map +0 -1
package/lib/screenplay/abilities/BrowseTheWeb.js.map +0 -1
package/lib/screenplay/interactions/Accept.d.ts +0 -81
package/lib/screenplay/interactions/Accept.js +0 -95
package/lib/screenplay/interactions/Accept.js.map +0 -1
package/lib/screenplay/interactions/Clear.d.ts +0 -88
package/lib/screenplay/interactions/Clear.js +0 -121
package/lib/screenplay/interactions/Clear.js.map +0 -1
package/lib/screenplay/interactions/Click.d.ts +0 -81
package/lib/screenplay/interactions/Click.js +0 -95
package/lib/screenplay/interactions/Click.js.map +0 -1
package/lib/screenplay/interactions/Close.d.ts +0 -89
package/lib/screenplay/interactions/Close.js +0 -169
package/lib/screenplay/interactions/Close.js.map +0 -1
package/lib/screenplay/interactions/DeleteCookies.d.ts +0 -72
package/lib/screenplay/interactions/DeleteCookies.js +0 -149
package/lib/screenplay/interactions/DeleteCookies.js.map +0 -1
package/lib/screenplay/interactions/Dismiss.d.ts +0 -85
package/lib/screenplay/interactions/Dismiss.js +0 -99
package/lib/screenplay/interactions/Dismiss.js.map +0 -1
package/lib/screenplay/interactions/DoubleClick.d.ts +0 -99
package/lib/screenplay/interactions/DoubleClick.js +0 -121
package/lib/screenplay/interactions/DoubleClick.js.map +0 -1
package/lib/screenplay/interactions/Enter.d.ts +0 -81
package/lib/screenplay/interactions/Enter.js +0 -96
package/lib/screenplay/interactions/Enter.js.map +0 -1
package/lib/screenplay/interactions/EnterBuilder.d.ts +0 -27
package/lib/screenplay/interactions/EnterBuilder.js.map +0 -1
package/lib/screenplay/interactions/ExecuteScript.d.ts +0 -171
package/lib/screenplay/interactions/ExecuteScript.js +0 -291
package/lib/screenplay/interactions/ExecuteScript.js.map +0 -1
package/lib/screenplay/interactions/Hover.d.ts +0 -86
package/lib/screenplay/interactions/Hover.js +0 -103
package/lib/screenplay/interactions/Hover.js.map +0 -1
package/lib/screenplay/interactions/Navigate.d.ts +0 -149
package/lib/screenplay/interactions/Navigate.js +0 -345
package/lib/screenplay/interactions/Navigate.js.map +0 -1
package/lib/screenplay/interactions/Press.d.ts +0 -90
package/lib/screenplay/interactions/Press.js +0 -127
package/lib/screenplay/interactions/Press.js.map +0 -1
package/lib/screenplay/interactions/PressBuilder.d.ts +0 -27
package/lib/screenplay/interactions/PressBuilder.js +0 -3
package/lib/screenplay/interactions/PressBuilder.js.map +0 -1
package/lib/screenplay/interactions/ResizeBrowserWindow.d.ts +0 -69
package/lib/screenplay/interactions/ResizeBrowserWindow.js +0 -144
package/lib/screenplay/interactions/ResizeBrowserWindow.js.map +0 -1
package/lib/screenplay/interactions/RightClick.d.ts +0 -97
package/lib/screenplay/interactions/RightClick.js +0 -113
package/lib/screenplay/interactions/RightClick.js.map +0 -1
package/lib/screenplay/interactions/Scroll.d.ts +0 -83
package/lib/screenplay/interactions/Scroll.js +0 -98
package/lib/screenplay/interactions/Scroll.js.map +0 -1
package/lib/screenplay/interactions/Select.d.ts +0 -212
package/lib/screenplay/interactions/Select.js +0 -342
package/lib/screenplay/interactions/Select.js.map +0 -1
package/lib/screenplay/interactions/SelectBuilder.d.ts +0 -33
package/lib/screenplay/interactions/SelectBuilder.js +0 -3
package/lib/screenplay/interactions/SelectBuilder.js.map +0 -1
package/lib/screenplay/interactions/Switch.d.ts +0 -210
package/lib/screenplay/interactions/Switch.js +0 -345
package/lib/screenplay/interactions/Switch.js.map +0 -1
package/lib/screenplay/interactions/TakeScreenshot.d.ts +0 -67
package/lib/screenplay/interactions/TakeScreenshot.js +0 -86
package/lib/screenplay/interactions/TakeScreenshot.js.map +0 -1
package/lib/screenplay/interactions/Wait.d.ts +0 -147
package/lib/screenplay/interactions/Wait.js +0 -247
package/lib/screenplay/interactions/Wait.js.map +0 -1
package/lib/screenplay/interactions/WaitBuilder.d.ts +0 -33
package/lib/screenplay/interactions/WaitBuilder.js +0 -3
package/lib/screenplay/interactions/WaitBuilder.js.map +0 -1
package/lib/screenplay/questions/Attribute.d.ts +0 -29
package/lib/screenplay/questions/Attribute.js +0 -56
package/lib/screenplay/questions/Attribute.js.map +0 -1
package/lib/screenplay/questions/Browser.d.ts +0 -47
package/lib/screenplay/questions/Browser.js +0 -55
package/lib/screenplay/questions/Browser.js.map +0 -1
package/lib/screenplay/questions/CSSClasses.d.ts +0 -94
package/lib/screenplay/questions/CSSClasses.js +0 -118
package/lib/screenplay/questions/CSSClasses.js.map +0 -1
package/lib/screenplay/questions/Cookie.d.ts +0 -9
package/lib/screenplay/questions/Cookie.js +0 -65
package/lib/screenplay/questions/Cookie.js.map +0 -1
package/lib/screenplay/questions/LastScriptExecution.d.ts +0 -14
package/lib/screenplay/questions/LastScriptExecution.js +0 -22
package/lib/screenplay/questions/LastScriptExecution.js.map +0 -1
package/lib/screenplay/questions/ModalDialog.d.ts +0 -120
package/lib/screenplay/questions/ModalDialog.js +0 -142
package/lib/screenplay/questions/ModalDialog.js.map +0 -1
package/lib/screenplay/questions/Pick.d.ts +0 -72
package/lib/screenplay/questions/Pick.js +0 -254
package/lib/screenplay/questions/Pick.js.map +0 -1
package/lib/screenplay/questions/Selected.d.ts +0 -185
package/lib/screenplay/questions/Selected.js +0 -254
package/lib/screenplay/questions/Selected.js.map +0 -1
package/lib/screenplay/questions/Value.d.ts +0 -47
package/lib/screenplay/questions/Value.js +0 -67
package/lib/screenplay/questions/Value.js.map +0 -1
package/lib/screenplay/questions/Website.d.ts +0 -15
package/lib/screenplay/questions/Website.js +0 -25
package/lib/screenplay/questions/Website.js.map +0 -1
package/lib/screenplay/questions/Window.d.ts +0 -23
package/lib/screenplay/questions/Window.js +0 -28
package/lib/screenplay/questions/Window.js.map +0 -1
package/lib/screenplay/questions/lists/ElementArrayFinderListAdapter.d.ts +0 -89
package/lib/screenplay/questions/lists/ElementArrayFinderListAdapter.js +0 -138
package/lib/screenplay/questions/lists/ElementArrayFinderListAdapter.js.map +0 -1
package/lib/screenplay/questions/lists/index.d.ts +0 -1
package/lib/screenplay/questions/lists/index.js +0 -14
package/lib/screenplay/questions/lists/index.js.map +0 -1
package/lib/screenplay/questions/targets/Target.d.ts +0 -168
package/lib/screenplay/questions/targets/Target.js +0 -190
package/lib/screenplay/questions/targets/Target.js.map +0 -1
package/lib/screenplay/questions/targets/TargetElement.d.ts +0 -50
package/lib/screenplay/questions/targets/TargetElement.js +0 -62
package/lib/screenplay/questions/targets/TargetElement.js.map +0 -1
package/lib/screenplay/questions/targets/TargetElements.d.ts +0 -102
package/lib/screenplay/questions/targets/TargetElements.js +0 -124
package/lib/screenplay/questions/targets/TargetElements.js.map +0 -1
package/lib/screenplay/questions/targets/TargetNestedElement.d.ts +0 -49
package/lib/screenplay/questions/targets/TargetNestedElement.js +0 -61
package/lib/screenplay/questions/targets/TargetNestedElement.js.map +0 -1
package/lib/screenplay/questions/targets/TargetNestedElements.d.ts +0 -101
package/lib/screenplay/questions/targets/TargetNestedElements.js +0 -123
package/lib/screenplay/questions/targets/TargetNestedElements.js.map +0 -1
package/lib/screenplay/questions/targets/builders.d.ts +0 -8
package/lib/screenplay/questions/targets/builders.js +0 -3
package/lib/screenplay/questions/targets/builders.js.map +0 -1
package/lib/screenplay/questions/targets/index.d.ts +0 -5
package/lib/screenplay/questions/targets/index.js +0 -18
package/lib/screenplay/questions/targets/index.js.map +0 -1
package/lib/screenplay/questions/targets/override.d.ts +0 -7
package/lib/screenplay/questions/targets/override.js +0 -21
package/lib/screenplay/questions/targets/override.js.map +0 -1
package/lib/screenplay/questions/text/Text.d.ts +0 -41
package/lib/screenplay/questions/text/Text.js +0 -50
package/lib/screenplay/questions/text/Text.js.map +0 -1
package/lib/screenplay/questions/text/TextOfMultipleElements.d.ts +0 -23
package/lib/screenplay/questions/text/TextOfMultipleElements.js +0 -37
package/lib/screenplay/questions/text/TextOfMultipleElements.js.map +0 -1
package/lib/screenplay/questions/text/TextOfSingleElement.d.ts +0 -23
package/lib/screenplay/questions/text/TextOfSingleElement.js +0 -35
package/lib/screenplay/questions/text/TextOfSingleElement.js.map +0 -1
package/lib/screenplay/questions/text/index.d.ts +0 -1
package/lib/screenplay/questions/text/index.js +0 -14
package/lib/screenplay/questions/text/index.js.map +0 -1
package/lib/screenplay/withAnswerOf.d.ts +0 -8
package/lib/screenplay/withAnswerOf.js +0 -18
package/lib/screenplay/withAnswerOf.js.map +0 -1
package/lib/stage/crew/index.d.ts +0 -1
package/lib/stage/crew/index.js +0 -14
package/lib/stage/crew/index.js.map +0 -1
package/lib/stage/crew/photographer/Photographer.d.ts +0 -83
package/lib/stage/crew/photographer/Photographer.js +0 -102
package/lib/stage/crew/photographer/Photographer.js.map +0 -1
package/lib/stage/crew/photographer/index.d.ts +0 -2
package/lib/stage/crew/photographer/index.js +0 -15
package/lib/stage/crew/photographer/index.js.map +0 -1
package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.d.ts +0 -28
package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.js +0 -65
package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.js.map +0 -1
package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.d.ts +0 -18
package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js +0 -30
package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js.map +0 -1
package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.d.ts +0 -17
package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.js +0 -28
package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.js.map +0 -1
package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.d.ts +0 -19
package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.js +0 -28
package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.js.map +0 -1
package/lib/stage/crew/photographer/strategies/index.d.ts +0 -4
package/lib/stage/crew/photographer/strategies/index.js +0 -17
package/lib/stage/crew/photographer/strategies/index.js.map +0 -1
package/lib/stage/index.d.ts +0 -1
package/lib/stage/index.js +0 -14
package/lib/stage/index.js.map +0 -1
package/src/expectations/ElementFinderExpectation.ts +0 -29
package/src/expectations/index.ts +0 -6
package/src/expectations/isActive.ts +0 -24
package/src/expectations/isClickable.ts +0 -20
package/src/expectations/isEnabled.ts +0 -18
package/src/expectations/isPresent.ts +0 -19
package/src/expectations/isSelected.ts +0 -23
package/src/expectations/isVisible.ts +0 -27
package/src/screenplay/interactions/Accept.ts +0 -95
package/src/screenplay/interactions/Clear.ts +0 -130
package/src/screenplay/interactions/Click.ts +0 -96
package/src/screenplay/interactions/Close.ts +0 -184
package/src/screenplay/interactions/DeleteCookies.ts +0 -154
package/src/screenplay/interactions/Dismiss.ts +0 -99
package/src/screenplay/interactions/DoubleClick.ts +0 -124
package/src/screenplay/interactions/Enter.ts +0 -104
package/src/screenplay/interactions/EnterBuilder.ts +0 -29
package/src/screenplay/interactions/ExecuteScript.ts +0 -325
package/src/screenplay/interactions/Hover.ts +0 -106
package/src/screenplay/interactions/Navigate.ts +0 -363
package/src/screenplay/interactions/Press.ts +0 -137
package/src/screenplay/interactions/PressBuilder.ts +0 -29
package/src/screenplay/interactions/ResizeBrowserWindow.ts +0 -148
package/src/screenplay/interactions/RightClick.ts +0 -114
package/src/screenplay/interactions/Scroll.ts +0 -99
package/src/screenplay/interactions/Select.ts +0 -402
package/src/screenplay/interactions/SelectBuilder.ts +0 -35
package/src/screenplay/interactions/Switch.ts +0 -393
package/src/screenplay/interactions/TakeScreenshot.ts +0 -89
package/src/screenplay/interactions/Wait.ts +0 -267
package/src/screenplay/interactions/WaitBuilder.ts +0 -35
package/src/screenplay/questions/Attribute.ts +0 -67
package/src/screenplay/questions/Browser.ts +0 -55
package/src/screenplay/questions/CSSClasses.ts +0 -121
package/src/screenplay/questions/Cookie.ts +0 -70
package/src/screenplay/questions/LastScriptExecution.ts +0 -21
package/src/screenplay/questions/ModalDialog.ts +0 -149
package/src/screenplay/questions/Pick.ts +0 -334
package/src/screenplay/questions/Selected.ts +0 -268
package/src/screenplay/questions/Value.ts +0 -73
package/src/screenplay/questions/Website.ts +0 -27
package/src/screenplay/questions/Window.ts +0 -29
package/src/screenplay/questions/lists/ElementArrayFinderListAdapter.ts +0 -158
package/src/screenplay/questions/lists/index.ts +0 -1
package/src/screenplay/questions/targets/Target.ts +0 -198
package/src/screenplay/questions/targets/TargetElement.ts +0 -70
package/src/screenplay/questions/targets/TargetElements.ts +0 -142
package/src/screenplay/questions/targets/TargetNestedElement.ts +0 -71
package/src/screenplay/questions/targets/TargetNestedElements.ts +0 -142
package/src/screenplay/questions/targets/builders.ts +0 -10
package/src/screenplay/questions/targets/index.ts +0 -5
package/src/screenplay/questions/targets/override.ts +0 -17
package/src/screenplay/questions/text/Text.ts +0 -55
package/src/screenplay/questions/text/TextOfMultipleElements.ts +0 -40
package/src/screenplay/questions/text/TextOfSingleElement.ts +0 -37
package/src/screenplay/questions/text/index.ts +0 -1
package/src/screenplay/withAnswerOf.ts +0 -19
package/src/stage/crew/index.ts +0 -1
package/src/stage/crew/photographer/Photographer.ts +0 -108
package/src/stage/crew/photographer/index.ts +0 -2
package/src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts +0 -102
package/src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts +0 -28
package/src/stage/crew/photographer/strategies/TakePhotosOfFailures.ts +0 -26
package/src/stage/crew/photographer/strategies/TakePhotosOfInteractions.ts +0 -26
package/src/stage/crew/photographer/strategies/index.ts +0 -4
package/src/stage/index.ts +0 -1

package/src/screenplay/questions/targets/Target.ts DELETED Viewed

@@ -1,198 +0,0 @@
-import { Question } from '@serenity-js/core';
-import { ElementFinder, Locator } from 'protractor';
-import { NestedTargetBuilder, TargetBuilder } from './builders';
-import { TargetElement } from './TargetElement';
-import { TargetElements } from './TargetElements';
-import { TargetNestedElement } from './TargetNestedElement';
-import { TargetNestedElements } from './TargetNestedElements';
-/**
- * @desc
- *  Provides a convenient way to retrieve a single web element or multiple web elements,
- *  so that they can be used with Serenity/JS {@link @serenity-js/core/lib/screenplay~Interaction}s.
- *
- *  Check out the examples below, as well as the unit tests demonstrating the usage.
- *
- *  @example <caption>Imaginary website under test</caption>
- *   <body>
- *       <ul id="basket">
- *           <li><a href="#">Apple</a></li>
- *           <li><a href="#">Banana</a></li>
- *           <li><a href="#">Coconut</a></li>
- *           <li><a href="#" class="has-discount">Date</a></li>
- *       </ul>
- *       <div id="summary"><strong class="out-of-stock">Coconut</strong> is not available</div>
- *       <button type="submit">Proceed to Checkout</button>
- *   </body>
- *
- *  @example <caption>Locating a single element</caption>
- *   import { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const proceedToCheckoutButton =
- *       Target.the('Proceed to Checkout button').located(by.css(`button[type='submit']`));
- *
- *  @example <caption>Locating multiple elements</caption>
- *   import { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const basketItems =
- *       Target.all('items in the basket').located(by.css('ul#basket li'));
- *
- *  @example <caption>Locating element relative to another element</caption>
- *   import { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const summary =
- *       Target.the('summary').located(by.id('message'));
- *
- *   const outOfStockItem =
- *       Target.the('out of stock item').of(summary).located(by.css('.out-of-stock'))
- *
- *  @example <caption>Filtering elements matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by } from 'protractor';
- *
- *   const basketItems =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .where(Text, endsWith('e'));    // Apple, Date
- *
- *  @example <caption>Counting items matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { Question } from '@serenity-js/core';
- *   import { by } from 'protractor';
- *
- *   const basketItemsCount: Question<Promise<number>> =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .count()    // 4
- *
- *  @example <caption>Getting first item matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const apple: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .first()
- *
- *  @example <caption>Getting last item matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const date: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .last()
- *
- *  @example <caption>Getting nth item matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const banana: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .get(1)
- *
- *  @example <caption>Using multiple filters and nested targets</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { contain, endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   class Basket {
- *       static component = Target.the('basket').located(by.id('basket'));
- *
- *       static items     = Target.all('items').located(by.css('li'))
- *          .of(Basket.component);
- *
- *       static link      = Target.the('link').located(by.css('a'));
- *   }
- *
- *   const date: Question<ElementFinder>  =
- *       Basket.items
- *          .where(Text, endsWith('e'))
- *          .where(CSSClasses.of(Basket.link), contain('has-discount'))
- *          .first()
- *
- *  @example <caption>Clicking on an element</caption>
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Click } from '@serenity-js/protractor';
- *   import { protractor } from 'protractor';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.browser))
- *       .attemptsTo(
- *           Click.on(proceedToCheckoutButton),
- *       );
- *
- *  @example <caption>Retrieving text of multiple elements and performing an assertion</caption>
- *   import { Ensure, contain } from '@serenity-js/assertions';
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Click, Text } from '@serenity-js/protractor';
- *   import { protractor } from 'protractor';
- *
- *   const basketItemNames = Text.ofAll(basketItems);
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.browser))
- *       .attemptsTo(
- *           Ensure.that(basketItemNames, contain('Apple'))
- *       );
- *
- *  @example <caption>Waiting on an element</caption>
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Click, Text, Wait, isClickable } from '@serenity-js/protractor';
- *   import { protractor } from 'protractor';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.browser))
- *       .attemptsTo(
- *           Wait.until(proceedToCheckoutButton, isClickable()),
- *       );
- */
-export class Target  {
-    /**
-     * @desc
-     *  Locates a single web element
-     *
-     * @param {string} name - A human-readable name of the element to be used in the report
-     * @returns {TargetBuilder<TargetElement> & NestedTargetBuilder<TargetNestedElement>}
-     */
-    static the(name: string): TargetBuilder<TargetElement> & NestedTargetBuilder<TargetNestedElement> {
-        return {
-            located: (byLocator: Locator): TargetElement =>
-                new TargetElement(name, byLocator),
-            of: (parent: Question<ElementFinder> | ElementFinder) => {
-                return {
-                    located: (byLocator: Locator): TargetNestedElement =>
-                        new TargetNestedElement(parent, new TargetElement(name, byLocator)),
-                };
-            },
-        };
-    }
-    /**
-     * @desc
-     *  Locates a group of web elements
-     *
-     * @param {string} name - A human-readable name of the elements to be used in the report
-     * @returns {TargetBuilder<TargetElements> & NestedTargetBuilder<TargetNestedElements>}
-     */
-    static all(name: string): TargetBuilder<TargetElements> & NestedTargetBuilder<TargetNestedElements> {
-        return {
-            located: (byLocator: Locator): TargetElements =>
-                new TargetElements(name, byLocator),
-            of: (parent: Question<ElementFinder> | ElementFinder) => {
-                return {
-                    located: (byLocator: Locator): TargetNestedElements =>
-                        new TargetNestedElements(parent, new TargetElements(name, byLocator)),
-                };
-            },
-        };
-    }
-}

package/src/screenplay/questions/targets/TargetElement.ts DELETED Viewed

@@ -1,70 +0,0 @@
-import { AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder, Locator } from 'protractor';
-import { BrowseTheWeb } from '../../abilities';
-import { override } from './override';
-import { TargetNestedElement } from './TargetNestedElement';
-/**
- * @desc
- *  Locates a single {@link WebElement}.
- *
- *  Instead of using this class directly, please use {@link Target.the} instead.
- *
- * @public
- * @see {@link Target}
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-export class TargetElement
-    extends Question<ElementFinder>
-    implements MetaQuestion<Question<ElementFinder> | ElementFinder, ElementFinder>
-{
-    /**
-     * @desc
-     *
-     * @param {string} description - A human-readable description to be used in the report
-     * @param {protractor~Locator} locator - A locator to be used when locating the element
-     */
-    constructor(
-        protected readonly description: string,
-        protected readonly locator: Locator,
-    ) {
-        super(`the ${ description }`);
-    }
-    /**
-     * @desc
-     *  Retrieves a {@link WebElement} located by `locator`,
-     *  resolved in the context of a `parent` {@link WebElement}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {TargetNestedElement}
-     *
-     * @see {@link Target}
-     */
-    of(parent: Question<ElementFinder> | ElementFinder): TargetNestedElement {
-        return new TargetNestedElement(parent, this);
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): ElementFinder {
-        return override(
-            BrowseTheWeb.as(actor).locate(this.locator),
-            'toString',
-            TargetElement.prototype.toString.bind(this),
-        );
-    }
-}

package/src/screenplay/questions/targets/TargetElements.ts DELETED Viewed

@@ -1,142 +0,0 @@
-import { AnswersQuestions, Expectation, List, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementArrayFinder, ElementFinder, Locator } from 'protractor';
-import { BrowseTheWeb } from '../../abilities';
-import { ElementArrayFinderListAdapter } from '../lists';
-import { override } from './override';
-import { TargetNestedElements } from './TargetNestedElements';
-/**
- * @desc
- *  Locates a group of {@link WebElement}s.
- *
- *  Instead of using this class directly, please use {@link Target.all} instead.
- *
- * @public
- * @see {@link Target}
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-export class TargetElements
-    extends Question<ElementArrayFinder>
-    implements MetaQuestion<Question<ElementFinder> | ElementFinder, ElementArrayFinder>
-{
-    private readonly list: List<ElementArrayFinderListAdapter, ElementFinder, ElementArrayFinder>;
-    /**
-     * @desc
-     *
-     * @param {string} description - A human-readable description to be used in the report
-     * @param {protractor~Locator} locator - A locator to be used when locating the element
-     */
-    constructor(
-        private readonly description: string,
-        private readonly locator: Locator,
-    ) {
-        super(`the ${ description }`);
-        this.list = new List(new ElementArrayFinderListAdapter(this));
-    }
-    /**
-     * @desc
-     *  Retrieves a group of {@link WebElement}s located by `locator`,
-     *  resolved in the context of a `parent` {@link WebElement}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {TargetNestedElements}
-     *
-     * @see {@link Target}
-     */
-    of(parent: Question<ElementFinder> | ElementFinder): TargetNestedElements {
-        return new TargetNestedElements(parent, this);
-    }
-    /**
-     * @desc
-     *  Returns the number of {@link ElementFinder}s matched by the `locator`
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<number>>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    count(): Question<Promise<number>> {
-        return this.list.count();
-    }
-    /**
-     * @desc
-     *  Returns the first of {@link ElementFinder}s matched by the `locator`
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<ElementFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    first(): Question<ElementFinder> {
-        return this.list.first()
-    }
-    /**
-     * @desc
-     *  Returns the last of {@link ElementFinder}s matched by the `locator`
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<ElementFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    last(): Question<ElementFinder> {
-        return this.list.last()
-    }
-    /**
-     * @desc
-     *  Returns an {@link ElementFinder} at `index` for `locator`
-     *
-     * @param {number} index
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<ElementFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    get(index: number): Question<ElementFinder> {
-        return this.list.get(index);
-    }
-    /**
-     * @desc
-     *  Filters the list of {@link ElementFinder}s matched by `locator` to those that meet the additional {@link @serenity-js/core/lib/screenplay/questions~Expectation}s.
-     *
-     * @param {@serenity-js/core/lib/screenplay/questions~MetaQuestion<ElementFinder, Promise<Answer_Type> | Answer_Type>} question
-     * @param {@serenity-js/core/lib/screenplay/questions~Expectation<any, Answer_type>} expectation
-     *
-     * @returns {@serenity-js/core/lib/screenplay/questions~List<ElementArrayFinderListAdapter, ElementFinder, ElementArrayFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    where<Answer_Type>(
-        question: MetaQuestion<ElementFinder, Promise<Answer_Type> | Answer_Type>,
-        expectation: Expectation<any, Answer_Type>,
-    ): List<ElementArrayFinderListAdapter, ElementFinder, ElementArrayFinder> {
-        return this.list.where(question, expectation);
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): ElementArrayFinder {
-        return override(
-            BrowseTheWeb.as(actor).locateAll(this.locator),
-            'toString',
-            TargetElements.prototype.toString.bind(this),
-        );
-    }
-}

package/src/screenplay/questions/targets/TargetNestedElement.ts DELETED Viewed

@@ -1,71 +0,0 @@
-import { AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-import { withAnswerOf } from '../../withAnswerOf';
-import { override } from './override';
-/**
- * @desc
- *  Locates a single {@link WebElement} located within another {@link WebElement}.
- *
- *  Instead of using this class directly, please use {@link Target.the} and {@link TargetElement#of} instead.
- *
- * @public
- * @see {@link Target}
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-export class TargetNestedElement
-    extends Question<ElementFinder>
-    implements MetaQuestion<Question<ElementFinder> | ElementFinder, ElementFinder>
-{
-    /**
-     * @desc
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @param {Question<ElementFinder> | ElementFinder} child
-     */
-    constructor(
-        private readonly parent: Question<ElementFinder> | ElementFinder,
-        private readonly child: Question<ElementFinder> | ElementFinder,
-    ) {
-        super(`${ child.toString() } of ${ parent }`);
-    }
-    /**
-     * @desc
-     *  Retrieves a {@link WebElement} located by `locator`,
-     *  resolved in the context of a `parent` {@link WebElement}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {TargetNestedElement}
-     *
-     * @see {@link Target}
-     */
-    of(parent: Question<ElementFinder> | ElementFinder): TargetNestedElement {
-        return new TargetNestedElement(parent, this);
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): ElementFinder {
-        return withAnswerOf<ElementFinder, ElementFinder>(actor, this.parent, parent =>
-            withAnswerOf<ElementFinder, ElementFinder>(actor, this.child, child => override(
-                parent.element(child.locator()),
-                'toString',
-                TargetNestedElement.prototype.toString.bind(this),
-            )));
-    }
-}

package/src/screenplay/questions/targets/TargetNestedElements.ts DELETED Viewed

@@ -1,142 +0,0 @@
-import { AnswersQuestions, Expectation, List, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementArrayFinder, ElementFinder } from 'protractor';
-import { withAnswerOf } from '../../withAnswerOf';
-import { ElementArrayFinderListAdapter } from '../lists';
-import { override } from './override';
-/**
- * @desc
- *  Locates a group of {@link WebElement}s located within another {@link WebElement}.
- *
- *  Instead of using this class directly, please use {@link Target.all} and {@link TargetElements#of} instead.
- *
- * @public
- * @see {@link Target}
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-export class TargetNestedElements
-    extends Question<ElementArrayFinder>
-    implements MetaQuestion<Question<ElementFinder> | ElementFinder, ElementArrayFinder>
-{
-    private readonly list: List<ElementArrayFinderListAdapter, ElementFinder, ElementArrayFinder>;
-    /**
-     * @desc
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @param {Question<ElementArrayFinder> | ElementArrayFinder} children
-     */
-    constructor(
-        private readonly parent: Question<ElementFinder> | ElementFinder,
-        private readonly children: Question<ElementArrayFinder> | ElementArrayFinder,
-    ) {
-        super(`${ children.toString() } of ${ parent }`);
-        this.list = new List(new ElementArrayFinderListAdapter(this));
-    }
-    /**
-     * @desc
-     *  Retrieves a group of {@link WebElement}s located by `locator`,
-     *  resolved in the context of a `parent` {@link WebElement}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {TargetNestedElements}
-     *
-     * @see {@link Target}
-     */
-    of(parent: Question<ElementFinder> | ElementFinder): TargetNestedElements {
-        return new TargetNestedElements(parent, this);
-    }
-    /**
-     * @desc
-     *  Returns the number of {@link ElementFinder}s matched by the `locator`
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<number>>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    count(): Question<Promise<number>> {
-        return this.list.count();
-    }
-    /**
-     * @desc
-     *  Returns the first of {@link ElementFinder}s matched by the `locator`
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<ElementFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    first(): Question<ElementFinder> {
-        return this.list.first()
-    }
-    /**
-     * @desc
-     *  Returns the last of {@link ElementFinder}s matched by the `locator`
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<ElementFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    last(): Question<ElementFinder> {
-        return this.list.last()
-    }
-    /**
-     * @desc
-     *  Returns an {@link ElementFinder} at `index` for `locator`
-     *
-     * @param {number} index
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<ElementFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    get(index: number): Question<ElementFinder> {
-        return this.list.get(index);
-    }
-    /**
-     * @desc
-     *  Filters the list of {@link ElementFinder}s matched by `locator` to those that meet the additional {@link @serenity-js/core/lib/screenplay/questions~Expectation}s.
-     *
-     * @param {@serenity-js/core/lib/screenplay/questions~MetaQuestion<ElementFinder, Promise<Answer_Type> | Answer_Type>} question
-     * @param {@serenity-js/core/lib/screenplay/questions~Expectation<any, Answer_type>} expectation
-     *
-     * @returns {@serenity-js/core/lib/screenplay/questions~List<ElementArrayFinderListAdapter, ElementFinder, ElementArrayFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~List}
-     */
-    where<Answer_Type>(
-        question: MetaQuestion<ElementFinder, Promise<Answer_Type> | Answer_Type>,
-        expectation: Expectation<any, Answer_Type>,
-    ): List<ElementArrayFinderListAdapter, ElementFinder, ElementArrayFinder> {
-        return this.list.where(question, expectation);
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): ElementArrayFinder {
-        return withAnswerOf<ElementFinder, ElementArrayFinder>(actor, this.parent, parent =>
-            withAnswerOf<ElementArrayFinder, ElementArrayFinder>(actor, this.children, children => override(
-                parent.all(children.locator()),
-                'toString',
-                TargetNestedElements.prototype.toString.bind(this),
-            )));
-    }
-}

package/src/screenplay/questions/targets/builders.ts DELETED Viewed

@@ -1,10 +0,0 @@
-import { Question } from '@serenity-js/core';
-import { ElementFinder, Locator } from 'protractor';
-export interface TargetBuilder<T> {
-    located(byLocator: Locator): T;
-}
-export interface NestedTargetBuilder<T> {
-    of(parent: Question<ElementFinder> | ElementFinder): TargetBuilder<T>;
-}

package/src/screenplay/questions/targets/index.ts DELETED Viewed

@@ -1,5 +0,0 @@
-export * from './Target';
-export * from './TargetElement';
-export * from './TargetElements';
-export * from './TargetNestedElement';
-export * from './TargetNestedElements';

package/src/screenplay/questions/targets/override.ts DELETED Viewed

@@ -1,17 +0,0 @@
-/* eslint-disable @typescript-eslint/explicit-module-boundary-types,@typescript-eslint/ban-types,unicorn/prevent-abbreviations */
-/**
- * @package
- * @param obj
- * @param name - name of the method or field to override
- * @param implementation
- */
-export function override<T extends object, K extends keyof T>(obj: T, name: K, implementation: T[K]) {
-    return new Proxy<T>(obj, {
-        get(o: T, property: string | symbol) {
-            return property === name
-                ? implementation
-                : obj[property];
-        },
-    });
-}