NPM

TypeScript

1. JavaScript에 타입이 추가된 수퍼셋. 컴파일하면 자바스크립트 코드가 된다

↓shell

$ npm install --save-dev typescript $ npx tsc file-name.ts --target es6
2. 타입스크립트에서는 생성자 매개변수 앞에 public/private 접근한정자가 있으면 자동으로 클래스의 속성으로 선언한다
3. VS Code의 타입스크립트 컴파일러를 npm 패키지로 설정

"typescript.tsdk": "C:/Users/name/AppData/Roaming/npm/node_modules/typescript/bin/tsc"

디버깅

• 코드 사이에 중단점 삽입

↓javascript

debugger;
• node 실행 시 디버깅 켜기

↓shell

$ node debug app.js # 또는 $ node inspect app.js
• 자동으로 디버깅 포트를 열며, chrome://inspect 등으로도 이용 가능
• 명령어
1. n : 다음 문장; next
2. c : 다음 중단점; continue
3. s : step into
4. o : step out
5. watch(expr) : expr 평가 감시
6. exec(expr) : expr 평가
7. repl : 디버깅 REPL에서 직접 코드로 확인
8. help
9. .exit

Lib/Cluster

• 멀티 코어 CPU의 성능을 이용하기 위해, 동일한 로직을 이용하는 멀티 프로세스 생성/관리 기능 제공
• 프로세스는 마스터(cluster.isMaster)와 워커로 구성
• 자식(워커) 프로세스들은 부모 프로세스와 TCP 연결을 공유할 수 있다
cluster.test.js

Lib/Console

↓javascript

Lib/Events

• class EventEmitter
• 이벤트 발행 주체

기본적으로 이벤트 구독/해지에 대해 자동으로 'newListener', 'removeListener' 이벤트 발행

• events 모듈의 exports 자체가 EventEmitter 클래스다

↓javascript

const EventEmitter = require('events') class My extends EventEmitter {}
• EventEmitter.defaultMaxListeners

기본값 10

• emitter.on(string|symbol eventName, Function listener)

이벤트 핸들러 등록(구독)

== addListener ↔ off, + removeListener, prependListener, removeAllListeners

• emitter.once(string|symbol eventName, Function listener) + prependOnceListener

이벤트 1회 구독

• emitter.emit(string|symbol eventName[, any ...args])
1. 이벤트 발행

구독자가 있으면 true, 없으면 false 반환

2. 이벤트 핸들러는 동기적으로 실행되며, 반환값은 무시된다
3. 핸들러 내에서 this 키워드는 이벤트를 발행한 EventEmitter 인스턴스를 가리킨다

단, 람다 함수에서는 this 키워드가 EventEmitter 인스턴스를 가리키지 않는다

• emitter.eventNames()

사용자가 구독 요청한 이벤트 이름들을 배열로 반환

• emitter.getMaxListeners() + setMaxListeners
• emitter.listeners(string|symbol eventName) + listenerCount, rawListeners Since 9.4
• error 이벤트

'error' 이벤트 구독자가 없는 경우, EventEmitter 내의 예외는 밖으로 던져지고 프로세스는 종료된다

• newListener, removeListener 이벤트

핸들러 : (string|symbol eventName, Function listener)

• events.once(EventEmitter emitter, string name) : Promise Since 11.13

name 이벤트 발행 또는 'error' 이벤트 발행시 emit()의 args 그대로 Promise가 실행된다

• events.on(EventEmitter emitter, string|symbol eventName) : AsyncIterator

eventName 이벤트 발행 시 emit()의 args를 배열로 받는다

↓javascript

const { on, EventEmitter } = require('events'); (async () => { //... for await (const event of on(emitter, 'foo')) {} })

Lib/Globals

• this == global
• TextDecoder Since 11 == util.TextDecoder
• TextEncoder Since 11 == util.TextEncoder
• URL == url.URL
• URLSearchParams Since 10 == url.URLSearchParams
• WebAssembly Since 8

아직 개발중인 웹 어셈블리와의 호환을 위한 네임스페이스

• class Buffer
• __filename, __dirname : 실행 중인 소스 파일 정보. REPL 모드에서는 당연히 없다
• console : 콘솔 관련
• exports, module, require() : 모듈 관련
• process : 프로세스 관련
• setTimeout, clearTimeout, setInterval, clearInterval, setImmediate, clearImmediate : timer 관련
• queueMicrotask(Function callback) Since 11

"microtask queue"는 V8 엔진이 관리하며, 동작은 process.nextTick()과 유사하다. 이벤트 루프 어느 페이즈에서든지 "next tick queue"가 항상 "microtask queue"보다 먼저 실행된다

Lib/HTTP, HTTPS

• HTTP, HTTPS Client 예

↓javascript

const express = require('express') const http = require('http') const https = require('https') const app = express() app.get('/**', (req, res, next) => { let url = req.params.url if (url.startsWith('https')) { https.get(url, { headers: { 'accept-encoding': 'gzip' } }, (res2) => { let bufs = [] res2.on('data', buf => bufs.push(buf)) res2.on('end', () => { res.set(res2.headers) res.send(Buffer.concat(bufs)) }) }) } else if (url.startsWith('http')) { http.get(url, { headers: { 'accept-encoding': 'gzip' } }, (res2) => { let bufs = [] res2.on('data', buf => bufs.push(buf)) res2.on('end', () => { res.set(res2.headers) res.send(Buffer.concat(bufs)) }) }) } else res.send('OK') })

Lib/Modules

1. require(string id)
• 각 파일들은 별개의 모듈로 취급된다

require('./foo/bar.js');

• 로드된 모듈은 캐시되므로, 반복적인 require()는 같은 객체를 반환한다

require()가 두 개 이상의 파일을 찾은 경우, 요구한 이름의 대소문자를 바꾼 경우 등은 예외

• 모듈이 Node에 의해 직접 실행되는 경우, require.main으로 설정된다

따라서 require.main === module로 현재 모듈이 메인인지 판별 가능하다

• 모듈 사이에 require() 사이클이 존재하는 경우, 초기화 완료되지 않은 exports 객체를 반환하여 무한 반복을 방지한다
• 모듈을 /usr/lib/node_modules/{name}/{version} 경로로 관리하면 효율적인 require() 가능
• require알고리즘

확장자 없는 파일 X, X.js 파일, X.json 파일, X.node 파일, X/index.js 디렉터리, X/package.json 디렉터리 등을 적절히 처리

• 선두 '/', './', '../' 없이 요구된 모듈
1. core 모듈이면 해당 모듈 로드
2. ROOT 디렉터리에 도달할 때까지, {부모 디렉터리}/node_modules/{X} 모듈을 탐색
• 아무데서도 모듈을 찾지 못한 경우, $NODE_PATH 환경변수의 디렉터리를 탐색하지만, $NODE_PATH 사용은 권장되지 않는다
2. 디렉터리를 모듈로
1. package.json

↓javascript

{ "name" : "some-library", "main" : "./lib/some-library.js" }
2. index.js
3. 로드된 모듈의 실행은 아래와 유사하다

↓javascript

(function(exports, require, module, __filename, __dirname) { // Module code actually lives in here });
1. 모듈 top-level에 정의된 변수들이 모듈 스코프에 존재
2. 모듈 밖에서는 exports를 공유

최초 exports는 module.exports를 가리키므로, exports에 다른 객체를 할당하는 경우, 해당 부분은 외부와 공유되지 않는다. 외부에 공유하려면 module.exports = exports = newObject

3. 모듈 안에서는 __filename, __dirname을 편리하게 획득

Lib/Process

• Event 'beforeExit'

정상 종료 전, process.exitCode를 인자로 콜백이 호출된다. process.exit() 등으로 종료하는 경우 호출되지 않는다. 콜백에서 비동기 호출로 프로그램 종료를 지연시킬 수 있다

• Event 'exit'

정상 종료 및 process.exit() 호출 시 process.exitCode를 인자로 콜백이 호출된다. 콜백은 동기적 연산만 수행해야 한다

• Event 'multipleResolves' Since 10.12
• 임의 Promise의 두 번째 resolve 또는 reject 호출부터 콜백이 호출된다

Promise.race() 호출처럼, 경우에 따라서 이 이벤트 발생이 에러가 아닐수도 있다

• 콜백 : (string type, Promise promise, any value)
• process.abort()

강제 종료. Worker 스레드에서는 실행 불가

• process.chdir(directory)

실행 위치 변경

• string[] process.argv
• Object process.env
• string process.execPath
• string[] process.execArgv
• process.nextTick(Function callback[, any ...args])

callback을 "next tick queue"에 추가한다. args는 callback의 인자가 된다. callback은 현재 페이즈에서 실행 중인 코드가 모두 완료된 후 즉시 실행되며, setImmediate()보다 빠르게 실행된다

• integer process.pid
• integer process.ppid Since 9.2, Since 8.10

부모 프로세스 PID

• Stream process.stdin, stdout, stderrprocess.sample.js

3rd/CryptoJS

해싱, 암/복호화, 인코딩/디코딩 관련 함수 제공

• npm - crypto-js
• CryptoJS document
• 브라우저용 스크립트

3rd/express : Web Framework

• 정적 리소스 제공에는 Nginx, CDN, Amazon S3 등을 고려함이 좋다
• Quick start

아래 명령으로 프로젝트 골격을 빠르게 구성할 수 있다

↓shell

npx express-generator # Since 8.2 # Before 8.2 npm install -g express-generator express
• 서버 시작

↓javascript

const express = require('express') const app = express() app.listen(3000, () => console.log(`Server Started`))
• 실행 환경
1. 환경 변수 이름 : NODE_ENV
2. 기본 : development
3. 릴리스 : production
4. process.env.NODE_ENV로 획득 가능
• 서버 설정

app.set(name, value)	예약된 키워드들이 있음에 유의
app.set('port', process.env.PORT || 55555)	서버 포트
app.set('views', path.join(__dirname, 'templates'))	템플릿 디렉터리
app.set('view engine', 'pug')	템플릿 확장자

• Method 라우팅

path에는 regex 사용 가능

↓javascript

app.all('/', (req, res) => {}) app.get('/', (req, res) => {}) app.post('/', (req, res) => {})
• 응답

↓javascript

res.render(view[, data][, callback])
• Middleware : 요청 처리 체인의 앞부분에서 전처리를 하며, 다음으로 넘어갈지 결정

↓javascript

function (req, res, next) { // Do something next(); } app.use(middleware);
• static 파일 전송 미들웨어
1. static 디렉터리 파일들을 전송하는 미들웨어 사용

↓javascript

app.use(express.static(path.join(__dirname, 'static')));
2. 요청 URL과 실제 디렉터리 경로를 다르게 하고 싶은 경우

↓javascript

app.use('/static', express.static(path.join(__dirname, 'ag3t9a23gt')));
• 세션

cookie-parser, express-session 모듈 이용

3rd/fastify : Web Framework

• 보다 효율적으로 요청을 처리하는 웹 프레임워크

테스트 조건 하에서, 초당 5만건 이상의 Hello World 응답 처리

• CORS만 적용한 기본 프로젝트 예.app.js

3rd/forever : 종료 시 자동 재시작

• 스크립트 영구 실행
• forever 모듈을 코드에서 호출하는 경우, forever-monitor가 도움이 된다
• CLI 호출

↓shell

forever [action] [options] SCRIPT [script-options] forever start name.js forever start config.json

↓javascript

// config.json [ { // App1 "uid": "app1", "append": true, "watch": true, "script": "index.js", "sourceDir": "/home/myuser/app1" }, { // App2 "uid": "app2", "append": true, "watch": true, "script": "index.js", "sourceDir": "/home/myuser/app2", "args": ["--port", "8081"] } ]

3rd/Pug : 템플릿 엔진(구 Jade)

• pug -P // Pretty

기본 옵션은 불필요한 공백 제거

• ↓ 아래 코드들은 1.11.0 버전 결과임
• 주석doc1.pug결과 »
• Plain Textdoc2.pug결과 »
• 코드 실행doc3.pug결과 »
• 태그 속성doc4.pug결과 »
• 다른 문서 포함mainparttext결과 »
• 템플릿 - mixindoc6.pug결과 »
• 템플릿 - extendstemplatemain 예시1 »결과1 »main 예시1 »결과1 »

3rd/mocha : 테스트 프레임워크

• 설치

↓shell

npm install mocha --save-dev mkdir test

↓javascript

// package.json "scripts": { "test": "mocha" }

test1.js

• 비동기 코드 테스트
• 테스트 함수가 콜백을 인자로 받아 비동기 작업 완료 후 호출
• 예외 발생 시 예외 객체 그대로 전달하면 알아서 fail로 간주
• 콜백이 2회 이상 호출된 경우 fail로 간주
test2.js
• 또는 그냥 Promise를 반환하면 알아서 성공/실패 판단
• 실행 환경이 지원한다면, 테스트 함수 자체를 async로 해도 무방
• Hooking
test3.js
• before : 첫 번째 테스트 실행 전 한 번만 실행
• beforeEach : 매 테스트 실행 전 한 번씩 실행
• after : 마지막 테스트 실행 후 한 번만 실행
• afterEach : 매 테스트 실행 후 한 번씩 실행
• 각 hook들은 비동기 테스트 코드처럼 done을 받는 비동기 작업을 해도 된다
• describe.only(), it.only() : only 붙은 것만 테스트
• describe.skip(), it.skip() : 스킵

this.skip()으로 런타임 중 스킵 가능 ← 테스트 함수 및 'before' hook 안에서 사용 가능

• this.retries(n) : (행위) 테스트에서 재시도를 하도록 설정
• 시간 제한 : this.timeout(n), setTimeout(done, 300)

3rd/mongodb : MongoDB 공식 드라이버

• http://mongodb.github.io/node-mongodb-native/3.6/tutorials/
• http://mongodb.github.io/node-mongodb-native/3.6/api/
mongodb.test.js