logo

Obiekt żądania Express.js

Obiekty Request i Response Express.js to parametry funkcji wywołania zwrotnego wykorzystywanej w aplikacjach Express.

Obiekt żądania express.js reprezentuje żądanie HTTP i ma właściwości dotyczące ciągu zapytania żądania, parametrów, treści, nagłówków HTTP itd.

Składnia:

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

Właściwości obiektu żądania Express.js

Poniższa tabela określa niektóre właściwości powiązane z obiektem żądania.

Indeks Nieruchomości Opis
1. wymagana aplikacja Służy do przechowywania odniesienia do instancji aplikacji ekspresowej korzystającej z oprogramowania pośredniczącego.
2. wymaga.baseurl Określa ścieżkę URL, na której zamontowano instancję routera.
3. wymaganie ciała Zawiera pary klucz-wartość danych przesłane w treści żądania. Domyślnie jest niezdefiniowany i jest wypełniany, gdy używasz oprogramowania pośredniczącego do analizowania treści, takiego jak analizator treści.
4. wymagaj plików cookie Kiedy korzystamy z oprogramowania pośredniczącego analizującego pliki cookie, ta właściwość jest obiektem zawierającym pliki cookie wysyłane przez żądanie.
5. zam.świeże Określa, że ​​żądanie jest „świeże”. jest to przeciwieństwo żądania nieaktualnego.
6. wymagana nazwa hosta Zawiera nazwę hosta z nagłówka http „host”.
7. wymaganie.ip Określa zdalny adres IP żądania.
8. wymagania.ips Jeśli ustawienie zaufania proxy ma wartość true, ta właściwość zawiera tablicę adresów IP określonych we właściwości ?x-forwarded-for? nagłówek żądania.
9. wymaga.oryginalnego adresu URL Ta właściwość jest bardzo podobna do req.url; jednakże zachowuje oryginalny adres URL żądania, umożliwiając swobodne przepisanie pliku req.url na potrzeby wewnętrznego routingu.
10. wymagane parametry Obiekt zawierający właściwości odwzorowane na nazwaną trasę „parametry”. Na przykład, jeśli masz trasę /user/:name, wówczas właściwość 'name' jest dostępna jako req.params.name. Domyślnie ten obiekt ma wartość {}.
jedenaście. wymagana ścieżka Zawiera część ścieżki adresu URL żądania.
12. wymaga.protokół Ciąg protokołu żądania, „http” lub „https”, jeśli jest żądany za pomocą protokołu TLS.
13. zapytanie Obiekt zawierający właściwość dla każdego parametru ciągu zapytania w trasie.
14. wymagana trasa Aktualnie dopasowana trasa, ciąg znaków.
piętnaście. wymagane bezpieczne Wartość logiczna, która ma wartość true, jeśli nawiązano połączenie TLS.
16. wymagaj podpisanych plików cookie W przypadku korzystania z oprogramowania pośredniego analizującego pliki cookie ta właściwość zawiera podpisane pliki cookie wysłane na żądanie, niepodpisane i gotowe do użycia.
17. wymaganie nieaktualne Wskazuje, czy żądanie jest „nieaktualne” i jest przeciwieństwem req.fresh.
18. wymaga.subdomen Reprezentuje tablicę subdomen w nazwie domeny żądania.
19. wymaganie xhr Wartość logiczna, która jest prawdziwa, jeśli pole nagłówka „x-requested-with” żądania to „xmlhttprequest”, co wskazuje, że żądanie zostało wydane przez bibliotekę klienta, taką jak jQuery

Zapytaj o metody obiektu

Poniżej znajduje się lista niektórych powszechnie używanych metod obiektów żądań:

wymagania akceptuje (typy)

Ta metoda służy do sprawdzania, czy określone typy zawartości są akceptowalne, na podstawie pola nagłówka Accept HTTP żądania.

Przykłady:

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

żądanie.get(pole)

Ta metoda zwraca określone pole nagłówka żądania HTTP.

Przykłady:

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

wymaganie (typ)

Ta metoda zwraca wartość true, jeśli pole nagłówka HTTP „Content-Type” żądania przychodzącego jest zgodne z typem MIME określonym przez parametr type.

Przykłady:

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

req.param(nazwa [, wartość domyślna])

Ta metoda służy do pobrania wartości nazwy parametru, jeśli jest obecna.

Przykłady:

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