codeceptjs 4.0.0-rc.17 → 4.0.0-rc.19

package/docs/helpers/REST.md

@@ -0,0 +1,289 @@
+---
+permalink: /helpers/REST
+editLink: false
+sidebar: auto
+title: REST
+---
+
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+## REST
+
+**Extends Helper**
+
+REST helper allows to send additional requests to the REST API during acceptance tests.
+[Axios][1] library is used to perform requests.
+
+
+
+## Configuration
+
+Type: [object][4]
+
+### Properties
+
+*   `endpoint` **[string][3]?** API base URL
+*   `prettyPrintJson` **[boolean][6]?** pretty print json for response/request on console logs.
+*   `printCurl` **[boolean][6]?** print cURL request on console logs. False by default.
+*   `timeout` **[number][5]?** timeout for requests in milliseconds. 10000ms by default.
+*   `defaultHeaders` **[object][4]?** a list of default headers.
+*   `httpAgent` **[object][4]?** create an agent with SSL certificate
+*   `onRequest` **[function][7]?** an async function which can update request object.
+*   `onResponse` **[function][7]?** an async function which can update response object.
+*   `maxUploadFileSize` **[number][5]?** set the max content file size in MB when performing api calls.
+
+
+
+## Example
+
+```js
+{
+  helpers: {
+    REST: {
+      endpoint: 'http://site.com/api',
+      prettyPrintJson: true,
+      onRequest: (request) => {
+        request.headers.auth = '123';
+      }
+    }
+  }
+}
+```
+
+With httpAgent
+
+```js
+{
+  helpers: {
+    REST: {
+      endpoint: 'http://site.com/api',
+      prettyPrintJson: true,
+      httpAgent: {
+         key: fs.readFileSync(__dirname + '/path/to/keyfile.key'),
+         cert: fs.readFileSync(__dirname + '/path/to/certfile.cert'),
+         rejectUnauthorized: false,
+         keepAlive: true
+      }
+    }
+  }
+}
+```
+
+```js
+{
+  helpers: {
+    REST: {
+      endpoint: 'http://site.com/api',
+      prettyPrintJson: true,
+      httpAgent: {
+         ca: fs.readFileSync(__dirname + '/path/to/ca.pem'),
+         rejectUnauthorized: false,
+         keepAlive: true
+      }
+    }
+  }
+}
+```
+
+## Access From Helpers
+
+Send REST requests by accessing `_executeRequest` method:
+
+```js
+this.helpers['REST']._executeRequest({
+   url,
+   data,
+});
+```
+
+## Methods
+
+### Parameters
+
+*   `config` &#x20;
+
+### _executeRequest
+
+Executes axios request
+
+#### Parameters
+
+*   `request` **any**&#x20;
+
+Returns **[Promise][2]<any>** response
+
+### _url
+
+Generates url based on format sent (takes endpoint + url if latter lacks 'http')
+
+#### Parameters
+
+*   `url` **any**&#x20;
+
+### amBearerAuthenticated
+
+Adds a header for Bearer authentication
+
+```js
+// we use secret function to hide token from logs
+I.amBearerAuthenticated(secret('heregoestoken'))
+```
+
+#### Parameters
+
+*   `accessToken` **([string][3] | CodeceptJS.Secret)** Bearer access token
+
+### haveRequestHeaders
+
+Sets request headers for all requests of this test
+
+#### Parameters
+
+*   `headers` **[object][4]** headers list
+
+### sendDeleteRequest
+
+Sends DELETE request to API.
+
+```js
+I.sendDeleteRequest('/api/users/1');
+```
+
+#### Parameters
+
+*   `url` **any**&#x20;
+*   `headers` **[object][4]** the headers object to be sent. By default, it is sent as an empty object 
+
+Returns **[Promise][2]<any>** response
+
+### sendDeleteRequestWithPayload
+
+Sends DELETE request to API with payload.
+
+```js
+I.sendDeleteRequestWithPayload('/api/users/1', { author: 'john' });
+```
+
+#### Parameters
+
+*   `url` **any**&#x20;
+*   `payload` **any** the payload to be sent. By default it is sent as an empty object 
+*   `headers` **[object][4]** the headers object to be sent. By default, it is sent as an empty object 
+
+Returns **[Promise][2]<any>** response
+
+### sendGetRequest
+
+Send GET request to REST API
+
+```js
+I.sendGetRequest('/api/users.json');
+```
+
+#### Parameters
+
+*   `url` **any**&#x20;
+*   `headers` **[object][4]** the headers object to be sent. By default, it is sent as an empty object 
+
+Returns **[Promise][2]<any>** response
+
+### sendHeadRequest
+
+Send HEAD request to REST API
+
+```js
+I.sendHeadRequest('/api/users.json');
+```
+
+#### Parameters
+
+*   `url` **any**&#x20;
+*   `headers` **[object][4]** the headers object to be sent. By default, it is sent as an empty object 
+
+Returns **[Promise][2]<any>** response
+
+### sendPatchRequest
+
+Sends PATCH request to API.
+
+```js
+I.sendPatchRequest('/api/users.json', { "email": "user@user.com" });
+
+// To mask the payload in logs
+I.sendPatchRequest('/api/users.json', secret({ "email": "user@user.com" }));
+
+```
+
+#### Parameters
+
+*   `url` **[string][3]**&#x20;
+*   `payload` **any** the payload to be sent. By default it is sent as an empty object 
+*   `headers` **[object][4]** the headers object to be sent. By default it is sent as an empty object 
+
+Returns **[Promise][2]<any>** response
+
+### sendPostRequest
+
+Sends POST request to API.
+
+```js
+I.sendPostRequest('/api/users.json', { "email": "user@user.com" });
+
+// To mask the payload in logs
+I.sendPostRequest('/api/users.json', secret({ "email": "user@user.com" }));
+
+```
+
+#### Parameters
+
+*   `url` **any**&#x20;
+*   `payload` **any** the payload to be sent. By default, it is sent as an empty object 
+*   `headers` **[object][4]** the headers object to be sent. By default, it is sent as an empty object 
+
+Returns **[Promise][2]<any>** response
+
+### sendPutRequest
+
+Sends PUT request to API.
+
+```js
+I.sendPutRequest('/api/users.json', { "email": "user@user.com" });
+
+// To mask the payload in logs
+I.sendPutRequest('/api/users.json', secret({ "email": "user@user.com" }));
+
+```
+
+#### Parameters
+
+*   `url` **[string][3]**&#x20;
+*   `payload` **any** the payload to be sent. By default it is sent as an empty object 
+*   `headers` **[object][4]** the headers object to be sent. By default it is sent as an empty object 
+
+Returns **[Promise][2]<any>** response
+
+### setRequestTimeout
+
+Set timeout for the request
+
+```js
+I.setRequestTimeout(10000); // In milliseconds
+```
+
+#### Parameters
+
+*   `newTimeout` **[number][5]** timeout in milliseconds
+
+[1]: https://github.com/axios/axios
+
+[2]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+
+[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+
+[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+
+[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+
+[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+
+[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function

package/docs/helpers/SoftExpectHelper.md

@@ -0,0 +1,352 @@
+---
+permalink: /helpers/SoftExpectHelper
+editLink: false
+sidebar: auto
+title: SoftExpectHelper
+---
+
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+## SoftAssertHelper
+
+**Extends ExpectHelper**
+
+SoftAssertHelper is a utility class for performing soft assertions.
+Unlike traditional assertions that stop the execution on failure,
+soft assertions allow the execution to continue and report all failures at the end.
+
+### Examples
+
+Zero-configuration when paired with other helpers like REST, Playwright:
+
+```js
+// inside codecept.conf.js
+{
+  helpers: {
+    Playwright: {...},
+    SoftExpectHelper: {},
+  }
+}
+```
+
+```js
+// in scenario
+I.softExpectEqual('a', 'b')
+I.flushSoftAssertions() // Throws an error if any soft assertions have failed. The error message contains all the accumulated failures.
+```
+
+## Methods
+
+### flushSoftAssertions
+
+Throws an error if any soft assertions have failed.
+The error message contains all the accumulated failures.
+
+- Throws **[Error][1]** If there are any soft assertion failures.
+
+### softAssert
+
+Performs a soft assertion by executing the provided assertion function.
+If the assertion fails, the error is caught and stored without halting the execution.
+
+#### Parameters
+
+- `assertionFn` **[Function][2]** The assertion function to execute.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectAbove
+
+Softly asserts that the target data is above a specified value.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `aboveThan` **any** The value that the target data should be above.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectBelow
+
+Softly asserts that the target data is below a specified value.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `belowThan` **any** The value that the target data should be below.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectContain
+
+Softly asserts that a value contains the expected value.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValueToContain` **any** The value that should be contained within the actual value.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectDeepEqual
+
+Softly asserts that two values are deeply equal.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValue` **any** The expected value.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectDeepEqualExcluding
+
+Softly asserts that two objects are deeply equal, excluding specified fields.
+
+#### Parameters
+
+- `actualValue` **[Object][4]** The actual object.
+- `expectedValue` **[Object][4]** The expected object.
+- `fieldsToExclude` **[Array][5]<[string][3]>** The fields to exclude from the comparison.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectDeepIncludeMembers
+
+Softly asserts that an array (superset) deeply includes all members of another array (set).
+
+#### Parameters
+
+- `superset` **[Array][5]** The array that should contain the expected members.
+- `set` **[Array][5]** The array with members that should be included.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectDeepMembers
+
+Softly asserts that two arrays have deep equality, considering members in any order.
+
+#### Parameters
+
+- `actualValue` **[Array][5]** The actual array.
+- `expectedValue` **[Array][5]** The expected array.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectEmpty
+
+Softly asserts that the target data is empty.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectEndsWith
+
+Softly asserts that a value ends with the expected value.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValueToEndWith` **any** The value that the actual value should end with.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectEqual
+
+Softly asserts that two values are equal.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValue` **any** The expected value.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectEqualIgnoreCase
+
+Softly asserts that two values are equal, ignoring case.
+
+#### Parameters
+
+- `actualValue` **[string][3]** The actual string value.
+- `expectedValue` **[string][3]** The expected string value.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectFalse
+
+Softly asserts that the target data is false.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectHasAProperty
+
+Softly asserts that the target data has a property with the specified name.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `propertyName` **[string][3]** The property name to check for.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectHasProperty
+
+Softly asserts that the target data has the specified property.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `propertyName` **[string][3]** The property name to check for.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion
+  fails.
+
+### softExpectJsonSchema
+
+Softly asserts that the target data matches the given JSON schema.
+
+#### Parameters
+
+- `targetData` **any** The data to validate.
+- `jsonSchema` **[Object][4]** The JSON schema to validate against.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectJsonSchemaUsingAJV
+
+Softly asserts that the target data matches the given JSON schema using AJV.
+
+#### Parameters
+
+- `targetData` **any** The data to validate.
+- `jsonSchema` **[Object][4]** The JSON schema to validate against.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+- `ajvOptions` **[Object][4]** Options to pass to AJV.
+
+### softExpectLengthAboveThan
+
+Softly asserts that the length of the target data is above a specified value.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `lengthAboveThan` **[number][6]** The length that the target data should be above.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectLengthBelowThan
+
+Softly asserts that the length of the target data is below a specified value.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `lengthBelowThan` **[number][6]** The length that the target data should be below.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectLengthOf
+
+Softly asserts that the target data has a specified length.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `length` **[number][6]** The expected length.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectMatchesPattern
+
+Softly asserts that a value matches the expected pattern.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedPattern` **any** The pattern the value should match.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectNotContain
+
+Softly asserts that a value does not contain the expected value.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValueToNotContain` **any** The value that should not be contained within the actual value.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectNotDeepEqual
+
+Softly asserts that two values are not deeply equal.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValue` **any** The expected value.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectNotEndsWith
+
+Softly asserts that a value does not end with the expected value.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValueToNotEndWith` **any** The value that the actual value should not end with.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectNotEqual
+
+Softly asserts that two values are not equal.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValue` **any** The expected value.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectNotStartsWith
+
+Softly asserts that a value does not start with the expected value.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValueToNotStartWith` **any** The value that the actual value should not start with.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectStartsWith
+
+Softly asserts that a value starts with the expected value.
+
+#### Parameters
+
+- `actualValue` **any** The actual value.
+- `expectedValueToStartWith` **any** The value that the actual value should start with.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectToBeA
+
+Softly asserts that the target data is of a specific type.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `type` **[string][3]** The expected type (e.g., 'string', 'number').
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectToBeAn
+
+Softly asserts that the target data is of a specific type (alternative for articles).
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `type` **[string][3]** The expected type (e.g., 'string', 'number').
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+### softExpectTrue
+
+Softly asserts that the target data is true.
+
+#### Parameters
+
+- `targetData` **any** The data to check.
+- `customErrorMsg` **[string][3]** A custom error message to display if the assertion fails.
+
+[1]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error
+[2]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number