Si tienen este error:

Pueden usar el command $env:PWDEBUG="console"; npx playwright test assert
y ya les corre el debug.
Depurar selectores en Playwright se vuelve mucho más simple cuando combinas las DevTools del navegador con el objeto global playwright que se inyecta en la consola. Si ya escribes pruebas end to end y necesitas validar qué selector funciona antes de pegarlo en tu código, esta combinación te ahorra horas de prueba y error.
¿Cómo pausar un test de Playwright para inspeccionarlo?
La pausa es el primer paso para abrir la puerta del modo debug. Dentro de tu archivo assert.spec.ts, agrega la línea await page.pause() en el punto donde quieras detener la ejecución [01:00]. Puedes usarla varias veces y en distintos archivos, según el momento que necesites revisar.
¿Cuándo debo usar
page.pause()? Solo en desarrollo local, nunca en producción. Sirve para detener el test y abrir el inspector mientras depuras selectores o flujos.
Después, en la terminal, define la variable de entorno y ejecuta el test:
PWDEBUG=console activa el modo consola que expone el objeto playwright en el navegador.npx playwright test assert.spec.ts corre el archivo y abre el navegador junto al inspector.Con esto listo, haz clic derecho sobre la página, selecciona inspeccionar y abre la pestaña de consola [02:30].
¿Qué funciones ofrece el objeto playwright en la consola?
El objeto playwright solo está disponible cuando corres el navegador de incógnito que levanta Playwright con PWDEBUG=console activo. Desde la consola tienes acceso a varias funciones útiles para explorar selectores en vivo.
Las opciones que aparecen son $, $$, inspect, locator, resume y selector [03:10]. Cada una resuelve un problema distinto al momento de identificar elementos.
¿Cuál es la diferencia entre $ y $$ en Playwright?
El signo de dólar simple devuelve un único elemento, similar a document.querySelector. El doble dólar devuelve una lista, equivalente a document.querySelectorAll.
playwright.$('input') te devuelve el primer input con su clase, placeholder e id.playwright.$$('a') te devuelve un array con todos los enlaces de la página, por ejemplo siete elementos con etiqueta A.$ sobre a, obtendrías únicamente el primer enlace de esa lista.¿Qué hace
playwright.$$exactamente? Selecciona todos los elementos que coincidan con el selector y los devuelve como array, igual quequerySelectorAlldel DOM nativo.
Esta diferencia importa cuando escribes asserts: si esperas varios elementos, necesitas el doble dólar.
¿Cómo encontrar el selector correcto con inspect y selector?
Aquí viene lo interesante. Playwright tiene dos funciones que conectan la consola con la pestaña de elementos para que dejes de adivinar selectores.
¿Cómo usar playwright.inspect para localizar un elemento?
Ejecuta playwright.inspect('input') en la consola y la vista salta automáticamente a la pestaña de elementos con ese nodo seleccionado [05:00]. Desde ahí ves sus estilos, atributos HTML y posición real en el DOM.
Es la forma más rápida de confirmar que un selector apunta al elemento correcto antes de llevarlo a tu test.
¿Cómo generar un selector desde un elemento ya inspeccionado?
Usa el botón con la flecha y el cuadrado en la parte superior izquierda de las DevTools. Al hacer clic se pone azul y puedes seleccionar cualquier elemento de la página, por ejemplo un input o un H4 con el texto Playground.
Luego, en la consola, escribe playwright.selector($0) y Playwright te devuelve el selector recomendado para ese elemento [06:15]. En el ejemplo de la clase, devuelve un selector basado en rol hidden con el nombre escenario.
¿Qué es
$0en las DevTools? Es una referencia al último elemento seleccionado en la pestaña de elementos. Playwright lo lee para sugerirte el selector ideal.
Esta combinación es oro cuando trabajas con componentes complejos donde no sabes si usar getByRole, getByText o un CSS selector tradicional.
¿Por qué conviene apoyarse en las DevTools al escribir tests?
Las DevTools no solo sirven para depurar CSS o JavaScript. En el contexto de Playwright se vuelven tu laboratorio para validar cada selector antes de comprometerte con él en código.
Si quieres profundizar más en el uso general de DevTools, el curso de Diego de Granda sobre DevTools es la referencia recomendada [00:30].
¿Ya probaste playwright.selector en tu próximo test? Cuéntame en los comentarios qué selector te devolvió y si lo dejaste tal cual o lo ajustaste.
Depurar selectores en Playwright se vuelve mucho más simple cuando combinas las DevTools del navegador con el objeto global playwright que se inyecta en la consola. Si ya escribes pruebas end to end y necesitas validar qué selector funciona antes de pegarlo en tu código, esta combinación te ahorra horas de prueba y error.
La pausa es el primer paso para abrir la puerta del modo debug. Dentro de tu archivo assert.spec.ts, agrega la línea await page.pause() en el punto donde quieras detener la ejecución [01:00]. Puedes usarla varias veces y en distintos archivos, según el momento que necesites revisar.
¿Cuándo debo usar
page.pause()? Solo en desarrollo local, nunca en producción. Sirve para detener el test y abrir el inspector mientras depuras selectores o flujos.
Después, en la terminal, define la variable de entorno y ejecuta el test:
PWDEBUG=console activa el modo consola que expone el objeto playwright en el navegador.npx playwright test assert.spec.ts corre el archivo y abre el navegador junto al inspector.Con esto listo, haz clic derecho sobre la página, selecciona inspeccionar y abre la pestaña de consola [02:30].
El objeto playwright solo está disponible cuando corres el navegador de incógnito que levanta Playwright con PWDEBUG=console activo. Desde la consola tienes acceso a varias funciones útiles para explorar selectores en vivo.
Las opciones que aparecen son $, $$, inspect, locator, resume y selector [03:10]. Cada una resuelve un problema distinto al momento de identificar elementos.
$ y $$ en Playwright?El signo de dólar simple devuelve un único elemento, similar a document.querySelector. El doble dólar devuelve una lista, equivalente a document.querySelectorAll.
playwright.$('input') te devuelve el primer input con su clase, placeholder e id.playwright.$$('a') te devuelve un array con todos los enlaces de la página, por ejemplo siete elementos con etiqueta A.$ sobre a, obtendrías únicamente el primer enlace de esa lista.¿Qué hace
playwright.$$exactamente? Selecciona todos los elementos que coincidan con el selector y los devuelve como array, igual quequerySelectorAlldel DOM nativo.
Esta diferencia importa cuando escribes asserts: si esperas varios elementos, necesitas el doble dólar.
inspect y selector?Aquí viene lo interesante. Playwright tiene dos funciones que conectan la consola con la pestaña de elementos para que dejes de adivinar selectores.
playwright.inspect para localizar un elemento?Ejecuta playwright.inspect('input') en la consola y la vista salta automáticamente a la pestaña de elementos con ese nodo seleccionado [05:00]. Desde ahí ves sus estilos, atributos HTML y posición real en el DOM.
Es la forma más rápida de confirmar que un selector apunta al elemento correcto antes de llevarlo a tu test.
Usa el botón con la flecha y el cuadrado en la parte superior izquierda de las DevTools. Al hacer clic se pone azul y puedes seleccionar cualquier elemento de la página, por ejemplo un input o un H4 con el texto Playground.
Luego, en la consola, escribe playwright.selector($0) y Playwright te devuelve el selector recomendado para ese elemento [06:15]. En el ejemplo de la clase, devuelve un selector basado en rol hidden con el nombre escenario.
¿Qué es
$0en las DevTools? Es una referencia al último elemento seleccionado en la pestaña de elementos. Playwright lo lee para sugerirte el selector ideal.
Esta combinación es oro cuando trabajas con componentes complejos donde no sabes si usar getByRole, getByText o un CSS selector tradicional.
Las DevTools no solo sirven para depurar CSS o JavaScript. En el contexto de Playwright se vuelven tu laboratorio para validar cada selector antes de comprometerte con él en código.
Si quieres profundizar más en el uso general de DevTools, el curso de Diego de Granda sobre DevTools es la referencia recomendada [00:30].
¿Ya probaste playwright.selector en tu próximo test? Cuéntame en los comentarios qué selector te devolvió y si lo dejaste tal cual o lo ajustaste.
Si tienen este error:

Pueden usar el command $env:PWDEBUG="console"; npx playwright test assert
y ya les corre el debug.
Para no tener que estar escribiendo siempre npx playwright test, esto se puede hacer un script para que solo tengas que escribir npm run test.
.
Para hacer esto en el archivo package.json, en la seccion de scripts, agregamo el siguiente script:
"scripts": {
"test": "npx playwright test"
}
Con esto ya puedes correr solamente npm run test, en lugar de correr el script original. Sin embargo, muchas veces vamos a querer correr solamente un archivo en especifico. Esto lo haces de la siguiente manera:
npm run test -- assert
// npx playwright test assert
En este caso le estamos pasando parametros al comando original despues del --
Como dijeron en algun comentario pasado, en WINDOWS me funcionó corriendo el siguiente comando
//replace "assert" with the name of your test
$env:PWDEBUG="console"; npx playwright test assert --debug
Este comando funciona para mac pero no para Windows me funcionó a mi este comando que soluciona el problema y te permite seguir con la clase:
$env:PWDEBUG="console"
>> npx playwright test --debug
Si estáis en Windows usando como terminal GitBash o el subsistema de Linux para Windows (WSL2) el comando:
PWDEBUG=console npx playwright test nombre-del-fichero
...ejecuta el test y finaliza sin abrir el browser ni el inspector de playwright
Es necesario agregar "--headed" o, alternativamente "--debug", tal que así:
PWDEBUG=console npx playwright test nombre-del-fichero --headed
Es necesario además insertar en alguna parte del fichero:
await page.pause();
De lo contrario no funcionará.
Para ejecutarlo desde una terminal de Powershell se debe definir la variable de entorno primero y luego ejecutar el comando, tal que así:
$env:PWDEBUG="console"
npx playwright test nombre-de-fichero --headed
Octubre 2023 el comando no funciona, bueno supongo que el curso se subio un tiempo antes lo cual demuestra que tan rapido avanza la tecnologia, sin embargo seria interesante ver este curso actualizado....
Cuando ejecutamos el modo de depuración (Debug) de Playwright (por extensión o por variable entorno activa PWDEBUG=console), el objeto playwright será disponible en la consola del navegador.
.
De ahí, podemos acceder por búsqueda a un elemento $(selector) o conjunto de elementos $$(selector) .
.
📌 Referencia Debugging Selectors | Playwright
Cambio levemente la forma para obtener selectores desde la vista de elementos: playwright.selector($0)
En el packege json podemos crear un script para correr las pruebas
"scripts": { "test": "npx playwright test" }

A mi me funciono esta linea de comandos para ejecutar el debug en web distintas: npx playwright test tests/nameTestCase.spec.ts --debug