logo

Objet de requête Express.js

Les objets Express.js Request et Response sont les paramètres de la fonction de rappel utilisée dans les applications Express.

L'objet de requête express.js représente la requête HTTP et possède des propriétés pour la chaîne de requête de la requête, les paramètres, le corps, les en-têtes HTTP, etc.

Syntaxe:

 app.get('/', function (req, res) { // -- }) 

Propriétés de l'objet de requête Express.js

Le tableau suivant spécifie certaines des propriétés associées à l'objet de requête.

Indice Propriétés Description
1. req.app Ceci est utilisé pour contenir une référence à l'instance de l'application express qui utilise le middleware.
2. req.baseurl Il spécifie le chemin URL sur lequel une instance de routeur a été montée.
3. corps requis Il contient des paires clé-valeur de données soumises dans le corps de la demande. Par défaut, il n'est pas défini et est renseigné lorsque vous utilisez un middleware d'analyse de corps tel que body-parser.
4. demande de cookies Lorsque nous utilisons un middleware d'analyse de cookies, cette propriété est un objet qui contient les cookies envoyés par la requête.
5. req.fresh Il précise que la demande est « fraîche ». c'est le contraire de req.stale.
6. req.nom d'hôte Il contient le nom d'hôte de l'en-tête http 'host'.
7. req.ip Il spécifie l'adresse IP distante de la requête.
8. req.ips Lorsque le paramètre de proxy de confiance est vrai, cette propriété contient un tableau d'adresses IP spécifiées dans le champ ?x-forwarded-for? en-tête de requête.
9. req.originalurl Cette propriété ressemble beaucoup à req.url ; cependant, il conserve l'URL de demande d'origine, vous permettant de réécrire librement req.url à des fins de routage interne.
dix. paramètres requis Un objet contenant des propriétés mappées sur la route nommée « paramètres ». Par exemple, si vous disposez de la route /user/:name, alors la propriété 'name' est disponible sous req.params.name. Cet objet est par défaut {}.
onze. chemin requis Il contient la partie chemin de l’URL de la demande.
12. protocole requis La chaîne du protocole de requête, « http » ou « https » lorsqu'elle est demandée avec TLS.
13. req.requête Objet contenant une propriété pour chaque paramètre de chaîne de requête dans la route.
14. req.route L'itinéraire actuellement correspondant, une chaîne.
quinze. req.secure Un booléen qui est vrai si une connexion TLS est établie.
16. req.signedcookies Lors de l'utilisation d'un middleware d'analyse de cookies, cette propriété contient des cookies signés envoyés par la requête, non signés et prêts à l'emploi.
17. demande périmée Il indique si la demande est « périmée » et est l'opposé de req.fresh.
18. req.sous-domaines Il représente un tableau de sous-domaines dans le nom de domaine de la requête.
19. req.xhr Une valeur booléenne qui est vraie si le champ d'en-tête « x-requested-with » de la requête est « xmlhttprequest », indiquant que la requête a été émise par une bibliothèque cliente telle que jQuery

Méthodes d'objet de requête

Voici une liste de quelques méthodes d'objet de requête généralement utilisées :

req.accepte (types)

Cette méthode est utilisée pour vérifier si les types de contenu spécifiés sont acceptables, en fonction du champ d'en-tête HTTP Accept de la demande.

Exemples:

 req.accepts('html'); //=>?html? req.accepts('text/html'); // => ?text/html? 

req.get (champ)

Cette méthode renvoie le champ d'en-tête de requête HTTP spécifié.

Exemples:

 req.get('Content-Type'); // => 'text/plain' req.get('content-type'); // => 'text/plain' req.get('Something'); // => undefined 

req.is(type)

Cette méthode renvoie true si le champ d'en-tête HTTP « Content-Type » de la requête entrante correspond au type MIME spécifié par le paramètre type.

Exemples:

 // With Content-Type: text/html; charset=utf-8 req.is('html'); req.is('text/html'); req.is('text/*'); // => true 

req.param (nom [, valeur par défaut])

Cette méthode est utilisée pour récupérer la valeur du nom du paramètre lorsqu'il est présent.

Exemples:

 // ?name=sasha req.param('name') // => 'sasha' // POST name=sasha req.param('name') // => 'sasha' // /user/sasha for /user/:name req.param('name') // => 'sasha'