# Configurar un proxy en Playwright

Source: https://ipvolt.com/es/guides/playwright-proxy-setup
Markdown: https://ipvolt.com/es/guides/playwright-proxy-setup.md
Language: es

[Inicio de ipvolt](https://ipvolt.com/es.md) / [Guías](https://ipvolt.com/es/guides.md) / Configurar un proxy en Playwright

Integración
Revisado: 2026-09-10
4 min de lectura
Por ipvolt

Configura un proxy HTTP autenticado en un contexto de navegador de Playwright, aísla el estado de la prueba y diagnostica la navegación por separado de los subrecursos.

## El punto de partida

Enruta una prueba de navegador controlada a través de un proxy manteniendo las credenciales, el estado del navegador y los fallos de navegación fáciles de analizar.

## Elige el alcance de la prueba

Playwright admite un proxy al lanzar el navegador o en un contexto de navegador individual. Usa un contexto para un escenario aislado. El nombre de usuario y la contraseña del proxy son independientes de httpCredentials, que autentica ante un sitio web.

En un proyecto de ejemplo de Node.js, instala playwright y su navegador Chromium con npm install playwright seguido de npx playwright install chromium. Establece PROXY_URL con tu gateway HTTP(S) real; https://proxy.example.invalid:8443 es una ilustración. Inyecta PROXY_USERNAME y PROXY_PASSWORD de forma privada.

## Ejecuta una navegación acotada

Guárdalo como proxy-browser.mjs y ejecuta node proxy-browser.mjs. Este ejemplo usa autenticación con nombre de usuario y contraseña para un proxy HTTP(S); no des por hecho que estas opciones de autenticación también funcionan con un gateway SOCKS.

### proxy-browser.mjs · Playwright Chromium

```javascript
import { chromium } from 'playwright';

function required(name) {
  const value = process.env[name];
  if (!value) throw new Error('Missing environment variable: ' + name);
  return value;
}

const proxy = {
  server: required('PROXY_URL'),
  username: required('PROXY_USERNAME'),
  password: required('PROXY_PASSWORD'),
};
const browser = await chromium.launch({ timeout: 30_000 });
try {
  const context = await browser.newContext({ proxy });
  context.setDefaultTimeout(15_000);
  context.setDefaultNavigationTimeout(30_000);
  const page = await context.newPage();
  const response = await page.goto('https://example.com/', {
    waitUntil: 'domcontentloaded',
  });
  if (!response || !response.ok()) throw new Error('Navigation did not succeed');
  console.log({ status: response.status() });
  await context.close();
} finally {
  await browser.close();
}
```

## Separa el éxito de la página del éxito de la red

Una respuesta de navegación describe el documento principal, no cada imagen, script o petición a una API que hace la página. Para una prueba real, comprueba la pantalla o la respuesta exacta de la que depende tu flujo de trabajo. Usa una página que controles y mantén la comprobación ligada a un único resultado observable.

Una sola página puede generar muchas peticiones. Si tu proveedor rota en cada petición, confirma cómo gestiona esas conexiones antes de esperar una única salida estable durante todo un flujo de navegador. Las cookies siguen siendo estado del navegador; elegir un proxy con sesión persistente (sticky) no las crea ni las restaura.

Cuando una página agota el tiempo de espera, repite primero una petición pequeña a través del mismo gateway en curl. Luego inspecciona los fallos de petición del navegador, sin datos sensibles, y el recurso concreto que falla. Evita recopilar capturas de pantalla o trazas que contengan datos reales de cuentas durante una comprobación básica de conectividad.

## Antes de pasar a producción

- Usa un contexto nuevo para el escenario.
- Mantén separadas las credenciales del proxy y las del sitio web.
- Verifica la condición de éxito real de la aplicación después de la navegación.

## Fuentes y lecturas adicionales

- [Playwright: HTTP proxy and network events](https://playwright.dev/docs/network#http-proxy)
- [Playwright: browser contexts and timeouts](https://playwright.dev/docs/api/class-browsercontext)
- [Playwright: navigation response behavior](https://playwright.dev/docs/api/class-page#page-goto)

## Guías relacionadas

- [Proxies rotativos vs persistentes: planifica la continuidad](https://ipvolt.com/es/guides/rotating-vs-sticky-proxies.md)
- [Usar un proxy con curl: -x, variables de entorno, SOCKS5 y auth](https://ipvolt.com/es/guides/curl-proxy-setup.md)
- [Proxies móviles vs residenciales: evalúa con criterio](https://ipvolt.com/es/guides/mobile-vs-residential-proxies.md)

## Sobre ipvolt

Los ejemplos usan configuraciones de proxy genéricas, con enlaces a la documentación técnica original. El comportamiento específico de cada producto debe comprobarse con tu proveedor. ipvolt sigue en desarrollo.

[Leer el original en inglés](https://ipvolt.com/guides/playwright-proxy-setup.md)

## Entérate cuando se abra el acceso.

ipvolt · En desarrollo

Estamos construyendo infraestructura de proxies para desarrolladores y equipos de datos. Únete a la lista de interés para recibir un aviso cuando ipvolt esté listo.

Un correo cuando se abra el acceso. Nada más.

[Solicitar acceso anticipado](https://ipvolt.com/es/guides/playwright-proxy-setup#waitlist-closing)

[Privacidad](https://ipvolt.com/privacy)