Skip to content

listen ​

app.listen(port, options?) associa o roteador e retorna Result<HttpServer, HttpError>. O servidor começa a aceitar requisições imediatamente, e main pode continuar executando o código de inicialização. Use onfail para tratar uma falha de bind ou de inicialização TLS; em uma função void, o bloco de falha retorna dessa função.

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

Exibir a porta vinculada ​

listen retorna o handle do servidor vinculado quando tem sucesso, então server.port() informa a porta real, inclusive quando a porta solicitada foi 0. O runtime mantém o listener ativo depois que main retorna e aguarda um sinal de encerramento do sistema operacional; chame server.close() quando a aplicação precisar pará-lo 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()}`);
};

Tratar uma falha de inicialização ​

A variável de onfail contém HttpError, com um code estável e uma message legível. O erro é tratado sem lançar uma exceção; o bloco retorna dessa função void depois de informá-lo.

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()}`);
};

Opções ​

Passe um objeto ServerOptions como segundo argumento de listen. Consulte ServerOptions para ver as configurações disponíveis.