Available APIs

Example: Log Request Details

// Log request information for debugging
console.log('Method:', tg.request.method);
console.log('URL:', tg.request.url);
console.log('Headers:', JSON.stringify(tg.request.headers, null, 2));

if (tg.request.body) {
  console.log('Body:', tg.request.body);
}

Example: Modify Request Dynamically

// Add a dynamic header
tg.request.setHeader('X-Request-Id', crypto.randomUUID());

// Inject token from environment
const token = tg.environment.get('auth_token');
if (token) {
  tg.request.setHeader('Authorization', 'Bearer ' + token);
}

// Modify the URL dynamically
const baseUrl = tg.environment.get('base_url');
if (baseUrl) {
  tg.request.url = baseUrl + '/api/v2/users';
}

// Remove a header
tg.request.removeHeader('X-Debug');

Example: Validate Request Before Sending

// Check if required headers are present
if (!tg.request.headers['Authorization']) {
  console.warn('Warning: No Authorization header set');
}

// Validate JSON body structure
if (tg.request.body) {
  try {
    const body = JSON.parse(tg.request.body);
    if (!body.name) {
      console.error('Error: name field is required');
    }
  } catch (e) {
    console.error('Body is not valid JSON');
  }
}

Available APIs

Example: Inspect Response

// Log response information for debugging
console.log('Status:', tg.response.status, tg.response.statusText);
console.log('Headers:', JSON.stringify(tg.response.headers, null, 2));

// Parse JSON body using the built-in json() helper
const data = tg.response.json();
console.log('Response data:', data);

Example: Save Values to Environment

// Extract token from login response and save for subsequent requests
if (tg.response.status === 200) {
  const data = tg.response.json();
  tg.environment.set('auth_token', data.access_token);
  tg.environment.set('user_id', String(data.user.id));
  console.log('Token saved to environment');
}

Example: Validate Response Structure

// Validate the response matches expected structure
if (tg.response.status === 200) {
  const data = tg.response.json();

  if (!data.id) {
    console.error('Missing required field: id');
  }

  if (!Array.isArray(data.items)) {
    console.error('items should be an array');
  } else {
    console.log('Found', data.items.length, 'items');
  }
}

Example: Log Timing Information

// Analyze request performance
const timing = tg.response.timing;

console.log('Total time:', timing.total, 'ms');
console.log('DNS lookup:', timing.dns, 'ms');
console.log('TLS handshake:', timing.tls, 'ms');
console.log('Time to first byte:', timing.ttfb, 'ms');

Assertion Structure

Each assertion consists of up to four parts:

Summary Bar

At the bottom of the assertions panel, a summary shows the total count: "Results: X passed, Y failed". This appears only after a request has been sent.