Deno Runtime Reference

Deno와 Node.js는 모두 V8 위에 구축된 JavaScript 런타임이지만 몇 가지 주요 차이점이 있습니다. Deno는 기본적으로 보안적입니다. 명시적인 퍼미션 플래그를 부여하지 않으면 파일, 네트워크, 환경 변수 접근이 모두 거부됩니다. Deno는 설정 없이 TypeScript를 기본 지원합니다. ES 모듈(import/export)을 기본으로 사용하며 package.json이나 node_modules가 없습니다. 의존성은 URL이나 JSR에서 직접 가져옵니다. 포매터(deno fmt), 린터(deno lint), 테스트 러너(deno test), 번들러(deno compile)가 내장되어 있습니다. Node.js가 더 큰 생태계를 갖지만, Deno는 npm: 지정자를 통해 많은 npm 패키지와 호환됩니다.

기본적으로 Deno 스크립트는 파일 시스템, 네트워크, 환경 변수, 서브프로세스에 접근할 수 없습니다. 스크립트 실행 시 CLI 플래그로 명시적으로 권한을 부여해야 합니다. 주요 플래그: --allow-net(전체 네트워크), --allow-net=example.com(특정 도메인), --allow-read(전체 파일), --allow-read=./data(특정 경로), --allow-write=./output(특정 경로), --allow-env(전체 env), --allow-env=PORT(특정 변수), --allow-run=git(특정 서브프로세스). 개발 편의를 위해 --allow-all(-A)을 사용할 수 있지만 프로덕션에서는 사용하지 마세요. Deno.permissions.request()로 런타임에 퍼미션을 요청할 수도 있습니다.

Deno 1.35에서 안정화된 Deno.serve()가 가장 간단한 방법입니다. 포트와 Request를 받아 Response를 반환하는 핸들러 함수를 전달합니다: Deno.serve({ port: 8000 }, (req) => new Response("Hello!")). 완전한 웹 프레임워크로는 Oak가 많이 사용됩니다: import { Application } from "jsr:@oak/oak". 실행: deno run --allow-net server.ts. Deno.serve()는 Web 표준 Request/Response API를 사용하여 Cloudflare Workers 같은 다른 런타임과 코드 이식성을 보장합니다.

deno run --allow-net server.ts는 네트워크 퍼미션으로 스크립트를 실행합니다. deno fmt는 모든 TypeScript/JavaScript 파일을 Deno 스타일(Prettier와 유사)로 포매팅합니다. deno fmt --check는 파일을 수정하지 않고 포매팅을 검증합니다(CI에 유용). deno lint는 일반적인 코드 품질 문제를 검사합니다. deno lint --fix는 수정 가능한 문제를 자동으로 수정합니다. deno test는 Deno.test()로 정의된 *_test.ts나 *.test.ts 패턴의 파일을 실행합니다. deno bench는 Deno.bench()로 정의된 벤치마크를 실행합니다. deno compile --allow-net server.ts는 스크립트를 독립 실행 파일로 컴파일합니다.

deno.json(또는 deno.jsonc)은 Deno의 프로젝트 설정 파일입니다. 지원하는 설정: "tasks" 키 아래 태스크 정의(npm scripts와 유사) — deno task name으로 실행; 모듈 별칭을 위한 "imports"(Import Map) — "std/": "https://deno.land/std/"; TypeScript 설정을 위한 compilerOptions; 린트 규칙 및 포매터 옵션. 포함/제외 파일, 테스트 패턴, 안정화되지 않은 API 플래그도 설정 가능합니다. deno task dev를 실행하면 deno.json에 정의된 "dev" 태스크가 실행됩니다.

Import Maps는 짧은 모듈 지정자를 전체 URL에 매핑합니다. 모든 파일에 import { Application } from "https://deno.land/x/oak/mod.ts"를 작성하는 대신, deno.json이나 별도의 importmap.json의 "imports" 필드에 "oak": "jsr:@oak/oak@^14"를 정의합니다. 그러면 프로젝트 어디서든 import { Application } from "oak"로 작성할 수 있습니다. Import Maps는 "@/": "./src/" 같은 경로 별칭도 지원합니다. TypeScript의 paths 설정이나 package.json의 # imports 필드와 동일한 역할입니다.

Deno.Command는 자식 프로세스를 실행하는 현재 API입니다(폐기된 Deno.run() 대체). 명령 생성: const cmd = new Deno.Command("ls", { args: ["-la"] }). cmd.output()을 호출하면 stdout/stderr을 Uint8Array로 수집하고, cmd.spawn()은 스트리밍 I/O로 장시간 실행 프로세스를 시작합니다. --allow-run 퍼미션(또는 특정 실행 파일로 범위를 제한하는 --allow-run=ls)이 필요합니다. new TextDecoder().decode(output.stdout)로 출력을 문자열로 변환합니다.

deno compile --allow-net server.ts는 Deno 런타임, 스크립트, 모든 의존성을 포함하는 독립 실행 바이너리를 생성합니다. 출력 파일은 Deno를 별도로 설치하지 않고도 같은 OS/아키텍처의 모든 기기에서 실행할 수 있습니다. 필요한 모든 퍼미션 플래그를 컴파일 명령에 포함하면 바이너리의 기본값으로 내장됩니다. --output my-server로 출력 파일명을 지정합니다. 크로스 컴파일(다른 OS용 빌드)은 --target 플래그와 x86_64-unknown-linux-gnu 같은 타겟 트리플을 사용합니다.