#228 · Herramienta para desarrolladores

Express Converter

Transforma declaraciones de rutas Express en un manifiesto JSON que puedes revisar, documentar o comparar. El conversor reconoce llamadas app.METHOD() y router.METHOD() con paths literales, conserva el número de línea e incluye una representación textual de los argumentos posteriores al path. No ejecuta handlers ni intenta inferir respuestas HTTP.

Datos de entrada

Rutas Express
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Pega las declaraciones de rutas Express.
  2. Ejecuta la conversión.
  3. Revisa método, path y línea de cada entrada JSON.
  4. Descarga el manifiesto para usarlo en inventarios o revisiones.

Qué hace esta herramienta para desarrolladores

Cada objeto representa una ruta detectada y contiene target, method, path, line y handlers. El campo handlers es texto aproximado extraído de la llamada.

Se recorren llamadas app/router para métodos HTTP conocidos. El parser localiza el primer argumento string como path y captura el resto de la llamada hasta el cierre de línea de forma conservadora.

Las rutas construidas con variables o concatenaciones no se convierten porque no tienen un path literal fiable.

Ejemplo

Tres rutas Express se convierten en tres objetos JSON con su método y ubicación.

[
  {"target":"app","method":"GET","path":"/health","line":1},
  {"target":"router","method":"POST","path":"/users","line":2}
]

Casos de uso

  • Crear un inventario de endpoints a partir de un router.
  • Comparar rutas de dos versiones mediante JSON.
  • Preparar datos para documentación interna.
  • Detectar rápidamente rutas repetidas por método y path.

Consejos para obtener resultados fiables

  • Usa paths literales para que la extracción sea fiable.
  • Convierte un router por vez si el proyecto tiene archivos muy grandes.
  • No interpretes handlers como firmas semánticas; son texto de referencia.
  • Valida el manifiesto contra tests o documentación de API.

Detalles del procesamiento

La conversión conserva el orden del archivo y produce JSON válido. Además genera filas CSV para análisis rápido en una hoja de cálculo.

No sigue Router montados, variables de path, arrays de callbacks multilínea complejos ni llamadas generadas dinámicamente.

Preguntas frecuentes

¿Express Converter modifica mi código?

No. Solo lee el texto y genera un manifiesto JSON separado.

¿Convierte rutas declaradas con router.get() además de app.get()?

Sí, distingue el target app o router y conserva ese dato en cada objeto.

¿Qué pasa si el path está guardado en una variable?

La ruta se omite porque el conversor exige un literal de cadena para no inventar un valor.

¿Incluye middleware de cada ruta?

Incluye una representación textual aproximada de los argumentos posteriores al path, útil para reconocer nombres de middleware.

¿El JSON generado es una especificación OpenAPI?

No. Es un manifiesto ligero de rutas y no contiene schemas, parámetros, respuestas ni seguridad de OpenAPI.

Campos del manifiesto

MétricaQué indica
targetapp o router según la llamada original.
methodMétodo HTTP en mayúsculas.
pathRuta literal detectada.
lineLínea de la declaración en la entrada.
handlersTexto aproximado de callbacks o middleware.

Explorar la categoría

Consulta más utilidades de backend y frameworks en el centro de categoría.

Ver Backend y frameworks