Skip to content

listen ​

app.listen(port, options?) asocia el router y devuelve Result<HttpServer, HttpError>. El servidor empieza a aceptar solicitudes de inmediato, y main puede continuar ejecutando el código de inicio. Use onfail para gestionar un error al enlazar el puerto o al iniciar TLS; en una función void, el bloque de error retorna de esa función.

Firmaapp.listen(port: i32, options?: ServerOptions): Result<HttpServer, HttpError>

Mostrar el puerto enlazado ​

listen devuelve el handle del servidor enlazado cuando tiene éxito, así que server.port() informa del puerto real, incluso cuando el puerto solicitado era 0. El runtime mantiene el listener activo después de que main retorna y espera una señal de apagado del sistema operativo; llame a server.close() cuando la aplicación deba detenerlo antes.

tyrus
import { createRouter, HttpError, HttpRouter, HttpServer } from "tyrus:http";

const main = (): void => {
    const app: HttpRouter = createRouter();
    const server = app.listen(3000) onfail {
        printError(`${server.code}: ${server.message}`);
    };
    print(`Server listening on port ${server.port()}`);
};

Gestionar un error de inicio ​

La variable de onfail contiene HttpError, con un code estable y un message legible. El error se gestiona sin lanzar una excepción; el bloque retorna de esta función void después de informarlo.

tyrus
import { createRouter, HttpError, HttpRouter, HttpServer } from "tyrus:http";

const main = (): void => {
    const app: HttpRouter = createRouter();
    const server = app.listen(3000) onfail {
        printError(`${server.code}: ${server.message}`);
    };
    print(`Server listening on port ${server.port()}`);
};

Opciones ​

Pase un objeto ServerOptions como segundo argumento de listen. Consulte ServerOptions para ver las opciones disponibles.