Cómo instalar Playwright con Python en Windows paso a paso

Por /

Instalar Playwright en Windows es un proceso bastante fácil si sigues los pasos en orden. En menos de 10 minutos tienes todo listo para escribir tu primer test automatizado. En este artículo te explico exactamente cómo hacerlo, sin rodeos.

Lo que necesitas antes de empezar a instalar Playwright

Antes de instalar Playwright necesitas tener Python instalado en tu ordenador. Si no lo tienes, descárgalo desde python.org y durante la instalación marca la casilla «Add Python to PATH» — esto es importante, si no lo haces los comandos no funcionarán después.

Para comprobar que Python está bien instalado, abre PowerShell y escribe:

python --version

Si te devuelve algo como Python 3.11.0 es que está todo correcto.

También necesitas pip, que es el gestor de paquetes de Python y viene instalado automáticamente con Python. Para verificarlo:

pip --version

Paso 1: Crea una carpeta para tu proyecto

Antes de instalar nada, crea una carpeta donde va a vivir tu proyecto. Puedes hacerlo desde el explorador de archivos o desde PowerShell:

powershell

mkdir mi-proyecto-playwright
cd mi-proyecto-playwright

Paso 2: Crea un entorno virtual

Un entorno virtual es un espacio aislado donde instalas las dependencias de tu proyecto sin que afecten al resto del sistema. Es buena práctica usarlo siempre.

powershell

python -m venv venv

Luego actívalo:

powershell

.\venv\Scripts\Activate.ps1

Sabrás que está activo porque verás (venv) al principio de la línea en PowerShell.

Paso 3: Instala Playwright

Con el entorno virtual activo, instala Playwright:

powershell

pip install playwright

Una vez instalado, necesitas descargar los navegadores que Playwright va a usar para ejecutar los tests:

powershell

playwright install

Esto descarga Chromium, Firefox y WebKit. Tarda unos minutos dependiendo de tu conexión.

Paso 4: Instala pytest y el plugin de Playwright

Para ejecutar los tests usaremos pytest, que es el framework de testing más popular en Python:

powershell

pip install pytest pytest-playwright

Paso 5: Comprueba que todo funciona

Crea un archivo llamado test_ejemplo.py en tu carpeta y pega este código:

python

from playwright.sync_api import Page

def test_titulo_google(page: Page):
    page.goto("https://www.google.com")
    assert "Google" in page.title()

Luego ejecútalo:

powershell

pytest test_ejemplo.py

Si ves algo como 1 passed en verde, ¡todo listo! Playwright está instalado y funcionando correctamente.

Solución a los errores más comunes

Error: «No se reconoce el comando python» Significa que Python no está en el PATH. Desinstala Python y vuelve a instalarlo marcando la casilla «Add Python to PATH».

Error al activar el entorno virtual PowerShell puede bloquear la ejecución de scripts por políticas de seguridad. Ejecuta esto y vuelve a intentarlo:

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Los tests se ejecutan pero el navegador no se ve Es normal. Playwright ejecuta los tests en modo headless por defecto, sin abrir ventana visible. Si quieres ver el navegador mientras se ejecuta el test, usa:

powershell

pytest test_ejemplo.py --headed
```

---

### Estructura recomendada para tu proyecto

Una vez instalado, organiza tu proyecto así desde el principio:
```
mi-proyecto-playwright/
├── tests/
│   └── test_ejemplo.py
├── pages/
│   └── (aquí irán tus Page Objects)
├── venv/
├── .gitignore
└── requirements.txt

Esta estructura sigue el patrón Page Object Model, que es la forma más profesional de organizar los tests con Playwright. Lo explico en detalle en otro artículo del blog.

Para guardar las dependencias del proyecto en un archivo:

powershell

pip freeze > requirements.txt

Así cualquier persona que clone tu proyecto puede instalar todo con un solo comando.

El siguiente paso

Con Playwright instalado ya estás lista para escribir tus primeros tests reales. En el siguiente artículo explico qué es pytest y cómo funciona, que es la herramienta que usamos para organizar y ejecutar los tests de Playwright.

Si quieres ver ejemplos reales de proyectos con Playwright visita mi GitHub, donde tengo publicadas suites completas con Page Object Model y CI/CD con GitHub Actions.

Y si necesitas ayuda para implementar automatización con Playwright en tu proyecto, puedes ver mis servicios en fatimaqa.com.

Scroll al inicio