@serenity-js/web 3.0.0-rc.3 → 3.0.0-rc.31

package/CHANGELOG.md

@@ -3,6 +3,275 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.0.0-rc.31](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.30...v3.0.0-rc.31) (2022-10-07)
+
+
+### Features
+
+* **web:** accept Answerable as argument of ExecuteScript.from(sourceUrl) ([0b06703](https://github.com/serenity-js/serenity-js/commit/0b06703cd832bf64dbb2636ef955ecba7b8b430c))
+
+
+
+
+
+# [3.0.0-rc.30](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.29...v3.0.0-rc.30) (2022-10-05)
+
+
+### Bug Fixes
+
+* **web:** all web modules now correctly support handling iframe context for the current page ([bcb8672](https://github.com/serenity-js/serenity-js/commit/bcb86722dfcaa023613e63fb8bd2e14d6d546efd)), closes [#1310](https://github.com/serenity-js/serenity-js/issues/1310)
+* **web:** corrected interaction to Clear to avoid issues with elements that have no value attribute ([37ae809](https://github.com/serenity-js/serenity-js/commit/37ae8092a36091db528024b99695905982ef8284)), closes [#1306](https://github.com/serenity-js/serenity-js/issues/1306)
+* **web:** interaction to Clear now supports "contenteditable" elements ([d090458](https://github.com/serenity-js/serenity-js/commit/d090458845c23af59561d74421c16160ccc4ff64)), closes [#1306](https://github.com/serenity-js/serenity-js/issues/1306)
+
+
+### Features
+
+* **web:** interaction to Clear works with "contenteditable" elements across all the web tools ([c53b00d](https://github.com/serenity-js/serenity-js/commit/c53b00dac512977c00e5eadc101e281997f8e0de)), closes [#1306](https://github.com/serenity-js/serenity-js/issues/1306)
+
+
+
+
+
+# [3.0.0-rc.29](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.28...v3.0.0-rc.29) (2022-10-01)
+
+**Note:** Version bump only for package @serenity-js/web
+
+
+
+
+
+# [3.0.0-rc.28](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.27...v3.0.0-rc.28) (2022-09-30)
+
+
+### Bug Fixes
+
+* **core:** activity is now able to detect invocation location on Node 14 ([41f4776](https://github.com/serenity-js/serenity-js/commit/41f4776736620bc32d474d9b66f69c742f8eca96)), closes [#1240](https://github.com/serenity-js/serenity-js/issues/1240)
+* **playwright:** corrected not(isPresent()) for PlaywrightPageElement ([0693b2f](https://github.com/serenity-js/serenity-js/commit/0693b2f2666a8de327c990c72ecf42fc3d7da498)), closes [#1240](https://github.com/serenity-js/serenity-js/issues/1240)
+* **web:** question about Text.of(element) now trims newline and space characters ([c68bbe9](https://github.com/serenity-js/serenity-js/commit/c68bbe9bed082c84538983dd6233e684190c3c43))
+
+
+### Features
+
+* **playwright-test:** improved Playwright Test reports ([6c6b537](https://github.com/serenity-js/serenity-js/commit/6c6b5379dfc324a4fb75d758daa7782109f1c5ab)), closes [#1240](https://github.com/serenity-js/serenity-js/issues/1240)
+
+
+### Reverts
+
+* **web:** reverted the change to Text that would make it automatically trim the retrieved text ([f5a47b7](https://github.com/serenity-js/serenity-js/commit/f5a47b7e9e0be26522522b5a6647b24ffad6bee8))
+
+
+
+
+
+# [3.0.0-rc.27](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.26...v3.0.0-rc.27) (2022-08-26)
+
+**Note:** Version bump only for package @serenity-js/web
+
+
+
+
+
+# [3.0.0-rc.26](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.25...v3.0.0-rc.26) (2022-08-15)
+
+**Note:** Version bump only for package @serenity-js/web
+
+
+
+
+
+# [3.0.0-rc.25](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.24...v3.0.0-rc.25) (2022-08-15)
+
+
+### Bug Fixes
+
+* **core:** extracted common TypeScript configuration ([0108370](https://github.com/serenity-js/serenity-js/commit/0108370a6a7ebb4bcd71773482801d29f5660268))
+* **deps:** updated TinyTypes to 1.19.0 ([f6d53e4](https://github.com/serenity-js/serenity-js/commit/f6d53e4dbbfcb81139bd888ac11441b6344e47f5))
+* **web:** simplified isClickable so that it doesn't include visibility check ([33ad47e](https://github.com/serenity-js/serenity-js/commit/33ad47e448e73a26f337371fcc6f5566845b4c93))
+
+
+
+
+
+# [3.0.0-rc.24](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.23...v3.0.0-rc.24) (2022-07-23)
+
+
+### Bug Fixes
+
+* **web:** simplified the implementation of isClickable and isEnabled ([142eb86](https://github.com/serenity-js/serenity-js/commit/142eb861d95e08df7717e9fffc57153a62c88f66)), closes [#1255](https://github.com/serenity-js/serenity-js/issues/1255)
+
+
+### Features
+
+* **web:** PageElement-releated expectations now also check if the element is present ([de4610c](https://github.com/serenity-js/serenity-js/commit/de4610c3199f7130fd56d2d6799a328cbd7540a2)), closes [#1255](https://github.com/serenity-js/serenity-js/issues/1255)
+
+
+
+
+
+# [3.0.0-rc.23](https://github.com/serenity-js/serenity-js/compare/v2.33.10...v3.0.0-rc.23) (2022-07-19)
+
+
+### Bug Fixes
+
+* **node:** support for Node 18 ([73212bc](https://github.com/serenity-js/serenity-js/commit/73212bc9deb1998d871b0720a6b437687b3ceddc)), closes [#1243](https://github.com/serenity-js/serenity-js/issues/1243)
+
+
+
+# [3.0.0-rc.22](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.21...v3.0.0-rc.22) (2022-07-15)
+
+
+
+# [3.0.0-rc.21](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.20...v3.0.0-rc.21) (2022-07-11)
+
+
+
+# [3.0.0-rc.20](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.19...v3.0.0-rc.20) (2022-07-11)
+
+
+### Bug Fixes
+
+* **protractor:** isVisible check for ProtractorPageElement returns false for non-existent elements ([e64eee3](https://github.com/serenity-js/serenity-js/commit/e64eee377af32909f25e7c1d88f45a484abb1514)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+* **web:** improved JavaScript dialog-related error handling when taking screenshots ([3cd1149](https://github.com/serenity-js/serenity-js/commit/3cd1149ed74df95da17f1054cd4da93b095a4eed)), closes [puppeteer/puppeteer#2481](https://github.com/puppeteer/puppeteer/issues/2481) [#1156](https://github.com/serenity-js/serenity-js/issues/1156)
+* **web:** renamed PagesContext to BrowsingSession to make the name more descriptive ([6b4e998](https://github.com/serenity-js/serenity-js/commit/6b4e9984d80f8f349f367e59bd0e615cd01703ec)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+
+
+### Features
+
+* **core:** interactions to Wait.for and Wait.until are now browser-independent ([d115142](https://github.com/serenity-js/serenity-js/commit/d1151427bed96c1ebd0d1dcc4159c6aeedc605de)), closes [#1035](https://github.com/serenity-js/serenity-js/issues/1035) [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+* **playwright:** configurable navigation waitUntil timeout ([2458fcb](https://github.com/serenity-js/serenity-js/commit/2458fcb22c946da41ab59cb21ac0d4cc48012da7)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+* **playwright:** initial support for Playwright ([87e88a1](https://github.com/serenity-js/serenity-js/commit/87e88a16cdc06477ed25eb83f9597fd370fdc109)), closes [#493](https://github.com/serenity-js/serenity-js/issues/493) [#563](https://github.com/serenity-js/serenity-js/issues/563) [#911](https://github.com/serenity-js/serenity-js/issues/911)
+* **playwright:** interaction to Select option(s) from a <select /> dropdown ([009041d](https://github.com/serenity-js/serenity-js/commit/009041d83e22ddf3fef14670e0e5fd6d11cdfc73)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+* **playwright:** support for isVisible, plus consistent visibility checks across the board ([2c5c929](https://github.com/serenity-js/serenity-js/commit/2c5c929802f894f9fe59438a01f08b1b7bec3318)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+* **playwright:** support for working with frames ([89d4621](https://github.com/serenity-js/serenity-js/commit/89d46212073a342fe812a3ad2638a2ad0c39b620)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+* **web:** introduced PagesContext and implemented PlaywrightPage ([0045a72](https://github.com/serenity-js/serenity-js/commit/0045a726d540871333f644928218aed00bcd372c)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236)
+* **web:** new portable APIs to handle ModalDialog windows ([c94d0ec](https://github.com/serenity-js/serenity-js/commit/c94d0ec43d2bc8aa39f8824f5d0f1e1cbcf137a1)), closes [#1236](https://github.com/serenity-js/serenity-js/issues/1236) [#805](https://github.com/serenity-js/serenity-js/issues/805) [#1156](https://github.com/serenity-js/serenity-js/issues/1156)
+* **web:** standardised support for deep CSS selectors across the Web integration modules ([e9e3f28](https://github.com/serenity-js/serenity-js/commit/e9e3f281191fc5c891841b6c8aab41213da3b0f5)), closes [#1238](https://github.com/serenity-js/serenity-js/issues/1238)
+
+
+
+# [3.0.0-rc.19](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.18...v3.0.0-rc.19) (2022-06-11)
+
+
+
+# [3.0.0-rc.18](https://github.com/serenity-js/serenity-js/compare/v2.33.9...v3.0.0-rc.18) (2022-06-06)
+
+
+### Bug Fixes
+
+* **deps:** updated tiny-types ([f1951cf](https://github.com/serenity-js/serenity-js/commit/f1951cf753df3807b5778d116f8e8bc3f24830a7))
+* **deps:** updated tiny-types to 1.18.2 ([83a651c](https://github.com/serenity-js/serenity-js/commit/83a651c4c2f3f8dbaabcdacba94c720efdff45dd))
+
+
+
+# [3.0.0-rc.17](https://github.com/serenity-js/serenity-js/compare/v2.33.8...v3.0.0-rc.17) (2022-06-02)
+
+
+
+# [3.0.0-rc.16](https://github.com/serenity-js/serenity-js/compare/v2.33.6...v3.0.0-rc.16) (2022-04-15)
+
+
+
+# [3.0.0-rc.15](https://github.com/serenity-js/serenity-js/compare/v2.33.5...v3.0.0-rc.15) (2022-04-10)
+
+
+### Bug Fixes
+
+* **web:** corrected an inefficient regular expression in By selector description generator ([1b537d2](https://github.com/serenity-js/serenity-js/commit/1b537d2de02f89760237816fc726f5e11c2bee0c))
+* **web:** replaced legacy PromiseLike return types with native Promise types ([436b3cb](https://github.com/serenity-js/serenity-js/commit/436b3cba1793f63008a56633cc93669736155ce6))
+
+
+
+# [3.0.0-rc.14](https://github.com/serenity-js/serenity-js/compare/v2.33.3...v3.0.0-rc.14) (2022-03-28)
+
+
+### Bug Fixes
+
+* **web:** auto-generated descriptions of nested PageElements are easier to read ([5a51d91](https://github.com/serenity-js/serenity-js/commit/5a51d91f0abb1c32814c219a44da51d52df77f87))
+* **web:** corrected return types of question about Selected page elements ([b32f280](https://github.com/serenity-js/serenity-js/commit/b32f2809b018d6791a37fd80a226ca16a822b9b6))
+
+
+### Features
+
+* **web:** Attribute.called(name).of(pageElement) returns a QuestionAdapter ([e220665](https://github.com/serenity-js/serenity-js/commit/e220665de37f15d4cfc8ad570bfa7b804d71335b))
+* **web:** CssClasses.of(pageElement) returns a QuestionAdapter ([0942887](https://github.com/serenity-js/serenity-js/commit/0942887eb8e726dce3b8d64a7f9162ec782e61b7))
+* **web:** Value.of(pageElement) returns a QuestionAdapter ([c45b483](https://github.com/serenity-js/serenity-js/commit/c45b483be071d297dc41e6b098a03f5697d53050))
+
+
+
+# [3.0.0-rc.13](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.12...v3.0.0-rc.13) (2022-03-02)
+
+
+### Features
+
+* **web:** combined Frame and PageElement so they can be Switch-ed to ([1b7ab7c](https://github.com/serenity-js/serenity-js/commit/1b7ab7c828034a14ba801cbfa97acc203fd55adf)), closes [#82](https://github.com/serenity-js/serenity-js/issues/82) [#227](https://github.com/serenity-js/serenity-js/issues/227) [#233](https://github.com/serenity-js/serenity-js/issues/233) [#365](https://github.com/serenity-js/serenity-js/issues/365)
+
+
+
+# [3.0.0-rc.12](https://github.com/serenity-js/serenity-js/compare/v2.33.2...v3.0.0-rc.12) (2022-02-23)
+
+
+
+# [3.0.0-rc.11](https://github.com/serenity-js/serenity-js/compare/v2.33.1...v3.0.0-rc.11) (2022-02-13)
+
+
+### Bug Fixes
+
+* **web:** made the constructor of BrowseTheWeb protected, since it's an abstract class ([dbfbed0](https://github.com/serenity-js/serenity-js/commit/dbfbed02923bc1c589e588429c163ffbc7b13a34))
+
+
+### Features
+
+* **web:** support for working with frames and an interaction to Switch.to(frameOrPage) ([ef73ef2](https://github.com/serenity-js/serenity-js/commit/ef73ef273f8a17e48d396d5ef03f6b761b136c9a)), closes [#805](https://github.com/serenity-js/serenity-js/issues/805)
+
+
+
+# [3.0.0-rc.10](https://github.com/serenity-js/serenity-js/compare/v2.33.0...v3.0.0-rc.10) (2022-02-03)
+
+
+
+# [3.0.0-rc.9](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.8...v3.0.0-rc.9) (2022-02-01)
+
+
+
+# [3.0.0-rc.8](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.7...v3.0.0-rc.8) (2022-01-28)
+
+
+
+# [3.0.0-rc.7](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.6...v3.0.0-rc.7) (2022-01-28)
+
+
+### Features
+
+* **assertions:** isPresent works with any Optional ([cea75dc](https://github.com/serenity-js/serenity-js/commit/cea75dc1c728e45e06a87aaf9c1573a237334285)), closes [#1103](https://github.com/serenity-js/serenity-js/issues/1103)
+* **core:** `f` and `d` question description formatters ([c9f3fad](https://github.com/serenity-js/serenity-js/commit/c9f3fadd86ec0196f2cdbf76d9628bbef0a3fcba))
+* **core:** replaced `Adapter` with `QuestionAdapter` and introduced `Optional` ([8d84ad3](https://github.com/serenity-js/serenity-js/commit/8d84ad3863e3c726533d0f21934fb1e2fa8b3022)), closes [#1103](https://github.com/serenity-js/serenity-js/issues/1103)
+* **core:** support for Optional chaining, expectation isPresent, refactored Expectations ([1841ee5](https://github.com/serenity-js/serenity-js/commit/1841ee5fc48cfa403ddc53358f75764d9a010c21)), closes [#1099](https://github.com/serenity-js/serenity-js/issues/1099) [#1099](https://github.com/serenity-js/serenity-js/issues/1099) [#1103](https://github.com/serenity-js/serenity-js/issues/1103)
+
+
+
+# [3.0.0-rc.6](https://github.com/serenity-js/serenity-js/compare/v2.32.7...v3.0.0-rc.6) (2022-01-10)
+
+
+
+# [3.0.0-rc.5](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.4...v3.0.0-rc.5) (2022-01-07)
+
+
+### Features
+
+* **web:** support for advanced PageElement locator patterns ([c1ff8b7](https://github.com/serenity-js/serenity-js/commit/c1ff8b7539ebc1da8f79ea2b6d17bb01c42f443d)), closes [#1084](https://github.com/serenity-js/serenity-js/issues/1084)
+
+
+
+# [3.0.0-rc.4](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.3...v3.0.0-rc.4) (2021-12-30)
+
+
+### Features
+
+* **web:** ElementExpectation makes it easier to define custom PageElement-related Expectations ([92ebf7d](https://github.com/serenity-js/serenity-js/commit/92ebf7db720d0fe88ddbe17b9958fa993b1fd02e))
+* **web:** Text.ofAll accepts mapped PageElements ([5314246](https://github.com/serenity-js/serenity-js/commit/5314246305fa3f62446d5ec718f36354152be68d))
+
+
+
 # [3.0.0-rc.3](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.2...v3.0.0-rc.3) (2021-12-29)
 
 
@@ -25,22 +294,12 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 
 
-
-
 # [3.0.0-rc.2](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.1...v3.0.0-rc.2) (2021-12-09)
 
-**Note:** Version bump only for package @serenity-js/web
-
-
-
 
 
 # [3.0.0-rc.1](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.0...v3.0.0-rc.1) (2021-12-09)
 
-**Note:** Version bump only for package @serenity-js/web
-
-
-
 
 
 # [3.0.0-rc.0](https://github.com/serenity-js/serenity-js/compare/v2.32.5...v3.0.0-rc.0) (2021-12-08)

package/README.md

@@ -8,7 +8,7 @@ and [API docs](https://serenity-js.org/modules/), and follow [@SerenityJS](https
 
 ### Learning Serenity/JS
 
-To learn more about Serenity/JS, check out the video below, read the [tutorial](https://serenity-js.org/handbook/thinking-in-serenity-js/index.html), review the [examples](https://github.com/serenity-js/serenity-js/tree/master/examples), and create your own test suite with [Serenity/JS template projects](https://github.com/serenity-js).
+To learn more about Serenity/JS, check out the video below, read the [tutorial](https://serenity-js.org/handbook/thinking-in-serenity-js/index.html), review the [examples](https://github.com/serenity-js/serenity-js/tree/main/examples), and create your own test suite with [Serenity/JS template projects](https://github.com/serenity-js).
 
 If you have any questions, join us on [Serenity/JS Community Chat](https://gitter.im/serenity-js/Lobby).
 

package/lib/errors/BrowserWindowClosedError.d.ts

@@ -0,0 +1,15 @@
+import { LogicError } from '@serenity-js/core';
+/**
+ * Thrown when you're trying to take a screenshot of a browser window
+ * that's already been closed.
+ *
+ * ## Learn more
+ * - {@apilink TakeScreenshot}
+ * - {@apilink Page.takeScreenshot}
+ *
+ * @group Errors
+ */
+export declare class BrowserWindowClosedError extends LogicError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=BrowserWindowClosedError.d.ts.map

package/lib/errors/BrowserWindowClosedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWindowClosedError.d.ts","sourceRoot":"","sources":["../../src/errors/BrowserWindowClosedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBACxC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/lib/errors/BrowserWindowClosedError.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserWindowClosedError = void 0;
+const core_1 = require("@serenity-js/core");
+/**
+ * Thrown when you're trying to take a screenshot of a browser window
+ * that's already been closed.
+ *
+ * ## Learn more
+ * - {@apilink TakeScreenshot}
+ * - {@apilink Page.takeScreenshot}
+ *
+ * @group Errors
+ */
+class BrowserWindowClosedError extends core_1.LogicError {
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+exports.BrowserWindowClosedError = BrowserWindowClosedError;
+//# sourceMappingURL=BrowserWindowClosedError.js.map

package/lib/errors/BrowserWindowClosedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWindowClosedError.js","sourceRoot":"","sources":["../../src/errors/BrowserWindowClosedError.ts"],"names":[],"mappings":";;;AAAA,4CAA+C;AAE/C;;;;;;;;;GASG;AACH,MAAa,wBAAyB,SAAQ,iBAAU;IACpD,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;CACJ;AAJD,4DAIC"}

package/lib/errors/CookieMissingError.d.ts

@@ -1,4 +1,15 @@
 import { RuntimeError } from '@serenity-js/core';
+/**
+ * Thrown when the [cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
+ * you're trying to retrieve has not been set yet.
+ *
+ * ## Learn more
+ * - {@apilink Cookie}
+ * - {@apilink RuntimeError}
+ *
+ * @group Errors
+ */
 export declare class CookieMissingError extends RuntimeError {
     constructor(message: string, cause?: Error);
 }
+//# sourceMappingURL=CookieMissingError.d.ts.map

package/lib/errors/CookieMissingError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieMissingError.d.ts","sourceRoot":"","sources":["../../src/errors/CookieMissingError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/lib/errors/CookieMissingError.js

@@ -2,6 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CookieMissingError = void 0;
 const core_1 = require("@serenity-js/core");
+/**
+ * Thrown when the [cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
+ * you're trying to retrieve has not been set yet.
+ *
+ * ## Learn more
+ * - {@apilink Cookie}
+ * - {@apilink RuntimeError}
+ *
+ * @group Errors
+ */
 class CookieMissingError extends core_1.RuntimeError {
     constructor(message, cause) {
         super(CookieMissingError, message, cause);

package/lib/errors/CookieMissingError.js.map

@@ -1 +1 @@
-{"version":3,"file":"CookieMissingError.js","sourceRoot":"","sources":["../../src/errors/CookieMissingError.ts"],"names":[],"mappings":";;;AAAA,4CAAiD;AAEjD,MAAa,kBAAmB,SAAQ,mBAAY;IAChD,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACJ;AAJD,gDAIC"}
+{"version":3,"file":"CookieMissingError.js","sourceRoot":"","sources":["../../src/errors/CookieMissingError.ts"],"names":[],"mappings":";;;AAAA,4CAAiD;AAEjD;;;;;;;;;GASG;AACH,MAAa,kBAAmB,SAAQ,mBAAY;IAChD,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACJ;AAJD,gDAIC"}

package/lib/errors/ModalDialogObstructsScreenshotError.d.ts

@@ -0,0 +1,15 @@
+import { LogicError } from '@serenity-js/core';
+/**
+ * Thrown when the presence of a JavaScript dialog obstructs taking a screenshot.
+ *
+ * ## Learn more
+ * - {@apilink Photographer}
+ * - {@apilink LogicError}
+ * - {@apilink TakeScreenshot}
+ *
+ * @group Errors
+ */
+export declare class ModalDialogObstructsScreenshotError extends LogicError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=ModalDialogObstructsScreenshotError.d.ts.map

package/lib/errors/ModalDialogObstructsScreenshotError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalDialogObstructsScreenshotError.d.ts","sourceRoot":"","sources":["../../src/errors/ModalDialogObstructsScreenshotError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,qBAAa,mCAAoC,SAAQ,UAAU;gBACnD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG7C"}

package/lib/errors/ModalDialogObstructsScreenshotError.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModalDialogObstructsScreenshotError = void 0;
+const core_1 = require("@serenity-js/core");
+/**
+ * Thrown when the presence of a JavaScript dialog obstructs taking a screenshot.
+ *
+ * ## Learn more
+ * - {@apilink Photographer}
+ * - {@apilink LogicError}
+ * - {@apilink TakeScreenshot}
+ *
+ * @group Errors
+ */
+class ModalDialogObstructsScreenshotError extends core_1.LogicError {
+    constructor(message, cause) {
+        super(message, cause);
+    }
+}
+exports.ModalDialogObstructsScreenshotError = ModalDialogObstructsScreenshotError;
+//# sourceMappingURL=ModalDialogObstructsScreenshotError.js.map

package/lib/errors/ModalDialogObstructsScreenshotError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalDialogObstructsScreenshotError.js","sourceRoot":"","sources":["../../src/errors/ModalDialogObstructsScreenshotError.ts"],"names":[],"mappings":";;;AAAA,4CAA+C;AAE/C;;;;;;;;;GASG;AACH,MAAa,mCAAoC,SAAQ,iBAAU;IAC/D,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;CACJ;AAJD,kFAIC"}

package/lib/errors/index.d.ts

@@ -1 +1,4 @@
+export * from './BrowserWindowClosedError';
 export * from './CookieMissingError';
+export * from './ModalDialogObstructsScreenshotError';
+//# sourceMappingURL=index.d.ts.map

package/lib/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC"}

package/lib/errors/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -10,5 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BrowserWindowClosedError"), exports);
 __exportStar(require("./CookieMissingError"), exports);
+__exportStar(require("./ModalDialogObstructsScreenshotError"), exports);
 //# sourceMappingURL=index.js.map

package/lib/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,uDAAqC;AACrC,wEAAsD"}

package/lib/expectations/ElementExpectation.d.ts

@@ -1,11 +1,124 @@
-import { AnswersQuestions, Expectation, ExpectationOutcome } from '@serenity-js/core';
+import { Expectation } from '@serenity-js/core';
 import { PageElement } from '../screenplay';
 /**
- * @access private
+ * A factory method to that makes defining custom {@apilink PageElement}-related {@apilink Expectation|expectations} easier
+ *
+ * ## Defining a custom expectation
+ *
+ * ```ts
+ * import { Expectation } from '@serenity-js/core'
+ * import { ElementExpectation, PageElement } from '@serenity-js/web'
+ *
+ * export function isEmpty(): Expectation<boolean, PageElement> {
+ *   return ElementExpectation.forElementTo('have an empty value', async actual => {
+ *     const value = await actual.value();
+ *     return value.length === 0;
+ *   })
+ * }
+ * ```
+ *
+ * ## Using an expectation in an assertion
+ *
+ * ```ts
+ * import { Ensure } from '@serenity-js/assertions'
+ * import { actorCalled } from '@serenity-js/core'
+ * import { By, Clear, PageElement } from '@serenity-js/web'
+ *
+ * const nameField = () =>
+ *   PageElement.located(By.css('[data-test-id="name"]')).describedAs('name field');
+ *
+ * await actorCalled('Izzy').attemptsTo(
+ *   Clear.the(nameField()),
+ *   Ensure.that(nameField(), isEmpty())
+ * )
+ * ```
+ *
+ * ## Using an expectation in a control flow statement
+ *
+ * ```ts
+ * import { not } from '@serenity-js/assertions'
+ * import { actorCalled, Check, Duration, Wait } from '@serenity-js/core'
+ * import { By, PageElement } from '@serenity-js/web'
+ *
+ * const nameField = () =>
+ *   PageElement.located(By.css('[data-test-id="name"]')).describedAs('name field');
+ *
+ * await actorCalled('Izzy').attemptsTo(
+ *   Check.whether(nameField(), isEmpty())
+ *     .andIfSo(
+ *       Enter.theValue(actorInTheSpotlight().name).into(nameField()),
+ *     ),
+ * )
+ * ```
+ *
+ * ## Using an expectation in a synchronisation statement
+ *
+ * ```ts
+ * import { not } from '@serenity-js/assertions'
+ * import { actorCalled, Duration, Wait } from '@serenity-js/core'
+ * import { By, PageElement } from '@serenity-js/web'
+ *
+ * const nameField = () =>
+ *   PageElement.located(By.css('[data-test-id="name"]')).describedAs('name field');
+ *
+ * await actorCalled('Izzy').attemptsTo(
+ *   Enter.theValue(actorInTheSpotlight().name).into(nameField()),
+ *
+ *   Wait.upTo(Duration.ofSeconds(2))
+ *     .until(nameField(), not(isEmpty())),
+ * )
+ * ```
+ *
+ * ## Learn more
+ * - {@apilink Expectation}
+ * - {@apilink Ensure}
+ * - {@apilink Check}
+ * - {@apilink Wait}
+ *
+ * @group Expectations
  */
-export declare class ElementExpectation extends Expectation<any, PageElement> {
+export declare class ElementExpectation extends Expectation<PageElement> {
     private readonly fn;
-    static forElementTo(message: string, fn: (actual: PageElement) => Promise<boolean>): Expectation<any, PageElement>;
-    constructor(subject: string, fn: (actual: PageElement) => Promise<boolean>);
-    answeredBy(actor: AnswersQuestions): (actual: PageElement) => Promise<ExpectationOutcome<boolean, PageElement>>;
+    /**
+     * Instantiates a custom {@apilink PageElement}-specific {@apilink Expectation}
+     *
+     * #### Defining a custom expectation
+     * ```ts
+     * import { Expectation } from '@serenity-js/core'
+     * import { ElementExpectation, PageElement } from '@serenity-js/web'
+     *
+     * export function isEmpty(): Expectation<boolean, PageElement> {
+     *   return ElementExpectation.forElementTo('have an empty value', async actual => {
+     *     const value = await actual.value();
+     *     return value.length === 0;
+     *   })
+     * }
+     * ```
+     *
+     * @param description
+     *  A description of the expectation.
+     *
+     *  Please note that Serenity/JS will use it to describe your expectation in sentences like these:
+     *  - `actor ensures that <something> does <description>`
+     *  - `actor ensures that <something> does not <description>`
+     *  - `actor waits until <something> does <description>`
+     *  - `actor waits until <something> does not <description>`
+     *
+     *  To work with the above templates, the description should be similar to
+     *  - `become present`,
+     *  - `become active`,
+     *  - `equal X`,
+     *  - `have value greater than Y`,
+     *  - `have an empty value`
+     *
+     *  **DO NOT** use descriptions like "is present", "is active", "equals X", "is greater than Y"
+     *  as they won't read well in your test reports.
+     *
+     * @param fn
+     *  An asynchronous callback function that receives a {@apilink PageElement} and returns a {@apilink Promise}
+     *  that should resolve to `true` when the expectation is met, or `false` otherwise.
+     */
+    static forElementTo(description: string, fn: (actual: PageElement) => Promise<boolean>): Expectation<PageElement>;
+    constructor(description: string, fn: (actual: PageElement) => Promise<boolean>);
 }
+//# sourceMappingURL=ElementExpectation.d.ts.map

package/lib/expectations/ElementExpectation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementExpectation.d.ts","sourceRoot":"","sources":["../../src/expectations/ElementExpectation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,WAAW,EAAqC,MAAM,mBAAmB,CAAC;AAEjH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,WAAW,CAAC;IA+CxD,OAAO,CAAC,QAAQ,CAAC,EAAE;IA7CvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC;gBAK7G,WAAW,EAAE,MAAM,EACF,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC;CAerE"}