Node.js

Node.js는 JavaScript 코드를 브라우저 밖에서 실행하는 오픈소스 런타임 환경입니다. 파일과 네트워크를 다루는 기능을 제공해 서버 프로그램이나 명령줄 도구를 만드는 데 쓰입니다. JavaScript라는 언어와 이를 실행하는 환경은 구별하며, 브라우저에서 쓰던 코드의 동작 여부는 그 코드가 의존하는 API에 따라 달라집니다.

JavaScript 실행과 시스템 기능

Node.js 공식 소개는 Node.js를 여러 운영체제에서 사용할 수 있는 JavaScript 런타임으로 설명합니다. 내부에서는 V8 엔진이 JavaScript 실행을 담당합니다. 여기에 파일과 네트워크 등을 다루는 기능이 더해져 프로그램을 구성합니다. 엔진은 언어를 실행하는 부분이고, Node.js는 그 엔진과 실행에 필요한 기능을 함께 제공하는 환경입니다.

웹 서버는 Node.js의 대표적인 사용 사례입니다. 공식 소개의 HTTP 서버 예제는 요청이 들어오면 상태 코드와 응답 헤더를 설정하고 본문을 돌려주는 흐름을 보여 줍니다. 이때 브라우저는 요청을 보내고 응답을 받는 클라이언트이며, Node.js 프로그램은 서버 쪽에서 실행됩니다. 같은 JavaScript로 작성하더라도 어느 쪽에서 실행되는지에 따라 접근할 수 있는 자원과 담당하는 일이 달라집니다.

터미널에서 JavaScript 파일을 실행할 수도 있습니다. 서버처럼 네트워크 요청을 계속 기다리는 프로그램뿐 아니라 파일을 읽거나 결과를 출력하는 도구도 같은 실행 환경을 활용합니다. Node.js를 설치한다는 말은 이런 코드를 실행할 환경을 갖춘다는 뜻입니다. 특정 서비스의 서버 코드나 업무 기능은 그 위에서 실행할 프로그램으로 따로 작성하거나 가져와야 합니다.

브라우저 환경과의 차이

Node.js와 브라우저의 차이 문서는 두 환경이 같은 언어를 쓰면서도 서로 다른 API를 제공한다고 설명합니다. 브라우저의 화면 문서를 다루는 document와 window는 Node.js가 기본으로 제공하는 브라우저 객체가 아닙니다. 화면 요소를 찾거나 바꾸는 코드가 브라우저에서 실행되었다고 해서 Node.js에서도 그대로 작동하지는 않습니다.

반대로 Node.js는 모듈을 통해 파일 시스템 같은 운영 환경의 기능에 접근하는 API를 제공합니다. 브라우저 페이지의 스크립트는 Node.js 모듈을 그대로 가져와 같은 방식으로 파일을 다루는 환경이 아닙니다. 두 환경에서 코드를 공유하려면 공통으로 지원되는 기능과 환경에 의존하는 부분을 구분합니다. 언어 문법이 같다는 사실과 사용 가능한 기능이 같다는 사실은 서로 다른 조건입니다.

모듈을 불러오는 방식도 확인할 대상입니다. Node.js는 CommonJS와 ECMAScript 모듈을 지원하며, 코드의 require()와 import 사용은 프로젝트의 모듈 설정과 연결됩니다. 문서의 예제를 일부 복사할 때는 함수 이름뿐 아니라 어떤 모듈 체계로 실행하는 예제인지도 살펴봅니다. 모듈 설정이 다른 코드를 섞어 생긴 오류를 JavaScript 언어 자체의 차이로 해석하면 원인을 놓치기 쉽습니다.

비동기 입출력과 실행 조건

Node.js의 비동기 입출력 설명에 따르면 네트워크나 파일 시스템의 응답을 기다리는 작업은 완료되었을 때 처리를 이어가는 방식으로 구성할 수 있습니다. 요청마다 새 스레드를 만드는 방식만으로 동시 요청을 처리하는 것은 아닙니다. 여러 요청이 입출력을 기다리는 동안에도 다른 작업을 진행할 수 있도록 하는 구조가 서버 프로그램에서 활용됩니다.

비동기라는 말은 요청한 결과가 즉시 준비된다는 뜻과 다릅니다. 파일 내용을 사용하는 작업은 실제 읽기 결과가 나온 뒤에 이어져야 하고, 네트워크 요청도 응답이나 실패를 처리해야 합니다. 실행 순서를 이해할 때는 코드에 적힌 위치만 보지 않고 어떤 작업이 완료되기를 기다리는지 함께 봅니다. 비동기 API를 썼다는 사실만으로 모든 입력과 실행 조건에서 처리 속도가 같아지지는 않습니다.

실행할 Node.js 버전과 프로젝트가 요구하는 기능도 맞아야 합니다. 서버 운영자는 실행 환경을 선택할 수 있지만, 웹사이트 방문자가 어떤 브라우저를 사용하는지는 같은 방식으로 통제하기 어렵습니다. 개발 환경에서 동작한 프로그램을 다른 곳으로 옮길 때는 대상 환경의 Node.js 버전, 모듈 설정, 필요한 파일과 접근 조건을 확인합니다. 설치 여부와 프로그램이 요구하는 조건의 충족 여부를 나누어 보면 실행 문제를 좁힐 수 있습니다.