Connection

Main class that is used to establish a connection and send requests to target sites.

// Gets the content of a PasteBin paste, assuming that we have received its key (`pasteBinKey`) in a prior request.
var connection = new http.Connection('http://pastebin.com/raw/');
connection.addHeader({name: ‘Content-Type’, value: ‘text/plain’});
var response = connection.getSync(pasteBinKey, '');
if (response && response.code === 200) {
  var text = '';
  response.headers.forEach(function(header) {
    text += header.name + ': ' + header.value + '\n';
  });
  text += '\n' + response.response;
  issue.addComment(text);
}

Constructors

Connection

Connection(url, sslKeyName, timeout)

Creates an object that lets you establish a connection with a target site.

See also:

doSync

Parameters:

Name	Type	Description
url	`string`	The URL of the target site for the connection.Can be empty, as you can specify the URI as a parameter for any request method.
sslKeyName	`string`	Optional name of the SSL key that is used to establish a secure connection.
timeout	`int`	Optional parameter that specifies the read timeout for outgoing HTTP requests.

Properties

Name	Type	Description	Read-only
headers	`Array.<{name: String, value: String}>`	A list of headers.
url	`string`	The URL of the target site for the connection.Can be empty, as you can specify the URI as a parameter for any request method.

Methods

addHeader

addHeader(header, value)

Adds a new header to the current connection.

Parameters:

Name	Type	Description
header	`Object`, `string`	A header object with the structure {name: string, value: string}.If the value parameter is specified separately, the provided string is used as the name of the header.
value	`string`	The value that is assigned to the header.Only considered when the first parameter is specified as a string.

Returns:

Type	Description
`Connection`	The current connection object.

basicAuth

basicAuth(login, password)

Adds an authorization header with the value returned by the Base64.encode(login + ':' + password) function.

Parameters:

Name	Type	Description
login	`String`	The login to use for the authorization request.
password	`String`	The password to use for the authorization request..

Returns:

Type	Description
`Connection`	The current connection object.

connectSync

connectSync(uri, queryParams)

Executes a synchronous CONNECT request.

Parameters:

Name	Type	Description
uri	`string`	request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

deleteSync

deleteSync(uri, queryParams)

Executes a synchronous DELETE request.

Parameters:

Name	Type	Description
uri	`string`	The request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

doSync

doSync(requestType, uri, queryParams, payload)

Sends a synchronous HTTP request. Note that instead of passing a properrequest type with this method, there are dedicated methods that correspond to eachrequest type that you can call directly. For example, getSync or postSync.

Parameters:

Name	Type	Description
requestType	`string`	A valid HTTP request type. For a list of supported request types, see REQUEST_TYPES.
uri	`string`	A relative URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`	The query parameters.
payload	`string`, `Array`, `Object`	The payload to be sent in the request.

Returns:

Type	Description
`Response`	An object that represents the HTTP response.

getSync

getSync(uri, queryParams)

Executes a synchronous GET request.

Parameters:

Name	Type	Description
uri	`String`	The request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

headSync

headSync(uri, queryParams)

Executes a synchronous HEAD request.

Parameters:

Name	Type	Description
uri	`string`	The request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

optionsSync

optionsSync(uri, queryParams)

Executes a synchronous OPTIONS request.

Parameters:

Name	Type	Description
uri	`string`	request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

patchSync

patchSync(uri, queryParams, payload)

Executes a synchronous PATCH request.

Parameters:

Name	Type	Description
uri	`string`	The request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.
payload	`string`	The payload to be sent in the request.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

postSync

postSync(uri, queryParams, payload)

Executes a synchronous POST request.

Parameters:

Name	Type	Description
uri	`string`	The request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.If the payload parameter is empty, the query parameters are passed as a form entity.
payload	`string`	The payload to be sent in the request.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

putSync

putSync(uri, queryParams, payload)

Executes a synchronous PUT request.

Parameters:

Name	Type	Description
uri	`string`	The request URI.The complete URL is a concatenation of the string that is passed to the URL parameter in the Connection constructor and this string.If the URL parameter in the Connection constructor is empty, specify the absolute URL of the target site.
queryParams	`Array.<{name: String, value: String}>`, `Object`	The query parameters.If an object is passed, its keys are considered to be parameter names.If the payload parameter is empty, the query parameters are passed as a form entity.
payload	`string`	The payload to be sent in the request.

Returns:

Type	Description
`Response`	An object that represents an HTTP response.

Last modified: 7 March 2019