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'