路由決定應用程式如何回應不同 URI 的請求。一個路由通常由請求路徑、HTTP 方法與處理函式組成,基本結構如下。
app.METHOD(path, callback);
其中 app 是 Express 實例,METHOD 是 HTTP 請求方法,path 是伺服器上的路徑,callback 是符合路由條件時要執行的函式。
var express = require('express');
var app = express();
app.get('/', function(req, res) {
res.send('hello world');
});
Express 可對應多種 HTTP 請求方法,最常用的是 GET 與 POST。
app.get('/', function(req, res) {
res.send('GET request to the homepage');
});
app.post('/', function(req, res) {
res.send('POST request to the homepage');
});
除了 get、post,也常看到 put、delete、patch、options、head 等方法。若要對同一路徑的所有請求做統一處理,可使用 app.all。
app.all('/secret', function(req, res, next) {
console.log('進入 secret 區域');
next();
});
路由路徑可以是字串、字串模式或正則表達式。Express 使用 path-to-regexp 來匹配路徑。
app.get('/about', function(req, res) {
res.send('about');
});
app.get('/ab?cd', function(req, res) {
res.send('ab?cd');
});
app.get(/.*fly$/, function(req, res) {
res.send('fly');
});
同一個路由可以有多個處理函式,行為類似中間件。若要在多個函式之間繼續執行,需要呼叫 next。
app.get('/example/a', function(req, res) {
res.send('Hello from A');
});
app.get('/example/b', function(req, res, next) {
console.log('交給下一個函式處理');
next();
}, function(req, res) {
res.send('Hello from B');
});
回應物件 res 提供多種方法,例如 send、json、render、redirect、end。若路由處理函式沒有送出任何回應,客戶端請求可能會一直等待。