摘要：如果包含字符則將設(shè)置為。添加字段到不同的響應(yīng)頭將該字段添加到不同的響應(yīng)標(biāo)頭如果它尚未存在。

res.headersSent布爾屬性,app是否發(fā)送了httpheaders

const express = require("express");
const bodyParser = require("body-parser");
const cookieParser = require("cookie-parser")
const app = express();

app.use(bodyParser.json());// parsing application/json
app.use(bodyParser.urlencoded({ extended: true }));// parsing application/x-www-form-urlencoded
app.use(cookieParser())

app.get("/", (req, res) => {
    console.log(res.headersSent); // false
    res.send("OK");
    console.log(res.headersSent); // true
})
app.listen(3000);

res.append(filed,[value])添加響應(yīng)頭信息

使用res.append()之后調(diào)用res.set()將會重置先前設(shè)置的頭信息

const express = require("express");
const app = express();
app.get("/", (req, res) => {
    console.log(res.headersSent); // false
    res.append("Link", ["", ""]);
    res.append("Set-Cookie", "foo=bar; Path=/; HttpOnly");
    res.append("Warning", "199 Miscellaneous warning");
    res.attachment("path/to/logo.png");
    res.cookie("user", { name: "Jack", age: 18 });
    res.cookie("maxAge", 1000 * 60 * 60 * 24 * 30);
    res.send("OK");
    console.log(res.headersSent); // true
})
app.listen(3000);

res.attachment([filename])

設(shè)置HTTP響應(yīng)Content-Disposition字段attachment

如果參數(shù)為空,那么設(shè)置Content-Disposition:attachment

如果參數(shù)有值,那么將基于res.type()擴(kuò)展名設(shè)置Content-Type的值,并且設(shè)置Content-Disposition的值為參數(shù)值

res.attachment();
// Content-Disposition: attachment

res.attachment("path/to/logo.png");
// Content-Disposition: attachment; filename="logo.png"
// Content-Type: image/png

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

清除cookie信息res.clearCookie(name, [options])

設(shè)置cookie的name和value,value值可以是string或object,options是一個對象

domain,string,cookie的域名,默認(rèn)為該app的域名

expires,date,過期時間

httpOnly,boolean,cookie的標(biāo)志位,只能允許http web server

maxAge,string,用于設(shè)置過期時間相對于當(dāng)前時間 (以毫秒為單位) 的選項.

path,string,cookie的路徑,默認(rèn)為/

secure,boolean,標(biāo)記只用于HTTPS的cookie.

signed,boolean,指示是否應(yīng)對cookie進(jìn)行簽名.(有問題,需要cookie-parser)

所有的res.cookie ()都是用所提供的選項設(shè)置HTTP設(shè)置cookie頭.任何未指定的選項都默認(rèn)為RFC 6265中所述的值.
使用cookie-parser中間件時, 此方法還支持簽名的cookie.只需將簽名的選項設(shè)置為 true.然后,res cookie ()將使用傳遞給cookieParser(秘密) 的秘密來簽署該值.

res.download(path, [filename], [callback(err){...}])

const express = require("express");
const app = express();
app.get("/", (req, res) => {
    res.download("static/download/file.pdf", "file.pdf", (err) => {
        if (err) {
            res.send(err);
        }
    });
})
app.listen(3000);

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

不需要返回任何數(shù)據(jù),如果需要返回數(shù)據(jù),可以使用res.send()或者res.json()

res.get(field)

通過字段返回HTTP請求頭信息,大小寫敏感

res.get("Content-Type");
// => "image/png"

res.json([body])

方法類似于帶有一個對象參數(shù)或數(shù)組參數(shù)的res.send()

參數(shù)也可以為null或者undefined

res.json(null)
res.json({ user: "tobi" })
res.status(500).json({ error: "message" })

res.links(links)

res.links({
    next: "http://localhost:3000/users?page=2",
    next: "http://localhost: /users?page=5"
})

res.redirect([status], path)

如果不指定status狀態(tài),默認(rèn)狀態(tài)碼status code為302 Found

如果要跳轉(zhuǎn)到外部的鏈接,需要加上http://

返回上一步的頁面res.redirect("back");

返回上一級的頁面,如果現(xiàn)在是在http://example.com/admin/post/new頁面,想要跳轉(zhuǎn)到上一級頁面http//example.com/admin/post,使用res.redirect("..");

res.redirect("/users");
res.redirect(301, "http://localhost:3000/login")

res.render(view, [locals], [callback(err,html){...}])

模板引擎一般有ejs,jade,html

res.send([body])

參數(shù)可以是String,Buffer,Array

res.send(new Buffer("whoop"));
res.send({ some: "json" });
res.send("
some html
");
res.status(404).send("Sorry, we cannot find that!");
res.status(500).send({ error: "something blew up" });

res.sendFile(path, [options], [callback(err){...}])

根據(jù)文件名的擴(kuò)展名設(shè)置內(nèi)容類型響應(yīng)HTTP標(biāo)頭字段.除非在選項對象中設(shè)置了根選項, 否則路徑必須是文件的絕對路徑.

options是一個對象選項

maxAge,以毫秒為單位設(shè)置Cache-Control標(biāo)題頭的最大屬性或ms格式的字符串,默認(rèn)為0

root,相對文件名的根目錄

lastModified,將Last-Modified的標(biāo)題頭設(shè)置為操作系統(tǒng)上文件的最后修改日期.設(shè)置為false以禁用它.

headers,包含要與文件一起服務(wù)的HTTP標(biāo)頭的對象.

dotfiles,服務(wù)dotfiles的選項.可能的值是allow,deny,ignore,默認(rèn)值為ignore

router.get("/file/:name", (req, res, next) => {
    let options ={
        root: "./public/static/download/",
        dotfiles: "deny",
        headers: {
            "x-timestamp": Date.now(),
            "x-sent": true
        }
    };
    
    let fileName = req.params.name;
    res.sendFile(fileName, options, (err) => {
        if(err){
            console.log(err);
            res.status(err.status).end();
        }else{
            console.log("Sent: ",fileName)
        }
    })
});

res.sendStatus(statusCode)

將響應(yīng)HTTP狀態(tài)代碼設(shè)置為statusCode, 并將其字符串表示形式作為響應(yīng)正文發(fā)送.

res.sendStatus(200); // equivalent to res.status(200).send("OK")
res.sendStatus(403); // equivalent to res.status(403).send("Forbidden")
res.sendStatus(404); // equivalent to res.status(404).send("Not Found")
res.sendStatus(500); // equivalent to res.status(500).send("Internal Server Error")

res.set(field, [value])

可以單個設(shè)置,也可以用一個對象設(shè)置

res.set("Content-Type", "text/plain");

res.set({
  "Content-Type": "text/plain",
  "Content-Length": "123",
  "ETag": "12345"
})

res.status(code)

使用此方法可設(shè)置響應(yīng)的HTTP狀態(tài).它是節(jié)點響應(yīng)的式別名statusCode

res.status(403).end();
res.status(400).send("Bad Request");
res.status(404).sendFile("/absolute/path/to/404.png");

res.type(type)

將內(nèi)容類型HTTP標(biāo)頭設(shè)置為指定類型的mime.lookup()所確定的mime類型。如果type包含/字符, 則將Content-Type設(shè)置為type。

res.type(".html");              // => "text/html"
res.type("html");               // => "text/html"
res.type("json");               // => "application/json"
res.type("application/json");   // => "application/json"
res.type("png");                // => "image/png:"

res.vary(filed)

將該字段添加到不同的響應(yīng)標(biāo)頭 (如果它尚未存在)。

res.vary("User-Agent").render("docs");