ArctonArcton
Configuración

Opciones de Listen

Configura el puerto, hostname, adapter y la etiqueta de entorno que se pasan a app.listen().

Levantar un servidor

app.listen() recibe un objeto de opciones opcional y devuelve un RuntimeServer:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/', () => 'Hello, Arcton!')

app.listen({ port: 8080, hostname: '0.0.0.0' })

Todos los campos son opcionales:

Propiedad

Tipo

Llamar a app.listen() sin argumentos arranca en el puerto 3000 usando el adapter de Bun:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/', () => 'Hello, Arcton!')

app.listen()

Elegir un puerto libre

Pasar port: 0 le pide al sistema operativo un puerto libre en vez de uno fijo. Lee el puerto real desde el servidor que te devuelve:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/', () => 'Hello, Arcton!')

const server = app.listen({ port: 0 })

console.log(server.port) // an OS-assigned port
console.log(server.url) // e.g. http://localhost:54231/

server.stop()

Este es exactamente el patrón que se usa para testear una app real de punta a punta — consulta Resumen de testing.

Elegir un adapter

adapter selecciona qué runtime sirve la app. El valor por defecto es bunAdapter. Pasa nodeAdapter para correr sobre Node.js en su lugar:

import { nodeAdapter } from '@arcton/adapter-node'
import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/', () => 'Hello, Arcton!')

app.listen({ adapter: nodeAdapter })

Consulta Adapters para saber qué es un adapter, y Soporte de runtime para las diferencias concretas entre los dos adapters que vienen incluidos.

El banner de inicio y el servidor devuelto

listen() imprime un banner de inicio — el wordmark de Arcton, seguido de la versión de Arcton, el nombre y la versión del runtime, la etiqueta de entorno y la URL en la que está escuchando. La opción env controla solamente esa etiqueta; consulta Entorno para los detalles.

Devuelve un RuntimeServer:

interface RuntimeServer {
  readonly port: number
  readonly url: URL
  stop(closeActiveConnections?: boolean): void | Promise<void>
}

stop() devuelve void en el adapter de Bun y un Promise<void> en el de Node, así que siempre es seguro esperarlo con await:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/', () => 'Hello, Arcton!')

const server = app.listen({ port: 0 })

await server.stop()

Consulta listen() para la referencia completa de la API.

Apagado elegante

Por defecto, listen() drena el servidor al recibir SIGTERM/SIGINT en vez de dejar la terminación en manos del comportamiento por defecto del runtime: deja de aceptar conexiones nuevas, espera a que las requests en curso terminen (hasta shutdownTimeout, 10 segundos por defecto), y luego sale del proceso. Si una request sigue en curso una vez agotado el timeout, las conexiones activas se cierran a la fuerza en su lugar.

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/', () => 'Hello, Arcton!')

app.listen({ shutdownTimeout: 5000 })

gracefulShutdown está pensado para aplicaciones donde Arcton es dueño del ciclo de vida del proceso — al recibir la señal, llama a process.exit(), que termina todo el proceso, no solo este servidor. Ponlo en false cuando la aplicación anfitriona maneja las señales del proceso por su cuenta (por ejemplo, Arcton incrustado dentro de un proceso más grande, o un runtime donde las señales del sistema operativo no tienen sentido):

import { Arcton } from '@arcton/core'

const app = Arcton()

app.listen({ gracefulShutdown: false })

Una segunda SIGTERM/SIGINT recibida mientras ya se está apagando se ignora — no inicia un segundo drenaje concurrente.

En esta página