Variables

Las variables te permiten usar valores dinámicos en tus archivos .rext. Se encierran en dobles llaves: {{nombreVariable}}.

Sintaxis

GET {{baseUrl}}/users
Authorization: Bearer {{token}}

Las variables se pueden usar en:

URLs — GET {{baseUrl}}/users
Headers — Authorization: Bearer {{token}}
Body — { "email": "{{email}}" }
Query parameters — @query search = {{searchTerm}}

Orden de Resolución

Built-in ($) — Variables dinámicas generadas en tiempo de ejecución
Sesión — Variables capturadas durante la sesión actual
Colección — Variables del scope de la colección actual
Entorno — Variables del archivo de entorno activo (rext.env.json)
Global — Variables disponibles en todos los archivos

Variables Dinámicas Built-in

Las variables built-in comienzan con $ y generan un valor nuevo cada vez que se ejecuta un request. Cada ocurrencia produce un valor único — dos {{$uuid}} en el mismo request generan dos UUIDs diferentes.

Timestamps

Variable	Descripción	Ejemplo
`{{$timestamp}}`	Unix epoch (segundos)	`1740583516`
`{{$timestampMs}}`	Unix epoch (milisegundos)	`1740583516000`
`{{$isoTimestamp}}`	ISO 8601 UTC	`2026-02-26T15:35:16.000Z`
`{{$localTimestamp}}`	Fecha/hora local	`2026-02-26 11:35:16`

Formateo de Fechas

Variable	Descripción	Ejemplo
`{{$date}}`	Fecha local YYYY-MM-DD	`2026-02-26`
`{{$date:DD/MM/YYYY}}`	Formato personalizado	`26/02/2026`
`{{$date:HH:mm:ss}}`	Solo hora	`11:35:16`
`{{$date:DD-MMM-YYYY}}`	Mes abreviado	`26-Feb-2026`
`{{$date:+7:YYYY-MM-DD}}`	Offset (+/- días)	`2026-03-05`

Tokens soportados: YYYY, MM, DD, HH, mm, ss, SSS, MMM (abreviado), MMMM (mes completo).

UUIDs

Variable	Descripción	Ejemplo
`{{$uuid}}`	UUID v4 (aleatorio)	`a1b2c3d4-e5f6-4a7b-...`
`{{$guid}}`	Alias de `$uuid`	`a1b2c3d4-e5f6-4a7b-...`
`{{$uuidV1}}`	UUID v1 (timestamp)	`6fa459ea-ee8a-1a3e-...`

Generadores Aleatorios

Variable	Descripción	Ejemplo
`{{$randomInt}}`	Entero 0–1000	`742`
`{{$randomInt:1:100}}`	Entero en rango	`37`
`{{$randomFloat}}`	Decimal 0–1 (2 decimales)	`0.73`
`{{$randomFloat:1:100:4}}`	Decimal con precisión	`42.8193`
`{{$randomString}}`	Alfanumérico (16 chars)	`aB3xK9mP2qR7wT1s`
`{{$randomString:32}}`	Longitud personalizada	`aB3xK9mP...`
`{{$randomHex:8}}`	String hexadecimal	`a3f2b1c0`
`{{$randomEmail}}`	Email aleatorio	`user-a3f2b@rext.dev`
`{{$randomBoolean}}`	`true` o `false`	`true`

Enum (Selección de Lista)

Variable	Descripción	Ejemplo
`{{$enum:a,b,c}}`	Valor aleatorio de la lista	`b`
`{{$enum:pending,active,closed}}`	Enums de APIs	`active`
`{{$enum:"hola, mundo","adiós",ok}}`	Comillas para valores con comas	`hola, mundo`

Metadata

Variable	Descripción	Ejemplo
`{{$env}}`	Nombre del entorno activo	`Production`

Ejemplo Completo

POST {{baseUrl}}/api/orders
Content-Type: application/json

{
  "id": "{{$uuid}}",
  "timestamp": {{$timestamp}},
  "deliveryDate": "{{$date:+30:YYYY-MM-DD}}",
  "priority": {{$randomInt:1:5}},
  "status": "{{$enum:pending,processing,shipped}}",
  "environment": "{{$env}}",
  "contactEmail": "{{$randomEmail}}"
}

Configurar Variables

1. Archivos de Entorno

Define variables en rext.env.json:

{
  "Development": {
    "baseUrl": "http://localhost:3000",
    "apiKey": "dev-key-123"
  },
  "Production": {
    "baseUrl": "https://api.production.com",
    "apiKey": "prod-key-456"
  }
}

Consulta Archivos de Entorno para más detalles.

2. Captura de Variables

Extrae valores de las respuestas usando @capture:

@name Login
POST {{baseUrl}}/auth/login

@capture token = body.access_token

Consulta Captura de Variables para más detalles.

Próximos Pasos

Configura Archivos de Entorno
Aprende sobre Captura de Variables