express()

创建一个Express应用程序。该express()功能是express模块导出的顶级功能。

var express = require('express')
var app = express()

方法

express.json（[options]）

Express v4.16.0及更高版本中提供了此中间件。

这是Express中的内置中间件功能。它使用body解析器解析带有JSON负载的传入请求 。
返回仅解析JSON并且仅查看Content-Type标头与type选项匹配的请求的中间件。该解析器接受主体的任何Unicode编码，并支持gzip和 deflate编码的自动填充。
如果没有要解析的主体，不匹配的主体或发生错误，则将body包含已解析数据的新对象填充request 到中间件之后的req.body对象上；{}如果没有要解析的主体，则填充一个空对象（）Content-Type。

由于req.body的形状基于用户控制的输入，因此该对象中的所有属性和值都不可信，应在可信之前进行验证。例如，req.body.foo.toString()可能以多种方式失败，例如 foo可能不存在或可能不是字符串，并且toString可能不是函数，而是字符串或其他用户输入。

下表描述了可选options对象的属性。

express.raw（[options]）

Express v4.17.0及更高版本中提供了此中间件。

这是Express中的内置中间件功能。它将传入的请求有效内容解析为，Buffer并基于 body-parser。
返回将所有主体解析为a的中间件，Buffer并且仅查看Content-Type标头与type选项匹配的请求。该解析器接受主体的任何Unicode编码，并支持gzip和 deflate编码的自动填充。
如果没有要解析的主体，不匹配的主体或发生错误，则将body Buffer包含解析后的数据的新request 对象填充到中间件之后的req.body对象上；{}如果没有要解析的主体，则填充一个空对象（）Content-Type。

由于req.body的形状基于用户控制的输入，因此该对象中的所有属性和值都不可信，应在可信之前进行验证。例如，req.body.toString()可能以多种方式失败，例如，堆叠多个解析器req.body可能来自不同的解析器。测试是否req.body是一个Buffer建议调用缓存方法之前。

下表描述了可选options对象的属性。

express.Router（[options]）

创建一个新的路由器对象。

var router = express.Router([options])

可选options参数指定路由器的行为。

您可以添加中间件和HTTP方法路由（如get，put，post，等），以router就像一个应用程序。
有关更多信息，请参见Router。

express.static（root，[options]）

这是Express中的内置中间件功能。它提供静态文件，并基于serve-static。

注意：为了获得最佳结果，请使用反向代理缓存来提高服务静态资产的性能。

该root参数指定要从其提供静态资产的根目录。该功能通过req.url与提供的root目录结合来确定要服务的文件。当找不到文件时，它不发送404响应，而是调用next() 移至下一个中间件，从而可以进行堆栈和回退。
下表描述了options对象的属性。另请参见下面示例。

有关更多信息，请参见在Express中提供静态文件。和使用中间件-内置中间件。

dotfiles

该选项的可能值为：

• “allow”-对dotfiles没有特殊处理。
• “deny”-拒绝对dotfiles的请求，以响应403，然后调用next()。
• “ignore”-就像dotfiles不存在一样，用响应404，然后调用next()。

注意：使用默认值时，它将不会忽略以dotfiles的目录中的文件。

fallthrough

当此选项为时true，客户端错误（例如错误的请求或对不存在的文件的请求）将导致此中间件简单地调用next()以调用堆栈中的下一个中间件。设为false时，这些错误（即使是404错误）也会调用next(err)。
将此选项设置为，true以便您可以将多个物理目录映射到同一网址，或用于路由以填充不存在的文件。
使用false如果你已经安装该中间件在设计是严格意义上的单一文件系统的目录，它允许较少的开销短路404的路径。该中间件还将答复所有方法。

setHeaders

对于此选项，请指定用于设置自定义响应标题的函数。标头的更改必须同步进行。
该函数的签名是：

fn(res, path, stat)

参数：

• res，响应对象。
• path，即正在发送的文件路径。
• stat，stat即正在发送的文件的对象。

  express.static的示例

  这是将express.static中间件功能与精心设计的options对象结合使用的示例：

  var options = {
  dotfiles: 'ignore',
  etag: false,
  extensions: ['htm', 'html'],
  index: false,
  maxAge: '1d',
  redirect: false,
  setHeaders: function (res, path, stat) {
    res.set('x-timestamp', Date.now())
  }
  }
  app.use(express.static('public', options))
  

  express.text（[options]）

  Express v4.17.0及更高版本中提供了此中间件。

这是Express中的内置中间件功能。它将传入的请求有效负载解析为字符串，并且基于 body-parser。
返回将所有主体解析为字符串并且仅查看Content-Type标头与type选项匹配的请求的中间件。该解析器接受主体的任何Unicode编码，并支持gzip和 deflate编码的自动填充。
body包含request 中间件（例如req.body）之后的对象上将填充一个包含已解析数据的新字符串，{}如果没有要解析的主体，该对象Content-Type不匹配或发生错误，则在该对象上填充一个空对象（）。

由于req.body的形状基于用户控制的输入，因此该对象中的所有属性和值都不可信，应在可信之前进行验证。例如，req.body.trim()可能以多种方式失败，例如，堆叠多个解析器req.body可能来自不同的解析器。req.body建议在调用字符串方法之前测试该字符串。

下表描述了可选options对象的属性。

express.urlencoded（[options]）

Express v4.16.0及更高版本中提供了此中间件。

这是Express中的内置中间件功能。它使用urlencoded的有效载荷解析传入的请求，并且基于body-parser。
返回仅解析urlencoded主体并且仅查看Content-Type标头与type选项匹配的请求的中间件。此解析器接受体的唯一的UTF-8编码并支持的自动充气gzip和deflate编码。
如果没有要解析的主体，不匹配的主体或发生错误，则将body包含已解析数据的新对象填充request 到中间件之后的req.body对象上；{}如果没有要解析的主体，则填充一个空对象（）Content-Type。该对象将包含键-值对，其中该值可以是一个字符串或阵列（时extended是false），或任何类型的（当extended 是true）。

由于req.body的形状基于用户控制的输入，因此该对象中的所有属性和值都不可信，应在可信之前进行验证。例如，req.body.foo.toString()可能以多种方式失败，例如 foo可能不存在或可能不是字符串，并且toString可能不是函数，而是字符串或其他用户输入。

下表描述了可选options对象的属性。