logo

Objecte de sol·licitud Express.js

Els objectes de petició i resposta d'Express.js són els paràmetres de la funció de devolució de trucada que s'utilitza a les aplicacions Express.

L'objecte de sol·licitud express.js representa la sol·licitud HTTP i té propietats per a la cadena de consulta de sol·licitud, paràmetres, cos, capçaleres HTTP, etc.

Sintaxi:

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

Propietats de l'objecte de sol·licitud Express.js

La taula següent especifica algunes de les propietats associades a l'objecte de sol·licitud.

Índex Propietats Descripció
1. req.app S'utilitza per mantenir una referència a la instància de l'aplicació express que utilitza el programari intermedi.
2. req.baseurl Especifica la ruta d'URL on es va muntar una instància d'encaminador.
3. cos requerit Conté parelles clau-valor de dades enviades al cos de la sol·licitud. De manera predeterminada, no està definit i s'omple quan utilitzeu programari intermedi d'anàlisi corporal, com ara l'analitzador corporal.
4. req.cookies Quan utilitzem programari intermedi d'analitzador de galetes, aquesta propietat és un objecte que conté galetes enviades per la sol·licitud.
5. req.fresc Especifica que la sol·licitud és 'fresca'. és el contrari de req.stale.
6. req.hostname Conté el nom d'amfitrió de la capçalera http 'amfitrió'.
7. req.ip Especifica l'adreça IP remota de la sol·licitud.
8. req.ips Quan la configuració del servidor intermediari de confiança és certa, aquesta propietat conté una matriu d'adreces IP especificades a l'expedient ?x-forwarded-for? capçalera de la sol·licitud.
9. req.originalurl Aquesta propietat és molt semblant a req.url; tanmateix, conserva l'URL de sol·licitud original, la qual cosa us permet reescriure req.url lliurement per a finalitats d'encaminament intern.
10. req.params Un objecte que conté propietats assignades a la ruta anomenada ?paràmetres?. Per exemple, si teniu la ruta /usuari/:nom, la propietat 'nom' està disponible com a req.params.name. Aquest objecte és per defecte {}.
11. ruta requerida Conté la part del camí de l'URL de la sol·licitud.
12. protocol requerit La cadena de protocol de sol·licitud, 'http' o 'https' quan se sol·licita amb TLS.
13. consulta requerida Un objecte que conté una propietat per a cada paràmetre de cadena de consulta de la ruta.
14. ruta requerida La ruta que coincideix actualment, una cadena.
15. req.secure Un booleà que és cert si s'estableix una connexió TLS.
16. req.signedcookies Quan s'utilitza programari intermedi d'analitzador de galetes, aquesta propietat conté galetes signades enviades per la sol·licitud, sense signar i llestes per al seu ús.
17. exigit Indica si la sol·licitud és 'obsoleta' i és el contrari de req.fresh.
18. subdominis req Representa una matriu de subdominis al nom de domini de la sol·licitud.
19. requeriment xhr Un valor booleà que és cert si el camp de capçalera 'x-requested-with' de la sol·licitud és 'xmlhttprequest', que indica que la sol·licitud va ser emesa per una biblioteca client com ara jQuery

Mètodes d'objecte de sol·licitud

A continuació es mostra una llista d'alguns mètodes d'objecte de sol·licitud d'ús general:

req.acceptes (tipus)

Aquest mètode s'utilitza per comprovar si els tipus de contingut especificats són acceptables, segons el camp de capçalera Accept HTTP de la sol·licitud.

Exemples:

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

req.get(camp)

Aquest mètode retorna el camp de capçalera de sol·licitud HTTP especificat.

Exemples:

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

req.is (tipus)

Aquest mètode retorna true si el camp de capçalera HTTP 'Tipus de contingut' de la sol·licitud entrant coincideix amb el tipus MIME especificat pel paràmetre de tipus.

Exemples:

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

req.param(nom [, valor predeterminat])

Aquest mètode s'utilitza per obtenir el valor de param name quan està present.

Exemples:

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