콘텐츠로 이동

StartDevServerOptions

Defined in: core/index.ts:579

NativeModule.startDevServer

optional certPath?: string

Defined in: core/index.ts:593

HTTPS cert (PEM). keyPath 와 함께 줘야.


optional entry?: string

Defined in: core/index.ts:589

--bundle entry. 지정 시 dev server 가 bundle 결과 서빙.


optional host?: string

Defined in: core/index.ts:587

Bind host. “localhost”/“127.0.0.1” (default) 또는 “0.0.0.0”.


optional keyPath?: string

Defined in: core/index.ts:595

HTTPS key (PEM). certPath 와 함께 줘야.


optional lazyCompilation?: boolean

Defined in: core/index.ts:619

Lazy on-demand compilation. Default false. When true, the dev server builds with code-splitting + lazy mode (IIFE registry): only the entry chunk is served at /bundle.js, and each dynamic import() target is compiled on demand when the browser requests its chunk URL. Reduces cold-start time for large apps (parse work is deferred to first use).

Note: this is honored by the native (startDevServer) dev server only. The zntc dev web CLI runs a separate JS dev server that does not yet support lazy compilation — tracked as a backlog item.


optional open?: boolean

Defined in: core/index.ts:591

Open default browser at server URL. Default false.


optional port?: number

Defined in: core/index.ts:585

TCP port (0-65535). Default 12300. 0 은 OS-assigned ephemeral port — getDevServerPort(handle) 로 실제 값 조회.


optional quiet?: boolean

Defined in: core/index.ts:607

stderr 의 banner + 모든 routine log silence. NAPI embed default true (자체 logger 가정). false 로 명시하면 stderr 출력. quiet 가드되는 카테고리 전체 리스트는 src/server/dev_server.zigDevServer.routineLog doc (CANONICAL SCOPE LIST) 참조 — 단일 진실 소스.

critical 진단은 quiet 와 무관 항상 stderr — init failure (cert 로드 / 디렉토리 못 찾음 / overlay sentinel), start fatal (host parse / listen 실패 / watch thread spawn), deinit UAF 경고. 사용자가 throw 메시지 너머의 root cause 를 추적할 수 있도록 보장.


rootDir: string

Defined in: core/index.ts:580