Saltar al contenido
nexus-dialogs
GitHub npm

Soporte, versiones y navegadores

Qué navegadores y versiones se soportan, qué pasa cuando falta una función del navegador, cuánto dura el soporte de cada versión y cómo se evita que una actualización te rompa la aplicación.

El mínimo sale de las funciones nativas que usa la librería. Cada función se prueba en Chromium, Firefox y WebKit (el motor de Safari) en cada cambio; no se prueban versiones viejas por separado: los mínimos vienen de la documentación de cada función, no de haberlas ejecutado.

FunciónChrome / EdgeFirefoxSafariSi falta
<dialog> modal (showModal())379815.4Se muestra como <dialog open> sin capa superior ni fondo inerte
color-mix()11111316.2Los colores derivados del acento no se calculan
Hojas de estilo construibles7310116.4Se usa un <style> de respaldo (con CSP estricta necesita configure({ nonce }))
Consultas de contenedor (@container)10511016Las pestañas y la línea de tiempo no se adaptan al ancho de su contenedor
100dvh10810115.4Sin esta unidad, un diálogo muy alto no se limita a la altura visible de la pantalla
:has()10512115.4Solo cosmético: el calendario de rangos no resalta el intervalo y las etiquetas con avatar pierden un relleno

Mínimos de la librería: Chrome y Edge 111, Firefox 113, Safari 16.4. En Firefox 113 a 120 todo funciona y solo se pierde el resaltado del rango en el calendario (:has()).

No hay soporte para Internet Explorer ni para versiones de Safari anteriores a la 16.4. Subir uno de estos mínimos cuenta como cambio que rompe y se avisa en el CHANGELOG.

#Frameworks y entornos

Qué se ejecuta en CI (matriz de compatibilidad). Las filas salen de compat/matriz.json: CI instala cada versión indicada y corre las pruebas de su envoltura, así que lo que dice «ejecuta» es lo que de verdad se ejecuta. npm run compat:check falla si esta tabla, package.json o el README no coinciden con ese archivo.

NavegadorMínimoMotor que CI ejecuta (e2e)
Chrome y Edge111Chromium
Firefox113Firefox
Safari16.4WebKit

CI ejecuta las pruebas e2e con la versión de cada motor que trae Playwright; no se prueban versiones viejas por separado.

#Frameworks

FrameworkMínimo declaradoVersiones que CI ejecuta
Vue (nexus-dialogs/vue)3.3 o más3.3 (mínimo), última
React (nexus-dialogs/react)18 o más18.0 (mínimo), 18 (última), última
Angular (nexus-dialogs/angular)16 o más. Solo ESM.16.0 (mínimo), 19, última

#Node

MínimoVersiones que CI ejecutaQué se comprueba
1818, 20, 22, 24Importar (ESM y CJS) y fallar con un error claro sin DOM. La librería se compila con Node 22.

Los tipos se incluyen y se revisan con @arethetypeswrong en cada cambio. Importar la librería no toca el DOM y abrir un diálogo en el servidor falla con un error explícito.

#Versiones

#Soporte

Una sola persona mantiene la librería, así que esto es de buena fe, no un contrato.

Qué esperar
VulnerabilidadesAcuse en 7 días y primera valoración en 14 (SECURITY.md). Se corrige la última 1.x; las 0.x ya no reciben correcciones
ErroresSe atienden en la última versión. Con un caso mínimo que lo reproduzca, la corrección es mucho más rápida
AccesibilidadTiene prioridad sobre las funciones nuevas
Versiones anterioresNo reciben correcciones; la actualización de una menor a la siguiente se acompaña con la guía de migración del CHANGELOG
PublicaciónCada versión se sube a npm en espera y no es pública hasta que su responsable la aprueba con 2FA

Lo que no se promete: un calendario fijo de versiones, soporte para navegadores fuera de la tabla ni compatibilidad con parches de terceros sobre la librería.

#Uso en producción

Esta librería nació para sistemas internos de empresa y se ha probado en uso real: su adaptador de SweetAlert2 corre en una aplicación web de producción de seguimiento de reclutadores, donde sustituyó a SweetAlert2 sin cambiar el código de las pantallas. Es un caso interno y sin nombre: todavía no hay un caso externo público que lo respalde, y por eso las limitaciones lo dicen así.

Si la usas en un proyecto, aunque todo haya salido bien, cuéntalo con «Lo probé en mi proyecto»: qué diálogos usas, en qué tipo de aplicación (sin datos sensibles) y cómo te fue. Cada caso real se suma aquí, con tu permiso.

Mientras tanto, lo que respalda la estabilidad se puede comprobar: pruebas unitarias con umbrales de cobertura, pruebas en tres navegadores, axe en cada tema, fugas de memoria, CSP y Trusted Types, y los ejemplos completos ejecutándose en cada cambio. Los números de tamaño y rendimiento se repiten con npm run bench (Rendimiento).