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'