Node.js - objeto de solicitação
o req objeto representa a solicitação HTTP e tem propriedades para a string de consulta da solicitação, parâmetros, corpo, cabeçalhos HTTP e assim por diante.
Solicitar Propriedades do Objeto
A seguir está a lista de algumas propriedades associadas ao objeto de solicitação.
Sr. Não. | Propriedades e descrição |
---|---|
1 | req.app Esta propriedade contém uma referência à instância do aplicativo expresso que está usando o middleware. |
2 | req.baseUrl O caminho do URL no qual uma instância do roteador foi montada. |
3 | req.body Contém pares de valores-chave de dados enviados no corpo da solicitação. Por padrão, é indefinido e é preenchido quando você usa middleware de análise de corpo, comobody-parser |
4 | req.cookies Ao usar o middleware analisador de cookies, esta propriedade é um objeto que contém cookies enviados pela solicitação. |
5 | req.fresh Indica se a solicitação é "recente". É o oposto de req.stale. |
6 | req.hostname Contém o nome do host do cabeçalho HTTP "Host". |
7 | req.ip O endereço IP remoto da solicitação. |
8 | req.ips Quando a configuração do proxy confiável é verdadeira, esta propriedade contém uma matriz de endereços IP especificados no cabeçalho da solicitação “X-Forwarded-For”. |
9 | req.originalUrl Essa propriedade é muito parecida com req.url; no entanto, ele retém o URL de solicitação original, permitindo que você reescreva req.url livremente para fins de roteamento interno. |
10 | req.params Um objeto que contém propriedades mapeadas para os “parâmetros” da rota nomeada. Por exemplo, se você tiver a rota / usuário /: nome, a propriedade "nome" estará disponível como req.params.name. O padrão deste objeto é {}. |
11 | req.path Contém a parte do caminho do URL da solicitação. |
12 | req.protocol A string de protocolo de solicitação, "http" ou "https" quando solicitada com TLS |
13 | req.query Um objeto que contém uma propriedade para cada parâmetro de string de consulta na rota. |
14 | req.route A rota atualmente combinada, uma string. |
15 | req.secure Um booleano que é verdadeiro se uma conexão TLS for estabelecida. |
16 | req.signedCookies Ao usar o middleware analisador de cookies, esta propriedade contém cookies assinados enviados pela solicitação, não assinados e prontos para uso. |
17 | req.stale Indica se a solicitação está "obsoleta" e é o oposto de req.fresh. |
18 | req.subdomains Uma matriz de subdomínios no nome de domínio da solicitação. |
19 | req.xhr Um valor booleano que é verdadeiro se o campo de cabeçalho "X-Requested-With" da solicitação for “XMLHttpRequest”, indicando que a solicitação foi emitida por uma biblioteca cliente como a jQuery. |
Métodos de solicitação de objeto
req.accepts (tipos)
req.accepts(types)
Este método verifica se os tipos de conteúdo especificados são aceitáveis, com base no campo de cabeçalho Aceitar HTTP da solicitação. A seguir estão alguns exemplos -
// Accept: text/html
req.accepts('html');
// => "html"
// Accept: text/*, application/json
req.accepts('html');
// => "html"
req.accepts('text/html');
// => "text/html"
req.get (campo)
req.get(field)
Este método retorna o campo de cabeçalho de solicitação HTTP especificado. A seguir estão alguns exemplos -
req.get('Content-Type');
// => "text/plain"
req.get('content-type');
// => "text/plain"
req.get('Something');
// => undefined
req.is (tipo)
req.is(type)
Este método retorna verdadeiro se o campo de cabeçalho HTTP "Content-Type" da solicitação de entrada corresponder ao tipo MIME especificado pelo parâmetro type. A seguir estão alguns exemplos -
// With Content-Type: text/html; charset=utf-8
req.is('html');
req.is('text/html');
req.is('text/*');
// => true
req.param (name [, defaultValue])
req.param(name [, defaultValue])
Este método retorna o valor do nome do parâmetro quando presente. A seguir estão alguns exemplos -
// ?name=tobi
req.param('name')
// => "tobi"
// POST name=tobi
req.param('name')
// => "tobi"
// /user/tobi for /user/:name
req.param('name')
// => "tobi"