Comprobador de recursos bloqueantes
Respuesta breve
Recursos que bloquean el renderizado: encuentra scripts y hojas de estilo bloqueantes y hábitos como falta de async/defer, eventos inline y document.write.
Lo que no hace: Lee el HTML y señala patrones; no carga la página ni mide cuánto bloquea cada recurso el renderizado. La prueba de velocidad de página da tiempos medidos.
Qué hace
Comprueba el HTML de una página en dos partes. Recursos bloqueantes de renderizado: scripts en `<head>` sin `async` ni `defer`, hojas de estilo que bloquean el renderizado y reglas `@import` de CSS. Higiene de scripts: cuántos scripts externos e inline carga la página, si los scripts externos usan `async` o `defer`, controladores de eventos inline como `onclick`, llamadas a `document.write` y si se usan módulos ES.
Por qué importa
Un navegador tiene que descargar y ejecutar cada script y hoja de estilo bloqueante en `<head>` antes de poder pintar nada, lo que retrasa el First Contentful Paint y a menudo el Largest Contentful Paint. `document.write` empeora esto: Chrome puede negarse a ejecutar los scripts que inyecta en conexiones lentas, y los controladores inline se interponen en una Content-Security-Policy estricta.
Cómo funciona
-
Introduce la URL de una página o pega su HTML
-
Analizamos el `<head>` y cada `<script>` de la página
-
Marcamos los scripts y hojas de estilo bloqueantes, y luego comprobamos los scripts en busca de async/defer, controladores inline y document.write
-
Devolvemos un resultado por cada parte, con los recursos que marcamos
Ejemplo de entrada y salida
url: https://rankproof.eu/tools
Recursos que bloquean el renderizado 92/100
Scripts bloqueantes: 0 · Hojas de estilo bloqueantes: 1 · Recursos en el head: 7
Los scripts del head usan async o defer OK
Sin hojas de estilo bloqueantes WARN
Sin @import en CSS OK
Recursos que bloquean el renderizado:
<link rel="stylesheet" href="DFq8YedA.css">
Higiene de los scripts 100/100
Scripts: 13 · Externos: 5 · En línea: 8
Los scripts externos usan async o defer OK
Sin manejadores de eventos en línea OK
Sin document.write OK
Usa ES modules OK
Áreas en buen estado: 1 de 2 · 96/100 Cómo leer el resultado
- Dos partes (1 de 2 áreas están bien · 96/100)
- Los recursos que bloquean el renderizado y la higiene de los scripts tienen cada uno su propia puntuación, y la puntuación total es su media. En el ejemplo la parte de scripts está limpia y la primera tiene una advertencia, así que el resumen cuenta una de dos.
- Scripts bloqueantes (0)
- Scripts en <head> con src y sin async, defer ni type="module". El navegador deja de construir la página mientras se descarga y ejecuta cada uno, y cada uno le resta 15 puntos a la parte. Los scripts en línea y los scripts en <body> no se cuentan aquí.
- Hojas de estilo bloqueantes (1)
- Cada <link rel="stylesheet"> en <head> que no sea media="print" ni esté desactivado. El navegador no pinta nada hasta tener estos archivos, así que una hoja de estilo principal es normal: una es una advertencia, dos o más fallan. El archivo del ejemplo es la hoja de estilo del propio sitio, con un nombre basado en su contenido. Una hoja de estilo con otra media query también se cuenta, aunque los navegadores no esperan a una cuya consulta no coincide con la pantalla.
- Recursos en el head (7) y @import
- Recursos en el head cuenta cada script, hoja de estilo y bloque <style> en <head>, sean bloqueantes o no; da contexto y no puntúa. Un @import dentro de un bloque <style> resta 10 puntos, porque el navegador encuentra el archivo importado solo después de leer el primero. Las reglas @import dentro de archivos .css enlazados no se comprueban, ya que esos archivos no se descargan.
- Higiene de los scripts (13 scripts: 5 externos, 8 en línea)
- Cuenta todos los scripts de la página, en <head> y en <body>. «En línea» cuenta cada bloque <script> no vacío, incluidos los datos estructurados JSON-LD, que nunca se ejecutan, así que una cifra alta no es un problema en sí misma. Los scripts externos sin async, defer ni type="module" restan 8 puntos cada uno, los manejadores en línea como onclick 4 cada uno, y cualquier llamada a document.write 15.
- Usa ES modules
- Se supera cuando al menos un script tiene type="module". Sin ninguno es una advertencia, no un fallo: es una pista hacia la forma moderna de cargar código, ya que los módulos se difieren por defecto.
Quién lo usa
-
Ingeniero/a de rendimiento
Antes de una temporada alta, pasa cada script bloqueante a async o defer y vuelve a comprobar que no se ha colado nada nuevo en `<head>`.
-
Desarrollador/a frontend
Encuentra el fragmento de analítica o widget que aún carga de forma síncrona y cámbialo a una carga diferida.
-
Especialista en SEO
Comprueba las plantillas detrás de tus páginas más lentas y entrega los recursos marcados al equipo de desarrollo.
Problemas frecuentes y cómo solucionarlos
-
Un script bloqueante en <head>
Añade defer a los scripts que necesitan los elementos de la página o deben ejecutarse en orden, y async a los independientes, como los de analítica. Los scripts con type="module" ya se difieren.
<script src="/js/app.js" defer></script> <script src="https://analytics.example/tag.js" async></script> <script type="module" src="/js/menu.js"></script> -
Más de una hoja de estilo bloqueante
Combina tu propio CSS en un solo archivo durante el build, dale media="print" a los estilos de impresión e incluye en línea las pocas reglas que necesita la primera pantalla para que la página pueda pintarse antes de que llegue el archivo principal.
<head> <style>/* only the rules the first screen needs */ .hero { min-height: 60vh; }</style> <link rel="stylesheet" href="/css/site.css"> <link rel="stylesheet" href="/css/print.css" media="print"> </head> -
@import en un bloque <style>
Sustitúyelo por un <link rel="stylesheet">, para que el navegador pueda encontrar y descargar ambos archivos al mismo tiempo.
<!-- before --> <style>@import url("/css/fonts.css");</style> <!-- after --> <link rel="stylesheet" href="/css/fonts.css"> -
Manejadores de eventos en línea
Mueve los manejadores como onclick a un archivo de script y asígnalos con addEventListener. Cuando ya no quede código en línea, un Content-Security-Policy puede prescindir de 'unsafe-inline'.
<!-- before --> <button onclick="openMenu()">Menu</button> <!-- after --> <button type="button" id="menu-button">Menu</button> <script type="module" src="/js/menu.js"></script> // /js/menu.js document.getElementById('menu-button').addEventListener('click', openMenu); -
document.write
Crea el elemento con los métodos del DOM; los fragmentos antiguos de anuncios y widgets suelen ser el origen, y la mayoría de los proveedores ofrecen ya una versión asíncrona. La comprobación busca el texto document.write( en cualquier parte del HTML, así que una mención en un comentario también cuenta.
const s = document.createElement('script'); s.src = 'https://widget.example/embed.js'; s.async = true; document.head.append(s);
Preguntas frecuentes
- ¿Cómo desbloqueo una hoja de estilo?
- Incluye en línea, en un bloque `<style>`, las pocas reglas que necesita la primera pantalla, deja el resto en una sola hoja de estilo y da `media="print"` a los estilos de impresión. El truco de `onload="this.media='all'"` también funciona, pero es un manejador en línea: esta comprobación lo señala y una Content-Security-Policy estricta lo bloquea.
- ¿Puedo simplemente aplicar defer a todos mis scripts?
- No siempre: los scripts que deben ejecutarse antes del primer pintado, los polyfills necesarios para el diseño y los scripts inline no siempre pueden esperar. Audítalos por su impacto.
- ¿Qué tiene de malo document.write?
- Obliga al navegador a pausar el análisis, y Chrome puede bloquear los scripts que inyecta en conexiones lentas. Inserta elementos con métodos del DOM en su lugar.
- ¿Por qué se marcan los controladores de eventos inline?
- Controladores como `onclick="…"` mezclan el comportamiento con el marcado y necesitan `unsafe-inline` en una Content-Security-Policy. Adjunta los listeners desde un archivo de script en su lugar.
- ¿Qué pasa con los widgets de terceros?
- Cárgalos con `<script async>` o mediante un gestor de etiquetas con carga diferida. Mejor aún, carga los widgets bajo el pliegue solo al hacer scroll o al interactuar.
Fuentes
La documentación en la que se basan esta herramienta y las explicaciones de esta página.
- Eliminate render-blocking resources — Chrome for Developers
- Render-blocking CSS — web.dev
- <script> HTML script element — MDN Web Docs
- Intervening against document.write() — Chrome for Developers
- Content-Security-Policy: script-src directive — MDN Web Docs