Paquetes

@xtaskjs/express-http

Adaptador de Express con recursos estáticos e integración de motor de plantillas.

npm install @xtaskjs/express-http express reflect-metadata Ruta del paquete: packages/express-http

Resumen

Qué controla este paquete en el runtime

El adaptador de Express traduce las rutas del framework al manejo de peticiones de Express. Añade archivos estáticos, motores de plantillas y respuestas JSON o renderizadas sin cambiar el código de los controladores.

Qué ofrece

Envuelve una instancia existente de aplicación Express.
Admite motores de vista nativos de Express como Handlebars.
Sirve recursos estáticos y plantillas renderizadas desde carpetas configurables.
Usa los mismos contratos de controlador que node-http y Fastify.

Cómo encaja

Se selecciona explícitamente con new ExpressAdapter(expressApp).
Encaja de forma natural con valores de retorno view(...) desde los controladores.
Se usa en el sitio actual xtaskjs.io y en el ejemplo 07-security_express_app.

Mapa de uso

Qué peso tiene este paquete dentro del runtime

Arranque

3/5

Entrega HTTP

5/5

Renderizado

5/5

Integraciones

4/5

Mensajería

3/5

Flujo del paquete

Cómo atraviesa este paquete las fases del runtime de xtaskjs

Antes del arranque

Crea una app Express, registra su pila de middlewares y configura opcionalmente motores de plantillas o el comportamiento de recursos estáticos.

Durante CreateApplication()

El adaptador de Express mapea las rutas de xtaskjs a handlers de Express y preserva respuestas view(), JSON y códigos de estado.

Durante app.close()

La aplicación xtask detiene el servidor activo mientras tu middleware y configuración existentes de Express siguen siendo el mismo límite de aplicación.

Superficie API

Exports representativos del paquete original

Runtime del adaptador

ExpressAdapter
view
HttpAdapter
HttpRequestHandler

Tipos de petición y respuesta

HttpRequestLike
HttpResponseLike
HttpServerOptions
HttpViewResult
HttpAdapterType

Opciones del adaptador

ExpressAdapterOptions
ExpressTemplateEngineOptions
ExpressStaticFilesOptions

Uso

Flujo típico de adopción

1. Crea la app Express

Habilita parseo JSON, cookies, sesiones o cualquier otro middleware de Express antes de ceder el control a xtaskjs.

2. Pasa el adaptador

Envuelve la instancia con new ExpressAdapter(expressApp) y pásala a CreateApplication().

3. Devuelve resultados nativos del framework

Mantén los controladores portables devolviendo objetos planos o resultados view() mientras el adaptador maneja los detalles de renderizado específicos de Express.

Ejemplo

Fragmento de referencia

Arranque de Express con plantillas

import express from "express";
import { CreateApplication } from "@xtaskjs/core";
import { ExpressAdapter } from "@xtaskjs/express-http";

const expressApp = express();
expressApp.use(express.json());

await CreateApplication({
  adapter: new ExpressAdapter(expressApp),
  autoListen: true,
  server: { host: "127.0.0.1", port: 3000 },
});

Ejemplos

Ejemplos oficiales para revisar después

Ejemplos de referencia: 02-express_app and 07-security_express_app

Relacionados