codeceptjs 3.5.15 → 3.6.0-beta.1.ai-healers

package/docs/helpers/REST.md

@@ -0,0 +1,218 @@
+---
+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
+-   `timeout` **[number][5]?** timeout for requests in milliseconds. 10000ms by default
+-   `defaultHeaders` **[object][4]?** a list of default headers
+-   `onRequest` **[function][7]?** a async function which can update request object.
+-   `onResponse` **[function][7]?** a 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';
+      }
+    }
+  }
+}
+```
+
+## Access From Helpers
+
+Send REST requests by accessing `_executeRequest` method:
+
+```js
+this.helpers['REST']._executeRequest({
+   url,
+   data,
+});
+```
+
+## Methods
+
+### Parameters
+
+-   `config`  
+
+### _executeRequest
+
+Executes axios request
+
+#### Parameters
+
+-   `request` **any** 
+
+Returns **[Promise][2]&lt;any>** response
+
+### _url
+
+Generates url based on format sent (takes endpoint + url if latter lacks 'http')
+
+#### Parameters
+
+-   `url` **any** 
+
+### 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** 
+-   `headers` **[object][4]** the headers object to be sent. By default, it is sent as an empty object 
+
+Returns **[Promise][2]&lt;any>** response
+
+### sendGetRequest
+
+Send GET request to REST API
+
+```js
+I.sendGetRequest('/api/users.json');
+```
+
+#### Parameters
+
+-   `url` **any** 
+-   `headers` **[object][4]** the headers object to be sent. By default, it is sent as an empty object 
+
+Returns **[Promise][2]&lt;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]** 
+-   `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]&lt;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** 
+-   `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]&lt;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]** 
+-   `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]&lt;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