> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usebruno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Request Object

The `req` object represents the HTTP request made to the server. It contains various properties that define the request details.

## `req` Sub-Object

The `req` sub-object contains detailed information about the request.

* `assertions` : An array containing any assertions associated with the request. *See [assertions](../../tests/assertions)*.
* `auth` : An object containing authentication credentials, such as username and password.
* `headers` : A sub-object representing the HTTP headers associated with the request.
* `method` : The HTTP method used for the request (e.g., "GET", "POST").
* `mode` : The mode of the request (e.g., "none", "cors").
* `responseType` : The expected response type for the request (e.g., "text", "json").
* `script` : An object containing script-related information for the request.
* `signal` : A signal object used to abort the request.
* `url` : The URL of the request.
* `vars` : An object containing any variables associated with the request. *See [variables](../../script/vars)*.

## Headers

The `headers` sub-object of the `req` object contains key-value pairs representing the HTTP headers associated with the request.

```javascript theme={null}
// Example usage
console.log(req.headers);
/* Output: {
  authorization: 'Bearer <token>',
  'content-type': 'application/json',
  accept: 'application/json',
  // Add more headers as needed...
} */
```

## Method

The `method` property of the `req` object specifies the HTTP method used for the request. Common HTTP methods include "GET", "POST", "PUT", "DELETE", etc. The method indicates the type of action the request wishes to perform on the resource. The value of the `method` property should be a string representing the desired HTTP method for the request.

```javascript theme={null}
// Example usage
console.log(req.method); // Output: "GET"
```

## URL

The `url` property of the `req` object represents the Uniform Resource Locator (URL) of the request. It specifies the address of the resource being requested by the client. Variables enclosed within double curly braces (`{{...}}`) in the URL string are placeholders that may be replaced with actual values at runtime. These variables are not directly visible within the URL string and are typically encapsulated during request processing.

```javascript theme={null}
// Example usage
console.log(req.url); // Output: "{{base.url}}/users/2?queryTest=queryResult"
```

## Example Usage

```javascript theme={null}
// Example request object
const req = {
  assertions: [],
  auth: { username: 'myUsername', password: 'mySuperPassword' },
  headers: {
    authorization: 'Bearer <token>',
    'content-type': 'application/json',
    accept: 'application/json',
    // Add more headers as needed...
  },
  method: 'GET',
  mode: 'none',
  responseType: 'arraybuffer',
  script: {
    req: "// Create an array of objects\nconst data = [\n  { i…q);\nconst myVariable = bru.getEnvVar('password');"
  },
  signal: {},
  url: '{{base.url}}/users/2?queryTest=queryResult',
  vars: {}
};

// Accessing request properties
console.log(req.method); // Output: "GET"
console.log(req.url); // Output: "{{base.url}}/users/2?queryTest=queryResult"
console.log(req.headers.authorization); // Output: "Bearer <token>"
console.log(req.auth.username); // Output: "myUsername"
```