Express 탐구 - 2 <Request, Response>

Request

req 객체는 HTTP 요청을 나타내며 요청 쿼리 문자열, 매개 변수, 본문, HTTP 헤더 등에 대한 속성을 나타냄

객체 req는 Node 자체 요청 객체의 향상된 버전이며 모든 기본 제공 필드 및 메서드를 지원

속성

req.app

Express 애플리케이션의 인스턴스에 대한 참조

req.baseUrl

라우터 인스턴스가 마운트된 URL 경로 app.mountpath 과 유사

req.body

키-값 의 형태의 request body 데이터를 의미, 기본값은 undefined, req.body 는 상황마다 다르기 때문에 신뢰할 수 없다.

req.cookies

cookie-parser 를 사용할 경우 쿠키 객체를 나타냄 기본 값은 {}

req.fresh

클라이언트의 캐시가 최신 상태인지를 판단 여부 유효한 경우 true 리턴 아닌 경우 false 리턴

req.stale

req.fresh 랑 반대

req.hostname

HTTP header 에 있는 hostname 내용 반환

req.ip

ip 반환

req.method

HTTP 메서드 이름 반환

req.originalUrl

전체 url 반환

req.params

파라미터 반환

req.path

path 반환

req.protocol

프로토콜 반환 ex) http

req.query

쿼리반환

req.res

res 의 참조

req.route

route 관련 객체 반환

req.subdomains

서브 도메인 배열 반환

req.xhr

클라이언트 라이브러리에서 요청을 발행했음을 나타내는 "XMLHttpRequest" 인지 여부

메서드

req.accepts(type) [type: string | boolean]

요청의 HTTP 헤더 필드를 기반으로 지정된 content type이 허용되는지 확인

req.is(type)

요청의 HTTP 헤더 필드를 기반으로 지정된 content type이 일치하는지 확인

req.acceptsCharsets(charset [, ...])

req.acceptsEncodings(encoding [, ...])

req.acceptsLanguages(lang [, ...])

req.get(field)

지정된 HTTP 요청 헤더 필드를 반환합니다

req.param(name [, defaultValue])

param 반환

req.range(size[, options])

요청한 리소스의 일부 범위를 지정 원하는 범위의 데이터를 요청

Response

Express 앱이 HTTP 요청을 받을 때 보내는 HTTP 응답을 나타낸다.

속성

res 객체는 Express 앱이 HTTP 요청을 받을 때 보내는 HTTP 응답을 나타냅니다.

res.app

Express 애플리케이션의 인스턴스에 대한 참조

res.headersSent

앱이 응답을 위해 HTTP 헤더를 보냈는지 여부

res.locals

응답과 관련된 데이터를 저장하고 템플릿 엔진이나 다음 미들웨어에서 사용할 수 있으며 단일 요청-응답 주기 내에서 사용할 수 있기 때문에 로컬 변수를 유지하려면 대신 app.locals를 사용하는 것이 적절하다.

메서드

기본 기능

res.req

req 객체의 참조를 보유

res.get(field)

HTTP 응답 헤더를 반환

---

1. 헤더 설정 관련

res.append(field [, value])

HTTP response 헤더 필드에 변수를 추가하며 헤더가 아직 설정되지 않은 경우 지정된 값으로 헤더를 생성

res.attachment([filename])

HTTP 응답 헤더에 "Content-Disposition"을 설정하여 파일 다운로드를 유발하는 역할

res.type(type)

Content-Type HTTP 헤더를 설정

res.vary(field)

응답 헤더 에 Vary 필드를 추가

res.cookie(name, value [, options])

쿠키 name 및 value 를 설정하는 메서드

res.clearCookie(name [, options])

쿠키를 지우는 메서드

res.download(path [, filename] [, options] [, fn])

파일을 다운로드하기 위한 천체적인 HTTP 응답을 구성

res.format(object)

"Accept" 헤더에 따라 다른 응답 형식을 선택적으로 보낼 수 있는 메서드

res.links(links)

"Link" 헤더를 추가

res.location(path)

path 헤더를 추가

2. 응답 관련

res.end([data] [, encoding])

응답 프로세스를 종료, 데이터 없이 빠르게 응답을 종료할 때 사용

res.send([body])

HTTP 응답을 보냅니다.

res.redirect([status,] path)

라이언트를 다른 URL로 바로 redirect 하는 역할을 하며, 응답을 생성합니다.

res.json([body])

JSON 응답을 보냄

res.jsonp([body])

JSONP는 Same-Origin Policy로 인해 발생하는 제한을 우회하기 위해 사용되는 기술
JSONP를 사용하면 다른 도메인의 API에서 데이터를 요청하고 응답을 받을 수 있다.

res.sendFile(path [, options] [, fn])

파일을 응답으로 전송 res.download 의 내용과 흡사하며 바로 응답하는지 여부가 차이점이다.

res.sendStatus(statusCode)

HTTP 코드 응답

res.render(view [, locals] [, callback])

view를 렌더링하고 렌더링된 HTML 문자열을 클라이언트에 보냅니다