Guía de configuración: para qué sirve cada ajuste
Abre Configuración en Studio y encontrarás la explicación de cada opción justo debajo de su nombre. Esta página reúne esas mismas explicaciones en un solo lugar, para que puedas leerlas de antemano, buscar en ellas o pedirle a un asistente de IA que te las explique paso a paso.
Última actualización:
Cómo funciona la configuración
- Cambia y luego guarda. Edita lo que necesites y pulsa Guardar cambios. Un punto junto a un ajuste indica que se ha modificado, pero aún no se ha guardado.
- La mayoría de las personas cambia muy pocos ajustes. Cada ajuste tiene un valor predeterminado adecuado. Si tienes dudas, déjalo como está.
- Los secretos se quedan en tu equipo. Las contraseñas, los tokens y las claves se guardan en el archivo
.envde tu espacio de trabajo y se muestran como puntos. No se nos envía nada. - El nombre en gris es el nombre del ajuste en el archivo. Es la línea de
.env, por si lo configuras desde una canalización o un script.
Seguridad & autenticación
Inicio de sesión para pruebas de API.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Token de API o contraseñaAPI_AUTH_TOKEN | El secreto que verifica tu API, disponible en la página de tu cuenta del proveedor de la API; para Basic, escribe usuario:contraseña. Si está vacío, no se usa autenticación; los informes solo muestran sus primeros 4 caracteres. | Vacío. Se guarda solo en este equipo. |
Método de autenticación de la APIAPI_AUTH_TYPE | Cómo comprueba tu API quién realiza la llamada: Bearer envía un token, Basic un nombre de usuario y una contraseña, ApiKey una clave en un encabezado. El valor predeterminado es Bearer. | Bearer |
Nombre de la cabecera de la clave de APIAPI_AUTH_HEADER | Solo para ApiKey: el nombre del encabezado que contiene tu clave, como api-key. Déjalo vacío para usar X-Api-Key. | Empty |
Smart Monkey
Comprobaciones adicionales de seguridad de la API durante la exploración.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Comprobación pasiva de seguridad de la APINEXUS_API_AUDIT | Durante la exploración, lee las respuestas de API que tu aplicación ya recibe y señala puntos débiles, como filtraciones de datos, sin enviar nada adicional. Desactivada por defecto; úsala solo en aplicaciones que tengas permiso para probar. | false |
Comprobación de omisión del inicio de sesiónNEXUS_API_ACTIVE | Repite sin token de inicio de sesión las solicitudes de datos que tu aplicación hizo con él, para comprobar si el servidor sigue respondiendo. Solo realiza lecturas, pero envía solicitudes adicionales; está desactivado por defecto. | false |
Destinos & API
Direcciones de API, límites de velocidad y evidencias guardadas.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Dirección principal de la APIAPI_BASE_URL | La dirección base de las pruebas de API que solo tienen una ruta (como /users), p. ej. https://api.example.com. Déjala vacía: si introduces un valor, también se redirigirán a él todas las pruebas de API grabadas. | Empty |
Dirección de GraphQLAPI_GRAPHQL_URL | La dirección de tu servicio GraphQL (una API a la que solicitas exactamente los datos que quieres). Si está vacía, los ejemplos integrados de GraphQL consultan un servicio de demostración público, no el tuyo. | Empty |
Tiempo máximo de respuesta permitidoNEXUS_API_LATENCY_BUDGET | Tiempo máximo de respuesta de una API, en milisegundos (1000 = 1 segundo); las respuestas que lo superen se marcan como lentas. El valor predeterminado es 2000 (2 segundos). | 2000 |
Repeticiones de medición de tiempo por solicitudNEXUS_API_SAMPLES | Cantidad de veces que se envía cada solicitud de API para medir la velocidad de forma fiable (de 1 a 200); solo se comprueba la primera respuesta. El valor predeterminado es 20; redúcelo si las repeticiones afectan a tu servidor. | 20 |
Repetir solicitudes que modifican datosNEXUS_API_SAMPLE_WRITES | También repite las solicitudes que crean o modifican datos (POST, PUT, PATCH, DELETE). Desactivada por defecto, porque 20 repeticiones crearían 20 registros en tu servidor. | false |
Marcar como fallida si cambian las respuestasNEXUS_API_DRIFT_STRICT | Una respuesta que añade un campo o cambia un tipo de dato siempre se notifica como una desviación. Activa esta opción para que también falle la prueba; desactivada (por defecto), solo lo notifica. | false |
Ejecuciones de API exitosas conservadasNEXUS_API_EVIDENCE_KEEP | Cantidad de ejecuciones satisfactorias de cada prueba de API cuyas evidencias guardadas se conservarán; se eliminan las más antiguas, pero nunca las de ejecuciones fallidas. El valor predeterminado es 20; 0 conserva todas las ejecuciones. | 20 |
Tamaño máximo de respuesta guardadaNEXUS_API_BODY_MAX_KB | Tamaño máximo del cuerpo de solicitud o respuesta guardado en los archivos de evidencias, en KB; si lo supera, se recorta y se guarda con su tamaño completo y una huella digital. El valor por defecto es 256 KB. | 256 |
Marcar como fallida si las respuestas son lentasNEXUS_API_PERF_STRICT | Activa esta opción para que una prueba de API falle si la respuesta tarda más del tiempo permitido arriba. Desactivada (por defecto): una respuesta lenta solo genera una advertencia. | false |
Comprobar cabeceras de seguridad de la APINEXUS_API_SECURITY_HEADERS | Comprueba que las respuestas de la API incluyan las cabeceras de protección estándar (por ejemplo Content-Security-Policy); las que falten se señalan como recomendaciones y nunca hacen fallar una prueba por sí solas. Activado de forma predeterminada. | true |
Aplicación bajo prueba
Iniciar tu aplicación automáticamente antes de las ejecuciones.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Comando que inicia tu aplicaciónNEXUS_APP_START | Inicia tu aplicación antes de cada ejecución y la detiene después, p. ej. npm run dev; vacío = la inicias tú. Solo un comando: coloca las cadenas como && en un script de package.json. | Empty |
Carpeta de la aplicaciónNEXUS_APP_CWD | Ruta completa de la carpeta desde la que se inicia tu aplicación, donde está su package.json; si se deja vacía, se usa la carpeta de este espacio de trabajo. En un equipo remoto, es una carpeta de ese equipo. | Empty |
Dirección que indica que está listoNEXUS_APP_READY_URL | La dirección web que se comprueba cada medio segundo para saber si tu aplicación se ha iniciado; sirve cualquier respuesta que no sea un error del servidor. Si está vacía, se usa tu dirección principal de pruebas (BASE_URL). | Empty |
Límite de espera de inicioNEXUS_APP_TIMEOUT_MS | Tiempo de espera para que tu aplicación esté lista, en milisegundos (1000 = 1 segundo); si tarda más, la ejecución no se inicia. El valor predeterminado es 120000 (2 minutos). | 120000 |
Reutilizar una aplicación en ejecuciónNEXUS_APP_REUSE | Activado: si tu aplicación ya responde en la dirección de disponibilidad, se usa y se deja en ejecución; desactivado: la ejecución se detiene con un error para que nunca pruebes otra cosa por equivocación. Está activado de forma predeterminada. | true |
Ejecución & tiempos de espera
Cuántas pruebas se ejecutan y cuánto tiempo se espera.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Navegadores por pruebaNEXUS_PARALLEL_BROWSERS | Cantidad de navegadores que ejecutan una prueba al mismo tiempo, de 1 a 3; el valor predeterminado de 1 es el más seguro, 2 requiere unos 8 GB de memoria y 3 unos 16 GB. Una ejecución asignada a un solo navegador siempre usa uno. | 1 |
Pruebas simultáneasNEXUS_PARALLEL_TCS | Cantidad de pruebas que se ejecutan en paralelo en una ejecución completa, de 1 a 32; el valor predeterminado es 1 (una tras otra). Cada prueba adicional necesita unos 0.5 GB de memoria por navegador, así que auméntala solo en un PC potente. | 1 |
Reintentar pruebas fallidasNEXUS_RETRY_ENABLED | Una prueba fallida se ejecuta una vez más antes de notificarse, lo que descarta fallos puntuales. Desactiva esta opción para ver todos los fallos de inmediato; está activada por defecto. | true |
Tiempo límite por pruebaNEXUS_TC_TIMEOUT | Tiempo máximo que puede ejecutarse una prueba, en segundos, antes de detenerla a la fuerza. El valor predeterminado es 360 (6 minutos); la prueba se detiene por sí sola 1 minuto antes para guardar sus evidencias. | 360 |
Tiempo de espera para comprobacionesNEXUS_EXPECT_TIMEOUT | Tiempo que una comprobación (como "aparece este texto") espera para cumplirse, en milisegundos (1000 = 1 segundo); aumentarlo ayuda con páginas lentas sin ocultar errores. El valor predeterminado es 10000 (10 segundos). | 10000 |
Espera por clic o escrituraNEXUS_ACTION_TIMEOUT | Tiempo que un paso como hacer clic o escribir espera a que su elemento de destino esté listo, en milisegundos (1000 = 1 segundo). Auméntalo para páginas lentas; el valor predeterminado es 30000 (30 segundos). | 30000 |
Límite de tiempo de apertura de la páginaNEXUS_NAV_TIMEOUT | Tiempo máximo que puede tardar en abrirse una página antes de que falle el paso, en milisegundos (1000 = 1 segundo). El valor predeterminado es 60000 (1 minuto); auméntalo para sitios muy lentos. | 60000 |
Espera tras abrir la páginaNEXUS_LOAD_WAIT_MS | Tras abrir una página, espera hasta esta cantidad de milisegundos (1000 = 1 segundo) a que termine de cargarse para evitar clics prematuros. Nunca hace que falle una prueba; 0 omite la espera, el valor por defecto es 8000. | 8000 |
Marcar como fallida si faltan cabeceras de seguridadNEXUS_SECURITY_STRICT | Activa esta opción para que una prueba falle si las páginas de tu aplicación carecen de cabeceras de protección (como Content-Security-Policy). Desactivada (por defecto), solo lo indica en el informe; en una aplicación antigua, puede hacer que fallen todas las pruebas. | false |
Ubicación de FirefoxNEXUS_FIREFOX_BINARY | Ruta completa a firefox.exe, usada solo por las pruebas de Selenium; vacía = buscar en las ubicaciones habituales. Una ruta incorrecta se interpreta como ausencia de Firefox, por lo que se omiten esas pruebas de Selenium. | Empty |
Pruebas que fallan a propósitoNEXUS_FIXTURE_TCS | Identificadores de las pruebas diseñadas para fallar a propósito, separados por comas. Quedan fuera de la clasificación de riesgos salvo que solicites incluirlas; el campo está vacío de forma predeterminada. | Empty |
Selectores & autorreparación
Detección y reparación de selectores frágiles.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Advertencias sobre pasos frágilesNEXUS_SMART_SELECTORS | Al grabar o importar una prueba, Sugerir añade un comentario encima de cada paso que localiza elementos de forma poco robusta; Desactivado no añade ninguno. Las pruebas ya escritas no se modifican; el valor predeterminado es Sugerir. | suggest |
Sugerencias de reparación automáticaNEXUS_SELF_HEAL | Tras un fallo, prepara correcciones en un navegador en segundo plano (se omite si hay poca RAM o una ejecución en curso). Sugerir las muestra, Verificar también las prueba en 3 navegadores y Desactivado no hace nada. | suggest |
MLOps & predicción
Predecir qué pruebas son poco fiables.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Actualizar previsión de pruebas poco fiablesNEXUS_AUTO_PREDICT | Tras cada ejecución, actualiza la previsión de qué pruebas son poco fiables (a veces pasan, a veces fallan) para mantener actualizada la Clasificación de riesgos. Activada por defecto. | true |
Accesibilidad
Auditoría WCAG mediante axe-core.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Comprobar accesibilidadNEXUS_A11Y_ENABLED | Analiza las páginas en busca de barreras para personas con discapacidad, como un contraste bajo o la falta de etiquetas. Está desactivado por defecto; requiere el complemento @axe-core/playwright y, sin él, se omite el análisis. | false |
Normas de accesibilidadNEXUS_A11Y_STANDARD | Selecciona las pautas de accesibilidad (WCAG) para el análisis: versión 2.0, 2.1 o 2.2, en nivel A (básico) o AA (estándar). El valor predeterminado, 2.1 AA, es el requisito legal mínimo habitual en Europa. | wcag21aa |
Gravedad mínima de los problemasNEXUS_A11Y_FAIL_LEVEL | Gravedad mínima de un problema (leve, moderada, grave, crítica) para que cuente como infracción. El valor predeterminado es grave; solo se aplica si 'Marcar la prueba como fallida si hay una infracción' está activado. | serious |
Marcar la prueba como fallida si hay una infracciónNEXUS_A11Y_STRICT | Si está activada, una prueba que detecte un problema con una gravedad igual o superior a la mínima se marca como fallida (A11Y_VIOLATION). Desactivada por defecto: los problemas solo se enumeran en el informe. | false |
Performance
Presupuestos de Core Web Vitals.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Medir la velocidad de la páginaNEXUS_PERF_ENABLED | Mide la rapidez con la que cada página carga y reacciona (Core Web Vitals) y la compara con los límites de abajo. Está activado de forma predeterminada; solo añade datos y nunca hace que una prueba falle, a menos que esté activada la opción 'Fallar si las páginas son lentas'. | true |
Límite de carga del contenido principalNEXUS_PERF_LCP | Tiempo máximo, en milisegundos (1000 = 1 segundo), hasta que aparece el contenido principal de una página. El valor predeterminado es 2500 (2.5 segundos), el umbral de Google para considerarlo 'bueno'; auméntalo para sitios lentos. | 2500 |
Límite de carga del primer contenidoNEXUS_PERF_FCP | Tiempo máximo, en milisegundos (1000 = 1 segundo), hasta que la página muestra su primer texto o imagen. El valor predeterminado es 1800 (1.8 segundos), el umbral de Google para considerarlo 'bueno'; auméntalo para sitios lentos. | 1800 |
Límite de saltos de la páginaNEXUS_PERF_CLS | Cuánto puede desplazarse el contenido de la página durante la carga, expresado como una puntuación en la que 0 significa una estabilidad perfecta. El valor predeterminado es 0.1, el umbral de Google para 'bueno'; un número menor es más estricto. | 0.1 |
Límite de elementos de la páginaNEXUS_PERF_DOM | Cantidad máxima de elementos (botones, bloques de texto, imágenes) que puede tener una página antes de marcarla como pesada para dispositivos lentos. El valor predeterminado es 1500. | 1500 |
Límite de memoria de la páginaNEXUS_PERF_HEAP | Cantidad máxima de memoria, en MB, que pueden usar los scripts de una página antes de que esta se marque. El valor predeterminado es 50 MB; solo se mide en navegadores basados en Chromium, como Chrome y Edge. | 50 |
Límite de respuesta al clicNEXUS_PERF_INP | Tiempo máximo, en milisegundos (1000 = 1 segundo), que puede tardar una página en reaccionar tras un clic o un toque. El valor predeterminado es 200, el umbral de Google para considerarlo 'bueno'; auméntalo para sitios lentos. | 200 |
Límite de bloqueo de la páginaNEXUS_PERF_TBT | Tiempo máximo, en milisegundos (1000 = 1 segundo), que una página puede permanecer bloqueada e ignorar los clics durante la carga. El valor predeterminado es 200, el umbral de Lighthouse (la herramienta de auditoría de Google) para considerarlo 'bueno'. | 200 |
Límite de respuesta del servidorNEXUS_PERF_TTFB | Tiempo máximo, en milisegundos (1000 = 1 segundo), hasta que el servidor empieza a enviar la página. El valor predeterminado es 800; los resultados lentos suelen apuntar al servidor, no al diseño de la página. | 800 |
Tolerancia a la ralentizaciónNEXUS_PERF_TOLERANCE | Cuánto puede ralentizarse una página respecto a sus propios resultados anteriores antes de que Evidence Locker señale una regresión. El valor predeterminado de 1.25 significa un 25% más lenta; los valores de 1 o menos se sustituyen por 1.25. | 1.25 |
Marcar como fallida si las páginas son lentasNEXUS_PERF_STRICT | Si está activada, una página que supere cualquiera de los límites de velocidad anteriores hace que la prueba se marque como fallida (PERFORMANCE_DEGRADED). Desactivada por defecto: las páginas lentas solo se registran en el informe. | false |
Comprobar carga de imágenesNEXUS_LAZY_ENABLED | Comprueba que las imágenes se carguen de forma que las páginas sigan siendo rápidas, por ejemplo sin retrasar la imagen principal. Activado de forma predeterminada, requiere activar la medición de velocidad y asigna una puntuación de 0 a 100 sin hacer fallar las pruebas. | true |
Límite de imágenes en la carga inicialNEXUS_LAZY_MAX_INITIAL_IMG_KB | Cantidad máxima de datos de imágenes, en KB (1000 KB equivalen aproximadamente a 1 MB), que puede descargar una página al abrirse por primera vez antes de que la comprobación la marque. El valor predeterminado es 1000 KB. | 1000 |
Marcar como fallida si hay problemas con las imágenesNEXUS_LAZY_STRICT | Si está activada, una prueba se marca como fallida (PERFORMANCE_DEGRADED) si la imagen principal se retrasa deliberadamente o las imágenes de la carga inicial superan el límite anterior. Desactivada por defecto: solo se informa. | false |
Pruebas de carga
Límites para pruebas de estrés de tráfico.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Límite de tiempo de respuestaNEXUS_LOAD_P95 | En una ejecución de carga, el 95% de las solicitudes deben completarse en este número de milisegundos (1000 = 1 segundo). Si se deja vacío, no hay límite y el resultado indica 'no evaluado'; el límite propio del escenario tiene prioridad. | Empty |
Porcentaje de errores permitidoNEXUS_LOAD_ERROR_RATE | Cantidad máxima de solicitudes fallidas que puede tener una ejecución de carga, como porcentaje de 0 a 100 (5 significa que pueden fallar 5 de cada 100). Si se deja vacío, no hay límite; el límite propio de cada escenario tiene prioridad sobre este. | Empty |
Marcar la ejecución como fallida si no se cumple un límiteNEXUS_LOAD_STRICT | Si está activada, una ejecución de carga que supere su límite de tiempo de respuesta o de errores termina como fallida, lo que detiene las compilaciones automatizadas. Desactivada por defecto: solo se informa del resultado. | false |
Cantidad de procesos de cargaNEXUS_LOAD_POOL | Cantidad de procesos en segundo plano que generan el tráfico en una ejecución de carga. Si se deja vacío, se usa uno por núcleo del procesador, sin superar nunca el número de usuarios simulados; cada uno consume unos 80 MB en Windows. | Empty |
Hardware & ritmo
Ralentizar las pruebas en equipos con poca memoria.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Regular el ritmo de las pruebas según la RAM libreNEXUS_HW_MONITOR_ENABLED | Si está activada, la aplicación espera más entre pruebas y ejecuta menos a la vez cuando queda poca RAM libre. Desactivada por defecto (espera fija); actívala en equipos de poca capacidad o con mucha actividad. | false |
Espera entre pruebasNEXUS_HW_FIXED_PAUSE_MS | Espera entre pruebas en ejecuciones de varias pruebas, en milisegundos (1000 = 1 segundo), con el ajuste del ritmo según la RAM desactivado. El valor predeterminado es 2000 (2 segundos); las ejecuciones de una sola prueba nunca esperan. | 2000 |
Límite de RAM del PC de recursos mínimosNEXUS_HW_CRITICAL_GB | Los equipos con menos RAM total que este valor, en GB, se consideran muy pequeños y tienen la espera más larga entre pruebas. El valor predeterminado es 4; solo se usa cuando está activado el ajuste de pausas según la RAM. | 4 |
Límite de RAM para equipos de pocos recursosNEXUS_HW_LIMITED_GB | Los equipos con menos RAM total que este valor, en GB, se consideran pequeños. El valor predeterminado es 8; solo se usa cuando está activado el ajuste de pausas según la RAM y debe ser mayor que el límite para equipos muy pequeños. | 8 |
Límite de RAM para equipos estándarNEXUS_HW_NORMAL_GB | Los equipos con menos RAM total que este valor, en GB, se consideran estándar; por encima de este valor se consideran potentes y tienen la espera más corta. El valor predeterminado es 16; solo se usa cuando está activado el ajuste de pausas según la RAM. | 16 |
Espera con abundante RAM libreNEXUS_PAUSE_LOW_MS | Espera entre pruebas, en milisegundos (1000 = 1 segundo), cuando la mayor parte de la RAM está libre. 0 (por defecto) aplica una espera predefinida de 1 a 3 segundos según la capacidad del equipo, no elimina la espera; solo se usa con el ajuste del ritmo según la RAM activado. | 0 |
Espera con uso moderado de RAMNEXUS_PAUSE_MEDIUM_MS | Espera entre pruebas, en milisegundos (1000 = 1 segundo), cuando el uso de RAM es moderado. 0 (por defecto) aplica una espera predefinida de 2 a 8 segundos según la capacidad del equipo, no elimina la espera; solo se usa con el ajuste del ritmo según la RAM activado. | 0 |
Espera con poca RAM libreNEXUS_PAUSE_HIGH_MS | Espera entre pruebas, en milisegundos (1000 = 1 segundo), cuando queda poca RAM libre. 0 (por defecto) aplica una espera predefinida de 4 a 15 segundos según la capacidad del equipo, no elimina la espera; solo se usa con el ajuste del ritmo según la RAM activado. | 0 |
Espera con RAM llenaNEXUS_PAUSE_CRITICAL_MS | Espera entre pruebas, en milisegundos (1000 = 1 segundo), cuando la RAM está casi llena. 0 (por defecto) aplica una espera predefinida de 8 a 25 segundos según la capacidad del equipo, no elimina la espera; solo se usa con el ajuste del ritmo según la RAM activado. | 0 |
Devices & Mobile
Teléfonos para probar y emular.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Puerto de conexión del teléfonoNEXUS_DEVICE_CDP_PORT | El número de puerto de red que usa tu equipo para comunicarse con Chrome en un teléfono Android conectado. Cámbialo solo si otro programa ya usa el 9333, el valor predeterminado. | 9333 |
ID de la aplicación de navegador del teléfonoNEXUS_DEVICE_CHROME_PKG | El ID de aplicación del navegador que se probará en un teléfono Android conectado. Cámbialo solo si el teléfono usa otro navegador; el predeterminado es Chrome normal (com.android.chrome). | com.android.chrome |
Controlar el teléfono desde el PCNEXUS_MIRROR_CONTROL | Te permite tocar y escribir en el teléfono desde la ventana que refleja su pantalla en tu ordenador. Desactívalo para que la ventana sea de solo visualización e ignore tus clics; está activado de forma predeterminada. | true |
Teléfono de gama alta que se va a imitarNEXUS_TIER_HIGH_DEVICE | El modelo de teléfono que se imita en las ejecuciones de gama alta: tamaño de pantalla, identidad del navegador y funciones táctiles. Es una simulación en el motor de Safari, no un iPhone físico; el modelo predeterminado es iPhone 13. | iPhone 13 |
Teléfono de gama media que se simularáNEXUS_TIER_MID_DEVICE | El modelo de teléfono que se imita en las ejecuciones móviles estándar: tamaño de pantalla, identidad del navegador y función táctil. Elige un teléfono Android; el predeterminado es Pixel 5. | Pixel 5 |
Teléfono de gama baja que se simularáNEXUS_TIER_LOW_DEVICE | El modelo de teléfono que se imita en las ejecuciones de gama baja, que también ralentizan el procesador. Elige un teléfono Android; si lo dejas vacío, se usa un teléfono económico predefinido (Nokia 1). | Empty |
Factor de ralentización de gama bajaNEXUS_CPU_THROTTLE_RATE | Factor de ralentización del procesador en las pruebas de teléfonos de gama baja, para imitar un teléfono poco potente. Usa de 2 a 20 (cuanto mayor sea el valor, más lento); el valor predeterminado es 4, solo en navegadores basados en Chrome. | 4 |
Red lentaNEXUS_NETWORK_PROFILE | Ejecuta cada prueba con una conexión más lenta para ver cómo funciona tu sitio con una señal móvil débil: off (predeterminado), fast-4g, slow-4g, slow-3g u offline. Solo para navegadores basados en Chrome y teléfonos Android reales. | desactivado |
Evidencias & conservación
Qué evidencias guardar y durante cuánto tiempo.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Grabar vídeos de fallosNEXUS_VIDEO_ENABLED | Graba un vídeo de cada prueba para conservarlo si falla. Desactívalo para ahorrar recursos del equipo y espacio en disco, pero ningún fallo tendrá vídeo; está activado por defecto. | true |
Fallos de los que se conserva el vídeoNEXUS_VIDEO_VERDICTS | Elige qué resultados conservan su vídeo: fallidos, fallidos tras reintentos, fallidos bajo caos, con tiempo agotado o bloqueados. Si se deja vacío o se elige ninguno, no se conserva ningún vídeo; por defecto se conservan los de los tres primeros. | BREACHED,BREACHED_FLAKY,CHAOS_BREACHED |
Grabar reproducción paso a pasoNEXUS_TRACE_ENABLED | Registra cada acción y estado de página de cada prueba y guarda la reproducción con el informe de error si falla. Desactívalo en un equipo de pocos recursos para ahorrar capacidad de procesamiento; está activado por defecto. | true |
Informes de errores conservados por pruebaNEXUS_BUGREPORT_RETAIN | Cantidad de informes de fallos que se conservarán por cada prueba y navegador. Los más antiguos se eliminan definitivamente, así que aumenta este valor si necesitas un historial más largo; el valor predeterminado es 20. | 20 |
Capturas de pantalla de pruebas exitosas conservadasNEXUS_PASSED_RETAIN | Cantidad de capturas de pantalla de ejecuciones satisfactorias que se conservarán por cada prueba y navegador. Las más antiguas se eliminan definitivamente; el valor predeterminado es 5. | 5 |
Sesiones de Smart Monkey conservadasNEXUS_MONKEY_RETAIN | Cantidad de sesiones de Smart Monkey (clics y escritura aleatorios en tu aplicación) que se conservarán. Las sesiones más antiguas se eliminan definitivamente; el valor predeterminado es 10. | 10 |
Registros de ejecución conservadosNEXUS_RUN_CONTEXT_RETAIN | Cantidad de ejecuciones para las que se conserva un registro de aquello contra lo que se realizaron las pruebas, junto con el registro de la aplicación. Los registros más antiguos se eliminan definitivamente; el valor predeterminado es 100. | 100 |
Conservar evidencias de pruebas superadas tras recuperarse de un falloNEXUS_RECOVERED_RETAIN | Guarda una captura de pantalla y notas de las pruebas que solo se superaron tras un reintento o después de que la aplicación reparara por sí sola un elemento de página modificado. Desactívalo para no guardar nada de ellas; está activado por defecto. | true |
Límite total de evidencias (GB)NEXUS_EVIDENCE_MAX_GB | El espacio máximo en disco que pueden ocupar todas las evidencias. Tras cada ejecución, las más antiguas se eliminan definitivamente, empezando por las ejecuciones correctas, pero cada prueba conserva su ejecución más reciente; el valor predeterminado es 20 GB. | 20 |
Espacio libre en disco que se debe mantener (GB)NEXUS_MIN_FREE_GB | El espacio libre que debe conservar tu disco. Por debajo de este valor, las evidencias más antiguas se eliminan definitivamente, incluso sin alcanzar el límite total (0 desactiva esta opción); el valor predeterminado es 10 GB. | 10 |
Longitud del historial de ejecucionesNEXUS_HISTORY_RETAIN | Cantidad de resultados anteriores que se conservarán por cada prueba y navegador para generar tendencias y gráficos. Auméntala si una prueba se ejecuta muchas veces al día; el valor predeterminado es 50. | 50 |
Privacidad & sigilo
Bloqueo de anuncios y ocultación de la automatización a los sitios.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Ocultar que las pruebas están automatizadasNEXUS_STEALTH_ENABLED | Hace que el navegador de pruebas parezca el de una persona real, para que los sitios que bloquean bots le permitan acceder. No se usa en los análisis de seguridad ni en un teléfono físico; está desactivado de forma predeterminada. | false |
Bloquear anuncios durante las pruebasNEXUS_BLOCK_ADS | Impide que se carguen redes publicitarias mientras grabas y ejecutas pruebas, para que los anuncios emergentes no tapen los botones. Tu propia aplicación nunca se bloquea; está activado por defecto y los análisis de seguridad no lo utilizan. | true |
Reports
Informe ejecutivo en PDF/HTML.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Nombre de la empresa en los informesORG_ID | El nombre de la organización que aparece en tus informes PDF. Studio lo obtiene de tu perfil la primera vez que lo abres; si lo dejas vacío, se usa el nombre de tu equipo. | Empty |
Idioma del informeNEXUS_PDF_LANGUAGE | El idioma del informe de resumen imprimible que se genera tras una ejecución completa. Elige inglés (en) o español (es); el predeterminado es inglés. | en |
Nombre de firma en los informesNEXUS_QA_ENGINEER_NAME | El nombre que aparece en la sección de aprobación de tus informes. Indica la persona que aprueba los resultados; el valor predeterminado es Ingeniero de calidad. | QA Engineer |
Notifications
Alertas de Telegram, Slack y Teams por prueba.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Alerta de Telegram por falloNEXUS_TELEGRAM_NOTIFY | Envía un mensaje a Telegram por cada prueba que falla. Solo funciona si Telegram también está activado y conectado más abajo; está desactivado por defecto para que activar Telegram no te sature de mensajes. | false |
Alerta de Slack por cada falloNEXUS_SLACK_NOTIFY | Envía un mensaje a Slack por cada prueba fallida, inestable, de caos o de cambios visuales. Solo funciona si Slack también está activado y conectado más abajo; está desactivado por defecto. | false |
Alerta de Telegram al superar pruebasNEXUS_NOTIFY_ON_PASS | También envía un mensaje de Telegram cuando una prueba pasa. Requiere que las alertas de fallos de Telegram también estén activadas y genera muchos avisos en conjuntos de pruebas grandes; está desactivada por defecto. | false |
Alerta de Teams por falloNEXUS_TEAMS_NOTIFY | Envía un mensaje de Microsoft Teams por cada prueba fallida, inestable, de caos o con cambios visuales. Solo funciona si Teams también está activado y conectado más abajo; está desactivado de forma predeterminada. | false |
Integraciones
Slack, Teams, Jira, Azure DevOps, GitHub Issues, Telegram.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Enviar alertas a TelegramTELEGRAM_ENABLED | Activa el envío de resúmenes de pruebas y archivos que compartes a Telegram, un servicio externo. Está desactivada por defecto; mantenla así si tu empresa no permite que los datos salgan de este equipo. | false |
Código de acceso del bot de TelegramTELEGRAM_TOKEN | El código secreto de tu propio bot de Telegram (una cuenta auxiliar gratuita). Consíguelo enviando /newbot a @BotFather en Telegram; se guarda en este equipo y nunca se comparte. | Vacío. Se guarda solo en este equipo. |
Chat de Telegram para alertasTELEGRAM_CHAT_ID | El número que identifica el chat de Telegram que recibe las alertas. Se rellena automáticamente cuando escaneas el código QR con Conectar en Configuración → Integraciones. | Empty |
Crear incidencias en Jira para los fallosJIRA_ENABLED | Crea una incidencia de error en Jira cuando falla una prueba y la actualiza en ejecuciones posteriores. Se activa automáticamente al guardar Jira Connect, donde pegas cualquier enlace de tu Jira. | false |
Dirección del sitio de JiraJIRA_BASE_URL | La dirección web de tu Jira, como https://yourteam.atlassian.net. Se rellena automáticamente cuando pegas cualquier enlace de tu Jira en Conectar. | Empty |
Correo electrónico de inicio de sesión en JiraJIRA_EMAIL | La dirección de correo electrónico que usas para iniciar sesión en Jira. Se introduce en Conectar Jira junto con el token de acceso. | Empty |
Token de acceso de JiraJIRA_API_TOKEN | Un código similar a una contraseña que permite a Studio usar tu cuenta de Jira. Créalo en tu cuenta de Atlassian, en Seguridad → Tokens de API; se guarda en este equipo y nunca se comparte. | Vacío. Se guarda solo en este equipo. |
Proyecto de Jira para incidencias de tipo BugJIRA_PROJECT_KEY | El código corto que precede a cada número de incidencia del proyecto, como QA en QA-123. Se rellena cuando seleccionas el proyecto en Conectar Jira. | QA |
Estado en Jira cuando la prueba se superaJIRA_DONE_TRANSITION | El estado al que pasa un Error cuando su prueba vuelve a superarse en todos los navegadores, como Hecho. Si está vacío, se usa Hecho; si tu Jira no tiene ese estado, Studio solo añade un comentario. | Listo |
Adjuntar grabación completa a las incidenciasNEXUS_ISSUE_ATTACH_TRACE | Añade la grabación técnica y el registro sin procesar a las incidencias de Jira y Azure. Está desactivada por defecto, porque pueden contener cookies y contraseñas introducidas que cualquier persona del proyecto podría consultar. | false |
Búsqueda en Jira de errores no detectadosNEXUS_JIRA_ESCAPED_JQL | Un filtro de búsqueda de Jira que encuentra errores que llegaron a producción, como status = Done AND labels = production. Si se deja vacío, las métricas de errores no detectados muestran "sin configurar". | Empty |
Crear elementos de trabajo en Azure para los fallosAZURE_BOARDS_ENABLED | Crea un elemento de trabajo en Azure Boards (una incidencia) cuando falla una prueba y lo actualiza en las ejecuciones posteriores. Se activa automáticamente al guardar Conectar Azure DevOps. | false |
Dirección de la organización de Azure DevOpsAZURE_DEVOPS_ORG_URL | La dirección web de tu organización, como https://dev.azure.com/yourcompany. Se rellena automáticamente cuando pegas cualquier enlace de Azure DevOps en Conectar. | Empty |
Nombre del proyecto de Azure DevOpsAZURE_DEVOPS_PROJECT | El proyecto de tu organización que recibe los elementos de trabajo y ejecuta la canalización. Se rellena cuando lo seleccionas en Conectar Azure DevOps. | Empty |
Token de acceso de Azure DevOpsAZURE_DEVOPS_PAT | Un código similar a una contraseña (token de acceso personal) para tu cuenta de Azure, creado en Configuración de usuario → Tokens de acceso personal. Se guarda en este equipo y nunca se comparte. | Vacío. Se guarda solo en este equipo. |
Tipo de incidencia de Azure para fallosAZURE_BOARDS_WORK_ITEM_TYPE | El tipo de elemento de trabajo que se crea ante un fallo, como Error. Debe existir en tu proyecto; si lo dejas vacío, se usa Error. | Bug |
Estado de Azure cuando la prueba pasaAZURE_BOARDS_DONE_STATE | El estado al que pasa un elemento de trabajo cuando su prueba vuelve a superarse, como Resuelto. Si está vacío, se usa Resuelto; si tu proyecto lo rechaza, Studio solo añade un comentario. | Resolved |
Canalización de Azure para ejecutar en CIAZURE_PIPELINE_ID | El número de la canalización de Azure que inicia Ejecutar en CI. Abre la canalización en Azure DevOps y copia el número que aparece después de definitionId= en la barra de direcciones. | Empty |
Enviar alertas a SlackSLACK_ENABLED | Publica fallos de pruebas, resúmenes y otras alertas en Slack. Está desactivado por defecto; se activa al guardar Slack Connect, que permite enviar un mensaje de prueba. | false |
Canal de Slack para alertasSLACK_WEBHOOK_URL | Un enlace privado de Slack que permite a Studio publicar en un canal. Créalo en Slack → Tus aplicaciones → Webhooks entrantes; se guarda en este equipo y nunca se comparte. | Vacío. Se guarda solo en este equipo. |
Enviar alertas a Microsoft TeamsTEAMS_ENABLED | Publica fallos y resúmenes de pruebas en un canal de Teams. Está desactivado de forma predeterminada: al guardar el webhook de Teams se activa y permite enviar un mensaje de prueba. | false |
Canal de Teams para alertasTEAMS_WEBHOOK_URL | Un enlace privado (un webhook) que permite a Studio publicar en un canal de Teams. Créalo en el menú ··· del canal → Flujos de trabajo → “Publicar en un canal cuando se recibe una solicitud de webhook”. | Vacío. Se guarda solo en este equipo. |
Crear incidencias en GitHub para los fallosGITHUB_ISSUES_ENABLED | Abre una incidencia en GitHub cuando falla una prueba, añade un comentario cuando vuelve a fallar y la cierra cuando la prueba se supera. Se activa al guardar la tarjeta de GitHub Issues. | false |
Token de acceso de GitHubGITHUB_ISSUES_TOKEN | Un código similar a una contraseña (token) que permite a Studio abrir incidencias en un repositorio. Créalo en GitHub con el permiso Incidencias configurado en Lectura y escritura; se guarda en este equipo. | Vacío. Se guarda solo en este equipo. |
Repositorio de GitHub para incidenciasGITHUB_ISSUES_REPO | El repositorio que recibe las incidencias, escrito como propietario/repositorio, por ejemplo, acme/web. Elígelo de la lista en la tarjeta de GitHub Issues. | Empty |
Enviar incidencias a tu propio sistemaTICKETS_HOOK_ENABLED | Envía cada prueba fallida a una dirección web que controlas, como mensaje firmado, para que tu propia herramienta pueda abrir la incidencia. Desactivado de forma predeterminada; también requiere un destino «webhook» (una entrada en la configuración de incidencias). | false |
Dirección de tu sistema de incidenciasTICKETS_WEBHOOK_URL | La dirección web https que recibe cada incidencia como mensaje. Se guarda en este equipo y no vuelve a mostrarse después de guardarla. | Vacío. Se guarda solo en este equipo. |
Contraseña de firma para tus incidenciasTICKETS_WEBHOOK_SECRET | Una contraseña de al menos 16 caracteres. Cada mensaje se firma con ella para que tu sistema pueda comprobar que realmente procede de aquí. | Vacío. Se guarda solo en este equipo. |
Token de GitHub para CI/CDGITHUB_CI_TOKEN | Un código tipo contraseña (token) que guarda tus secretos de CI en GitHub sin el programa gh. Dale Secrets: Read and write; vacío usa gh. | Vacío. Se guarda solo en este equipo. |
Ejecución & otros
Claves de terceros para herramientas externas.
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
Clave de API de ApolloAPOLLO_API_KEY | Clave para el servicio de contactos comerciales de Apollo.io, creada en la configuración de tu cuenta de Apollo, en API. Nada en Nexus Studio la utiliza, así que déjala vacía salvo que tus propias herramientas la lean. | Vacío. Se guarda solo en este equipo. |
Orientación del teléfonoNEXUS_EMU_ORIENTATION | Vertical u horizontal para cada ejecución en el teléfono. Si se deja vacío, se mantiene la orientación vertical predeterminada. | Empty |
Ubicación del teléfonoNEXUS_EMU_GEO | La ubicación que comunica el teléfono, en formato latitud,longitud (por ejemplo, 4.711,-74.0721). La página la obtiene sin pedir permiso. | Empty |
Idioma del teléfonoNEXUS_EMU_LOCALE | El idioma y la región que comunica el teléfono, como es-CO o pt-BR. Si se deja vacío, se mantienen los del teléfono. | Empty |
Zona horaria del teléfonoNEXUS_EMU_TIMEZONE | La zona horaria que comunica el teléfono, como America/Bogota. Si se deja vacío, se mantiene la de este equipo. | Empty |
Modo oscuro del teléfonoNEXUS_EMU_COLOR_SCHEME | light, dark o no-preference: el ajuste de color del teléfono que detecta la página. | Empty |
Movimiento reducido del teléfonoNEXUS_EMU_REDUCED_MOTION | reduce hace que la página detecte un teléfono configurado para mostrar menos animaciones; no-preference desactiva ese ajuste. | Empty |
Abrir incidencias en Linear en caso de falloLINEAR_ENABLED | Abre una incidencia en Linear por cada prueba fallida, añade un comentario si vuelve a fallar y la cierra cuando la prueba se supera. Desactivado de forma predeterminada; también requiere un destino «linear» en la configuración de incidencias. | false |
Clave de API de LinearLINEAR_API_KEY | Una clave de API personal de Linear (Configuración → Seguridad y acceso → Claves de API personales). Se guarda en este equipo y no vuelve a mostrarse después de guardarla. | Vacío. Se guarda solo en este equipo. |
Equipo de LinearLINEAR_TEAM_ID | El identificador del equipo de Linear que recibe las incidencias. Cada destino puede especificar otro equipo mediante un ajuste propio. | Empty |
Abrir incidencias en GitLab en caso de falloGITLAB_ISSUES_ENABLED | Abre una incidencia en GitLab por cada prueba fallida, añade una nota si vuelve a fallar y la cierra cuando la prueba se supera. Desactivado de forma predeterminada; también requiere un destino «gitlab» en la configuración de incidencias. | false |
Token de GitLab para incidenciasGITLAB_ISSUES_TOKEN | Un token de acceso de GitLab con el ámbito api. Solo se envía por https a tu instancia de GitLab, se guarda en este equipo y no vuelve a mostrarse después de guardarlo. | Vacío. Se guarda solo en este equipo. |
Proyecto de GitLab para incidenciasGITLAB_ISSUES_PROJECT | El proyecto que recibe las incidencias: su número o su ruta, como group/name. La dirección de GitLab es la que usa CI/CD (gitlab.com de forma predeterminada). | Empty |
Avisar al personal de guardia en PagerDutyPAGERDUTY_ENABLED | Activa una alerta en PagerDuty por cada prueba fallida y la resuelve cuando la prueba vuelve a superarse. Desactivado de forma predeterminada; también requiere un destino «pagerduty» en la configuración de incidencias. | false |
Clave de integración de PagerDutyPAGERDUTY_ROUTING_KEY | La clave de integración de Events API v2 del servicio de PagerDuty al que se enviarán las alertas. Se guarda en este equipo y no vuelve a mostrarse después de guardarla. | Vacío. Se guarda solo en este equipo. |
Alertar al personal de guardia en OpsgenieOPSGENIE_ENABLED | Abre una alerta en Opsgenie por cada prueba fallida, añade una nota si vuelve a fallar y la cierra cuando la prueba se supera. Desactivado de forma predeterminada; también requiere un destino «opsgenie». | false |
Clave de API de OpsgenieOPSGENIE_API_KEY | Una clave de API de Opsgenie con permiso para crear y cerrar alertas. Se guarda en este equipo y no vuelve a mostrarse después de guardarla. | Vacío. Se guarda solo en este equipo. |
Región de OpsgenieOPSGENIE_API_URL | https://api.opsgenie.com, o https://api.eu.opsgenie.com si tu cuenta de Opsgenie está alojada en la UE. | https://api.opsgenie.com |
Enviar resultados a TestRailTESTRAIL_ENABLED | Al finalizar cada ejecución, crea una ejecución en TestRail con todas las pruebas que indican su caso (mediante un comentario // nexus:testrail C123) y publica si se han superado o han fallado. Desactivado de forma predeterminada. | false |
Dirección de TestRailTESTRAIL_URL | Tu sitio de TestRail, como https://yourcompany.testrail.io. Solo se admite https. | Empty |
Usuario de TestRailTESTRAIL_USER | El correo electrónico de la cuenta de TestRail que publica los resultados. | Empty |
Clave de API de TestRailTESTRAIL_API_KEY | Una clave de API de esa cuenta de TestRail (Mi configuración → Claves de API). Se guarda en este equipo y no vuelve a mostrarse después de guardarla. | Vacío. Se guarda solo en este equipo. |
Proyecto de TestRailTESTRAIL_PROJECT_ID | El número del proyecto de TestRail al que se envían las ejecuciones (la P de su dirección, sin la P). | Empty |