Script Operations
Abstract
Be sure to read the article about the common features of operations.HTTP/1
Executing HTTP/1 requests and receiving responses from the server. It can work with HTTPS traffic.
.get (post, put, head, delete, patch, options)
Assigns the appropriate HTTP request method.
.query
Adding a parameter to a request's query.
Instead of multiple calls to this method, it is possible to make one call by passing an object with multiple query part as a parameter:
.header
Adding a header to a request.
Instead of multiple calls to this method, it is possible to make one call by passing an object with multiple headers as a parameter:
.cookie
Adding a cookie to a request.
Instead of multiple calls to this method, it is possible to make one call by passing an object with multiple cookies as a parameter:
.body
Adding a data to a request's body.
Response
The result of executing the request is placed in a special "response" object.
This object contains several methods and properties for getting data:
.statusCode
This property returns the response code from the server.
.statusLine
This property returns the status string of the response. For example "HTTP/1.1 200 OK"
.header
This method returns the header by name. In case of multiple headers with the same name, the first one is returned.
.cookie
This method returns the cookie by name
.body
This property returns the body object of the response which contains several properties for getting data:
.size
This property returns the size of the body data in bytes.
.asText
This property returns the raw text of the response. By default, UTF-8 encoding is used.
.asObject
This property returns the js object received from the json response. If the json is invalid, an exception will be thrown.
свойство возвращает значение по хпаф выражению из json или xml.asBytes
This property returns the raw body data as array of bytes.
.regex
This property returns the value by regexp expression.
.xPath
This property returns the value by xPath expression from json or xml. If the json or xml is invalid, an exception will be thrown.
.auth
Sets the authorization type and required credentials to perform automatic authorization.
This method exists in two variants:
Parameterization of usernames and passwords is better implemented using data sources. It is more convenient and secure.HTTP/2
Executing HTTP/2 requests and receiving responses from the server. It can work only with HTTPS traffic.
The basic functionality is identical to the HTTP/1 protocol.Other methods
Coming soon...
WebSocket
Sending and receive WebSocket messages to and from the server. It can work with HTTPS traffic.
.sendText
Sending a text message without waiting for a response.
.sendArray
Sending a message with an array of bytes without waiting for a response.
.receiveText
Waiting for and receiving an incoming text message.
.receiveArray
Waiting for and receiving an incoming byte array message.
Swagger
Executing API call using a Swagger definition.
.show
Print a loaded definition to console
The list of other available methods and their parameters is determined by the loaded definition.Assert
Checking values outside the request chains. In case of a failed check, a message is posted to the blog.
.check
Checking the result of the expression for truth.
.equal
Checking the equality of the actual and expected values.
Log
An object for optional actions with the project execution log.
.message
Adding an informational message without changing the final status of the test.
.warning
Adding a warning to the project execution log. If the current final status is better than "Warning", then it changes to "Warning".
.error
Adding a error to the project execution log. If the current final status is better than "Error", then it changes to "Error".
pause
To simulate pauses between the actions of a real user or client application, the pause operation is used.
The delay duration of this operation is equal to a random value in the range between the two parameters of this operation.
Do not use any other methods of organizing execution delays, because this may reduce the performance of the test or distort its results.