createServer() — astro Function Reference

Architecture documentation for the createServer() function in standalone.ts from the astro codebase.

Function typescript CoreAstro RoutingSystem called by 1

Entity Profile

CoreAstro→ RoutingSystem→ createServer() — astro Function Reference

Dependency Diagram

graph TD
  23e08a30_732b_c532_01f2_019dea3f5045["createServer()"]
  61bdb796_7444_31bb_d2a3_47bbf4268895["standalone.ts"]
  23e08a30_732b_c532_01f2_019dea3f5045 -->|defined in| 61bdb796_7444_31bb_d2a3_47bbf4268895
  9cd76d33_ae0f_8fdb_eb4a_196186334dbc["standalone()"]
  9cd76d33_ae0f_8fdb_eb4a_196186334dbc -->|calls| 23e08a30_732b_c532_01f2_019dea3f5045
  style 23e08a30_732b_c532_01f2_019dea3f5045 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/integrations/node/src/standalone.ts lines 53–92

export function createServer(listener: http.RequestListener, host: string, port: number) {
	let httpServer: http.Server | https.Server;

	if (process.env.SERVER_CERT_PATH && process.env.SERVER_KEY_PATH) {
		httpServer = https.createServer(
			{
				key: fs.readFileSync(process.env.SERVER_KEY_PATH),
				cert: fs.readFileSync(process.env.SERVER_CERT_PATH),
			},
			listener,
		);
	} else {
		httpServer = http.createServer(listener);
	}
	enableDestroy(httpServer);

	// Resolves once the server is closed
	const closed = new Promise<void>((resolve, reject) => {
		httpServer.addListener('close', resolve);
		httpServer.addListener('error', reject);
	});

	const previewable = {
		host,
		port,
		closed() {
			return closed;
		},
		async stop() {
			await new Promise((resolve, reject) => {
				httpServer.destroy((err) => (err ? reject(err) : resolve(undefined)));
			});
		},
	} satisfies PreviewServer;

	return {
		server: httpServer,
		...previewable,
	};
}