jQuery 3.8.0 es la última 3.x con mejoras, pero sigue con parches. Elige entre sostenerla, subir a 4.1.0 con Migrate o escribir código sin jQuery.
Qué cambia con 3.8.0
«Última versión con características» no es sinónimo de «sin soporte». El anuncio del 17 de noviembre de 2026 publicó 4.1.0 y 3.8.0 al mismo tiempo y dejó claro que la rama 3.x continuará recibiendo correcciones críticas de seguridad y errores; lo que se detiene es el desarrollo de funcionalidades nuevas (blog.jquery.com).
El cambio es de naturaleza, no de fecha de caducidad. Dejas de ganar capacidades, pero no pierdes la red de seguridad. Quien lee el titular como un apagón migra sin diagnóstico; quien lo lee como «sigue funcionando» no se prepara. Las dos posturas fallan por la misma razón: ninguna define un momento propio de salida.
Fija una condición de salida antes de necesitarla: el próximo cambio de tema, el próximo salto de core o la sustitución de un plugin. Cuando la migración se engancha a un trabajo ya presupuestado, deja de ser una tarea huérfana.
Mide primero la versión que corre
Antes de decidir, separa tres capas que casi nunca coinciden: lo que declara el manifest, lo que trae el core y lo que el navegador ejecuta.
En un proyecto con package.json:
npm ls jquery jquery-migrate
En Drupal, jQuery llega con el core. La versión exacta se lee del archivo que el propio núcleo distribuye:
grep -m1 -o 'jQuery v[0-9.]*' core/assets/vendor/jquery/jquery.min.js
Y en la consola del navegador, $.fn.jquery devuelve la versión realmente cargada en esa página. Esa tercera cifra manda: se decide sobre lo que corre, no sobre lo que el manifest dice que debería correr. Un tema que inyecta su propia copia por CDN puede dejar la versión del core en segundo plano sin que nadie lo note.
Ruta 1: sostener 3.8.0 con disciplina
Quedarse en 3.8.0 es válido si el sitio es estable, no entra código nuevo y existe un canal que avisa de parches. No es «no hacer nada»: es deuda reconocida, con responsable y fecha de revisión.
Encaja cuando hay módulos de terceros sin declaración de compatibilidad con 4.x, integraciones que nadie quiere tocar o cuando el costo de probar la migración supera el riesgo de quedarse en una rama congelada. Registra tres datos: versión instalada, última revisión y quién vigila los avisos.
El detalle que no se puede dejar pasar es el parche de ReDoS en la coincidencia de identificadores de selectores, incluido en 3.8.0. Si construyes selectores con datos del usuario —búsquedas, filtros, parámetros que llegan a $()—, 3.7.x sigue expuesto. Actualizar dentro de la rama 3.x es el paso más barato y casi siempre el primero.
«Hasta que haya tiempo» no es una condición de salida. Escribe cuándo se revisará: al cambiar el tema, al actualizar el core o al aparecer un aviso crítico.
Ruta 2: subir a 4.1.0 con Migrate
Saltar a 4.1.0 sin inspeccionar el código es apostar. jQuery Migrate convierte la apuesta en una lista: emite avisos en consola por las APIs eliminadas o en desuso que el sitio todavía llama. La propia guía de actualización recomienda usarla para este salto (upgrade guide 4.0).
El orden importa más que la velocidad:
- Poner el sitio en la última 3.x.
- Cargar Migrate sobre esa versión y recorrer el sitio completo.
- Pasar a 4.1.0 con Migrate todavía activo.
- Retirar Migrate cuando los avisos desaparezcan.
Hacerlo al revés —saltar y esperar a ver qué se rompe en producción— quita la línea base que permite distinguir un fallo nuevo de uno heredado.
En Drupal el punto delicado rara vez es jQuery, sino el código que lo tocó: temas con scripts propios, módulos contributed que usan .bind() o .delegate(), y fragmentos copiados hace años. Esas dos APIs desaparecen en 4.x y la consola las marca con el prefijo JQMIGRATE:.
Qué hacer con los avisos de la consola
Clasifícalos en tres montones: código propio (lo arreglas tú), paquete con mantenimiento (actualizas el paquete) y código abandonado (reemplazas la función o aíslas el módulo). Intentar resolverlos todos en una sola pasada suele terminar en cambios que nadie terminó de probar.
Activa «Preserve log» en la consola y recorre las rutas que más se usan: login, carrito, formularios y panel administrativo. Anota cada aviso con la URL donde aparece. Al final tienes un mapa por ruta, no una lista de mensajes sueltos, y puedes repartirlo por archivo.
Migrate es diagnóstico, no una capa de compatibilidad definitiva. Dejarlo en producción «por si acaso» mantiene vivos comportamientos antiguos y esconde la deuda que aparecerá en la siguiente actualización.
Ruta 3: escribir código nuevo sin jQuery
La tercera ruta no sustituye a las otras: es lo que queda cuando el inventario muestra que la librería sostiene cuatro cosas que el navegador ya hace solo. La versión 3.0 de You Don't Need jQuery retiró los fallbacks de Internet Explorer, una señal de que ese proyecto dio por resuelto el motivo original de la librería (You Don't Need jQuery v3.0). No es una orden de borrar jQuery de Drupal; es una pista sobre dónde escribir el código nuevo.
En Drupal no elimines core/assets/vendor/jquery/: el core y parte de su AJAX lo siguen necesitando. Lo que sí puedes quitar es una segunda copia que el tema cargue por CDN o por npm. Busca duplicados antes de dar por terminada la migración:
grep -R "jquery" -n assets js templates --include="*.js" --include="*.twig"
Las sustituciones habituales son directas: document.querySelectorAll() para seleccionar, classList.add() y classList.remove() para clases, addEventListener() para eventos, fetch() para peticiones y DOMContentLoaded para esperar al DOM.
Donde jQuery todavía gana es en selecciones complejas, manejo de grupos de elementos y plugins con años de prueba. Si un calendario, slider o tabla depende de un plugin jQuery, quitar la librería empieza por reemplazar ese plugin. Esa es la conversación honesta: no que jQuery ya no sirva, sino que un plugin concreto sostiene la dependencia.
La regla que se sostiene en el tiempo: código nuevo sin jQuery, código viejo funcionando y una medida de cuánto queda. Cuando el último archivo que lo usa sea un plugin ya sustituido, la librería sale del bundle sin una migración traumática.
Preguntas frecuentes
¿3.8.0 deja de funcionar tras el lanzamiento de 4.1.0?
No. Sigue recibiendo correcciones de seguridad y errores; lo que se congela son las funcionalidades nuevas. El riesgo no es perder soporte de golpe, sino acumular una rama que no evoluciona.
¿Es obligatorio jQuery Migrate para pasar de 3.8.0 a 4.1.0?
No, pero sin él trabajas a ciegas. Migrate traduce las APIs removidas en avisos de consola que se pueden corregir antes de desplegar. Úsalo en desarrollo y quítalo cuando los avisos desaparezcan.
¿Se puede quitar jQuery de Drupal sin romper el core?
No de forma directa: el core y funciones como AJAX lo usan. Lo seguro es eliminar las copias duplicadas que cargue el tema y dejar que Drupal suministre la suya. El código nuevo puede apoyarse en las APIs del navegador.
¿Qué conviene en 2026, jQuery o JavaScript nativo?
Para código nuevo, querySelectorAll, addEventListener y fetch cubren la mayoría de los casos sin dependencias. En sitios con plugins maduros, una migración completa suele costar más que mantener la librería un tiempo más.
¿Qué reviso primero si me preocupa el ReDoS?
Que la versión desplegada sea 3.8.0 o superior dentro de 3.x, o 4.1.0. Después revisa si construyes selectores con datos del usuario y valida esos datos antes de pasárselos a $().
Por dónde empezar hoy
Corre npm ls jquery jquery-migrate en el proyecto y $.fn.jquery en la consola del sitio. Con esos dos datos, más la versión del core, decide si parcheas 3.8.0, migras con Migrate o dejas de escribir jQuery nuevo. Anota la versión y la fecha de revisión en el registro del proyecto: la próxima decisión será más barata si no hay que empezar a medir desde cero.