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.