Mercurial > hg > nginx-site
comparison xml/en/docs/njs/reference.xml @ 2546:6093e9f3615e
Documented rawHeadersIn and rawHeadersOut in njs.
| author | Yaroslav Zhuravlev <yar@nginx.com> |
|---|---|
| date | Tue, 19 May 2020 15:05:49 +0100 |
| parents | dca5a7053a6c |
| children | 428a8cf1911b |
comparison
equal
deleted
inserted
replaced
| 2545:dca5a7053a6c | 2546:6093e9f3615e |
|---|---|
| 166 <tag-name><literal>r.remoteAddress</literal></tag-name> | 166 <tag-name><literal>r.remoteAddress</literal></tag-name> |
| 167 <tag-desc> | 167 <tag-desc> |
| 168 client address, read-only | 168 client address, read-only |
| 169 </tag-desc> | 169 </tag-desc> |
| 170 | 170 |
| 171 <tag-name id="r_raw_headers_in"><literal>r.rawHeadersIn{}</literal></tag-name> | |
| 172 <tag-desc> | |
| 173 returns an array of key-value pairs | |
| 174 exactly as they were received from the client | |
| 175 (<link doc="changes.xml" id="njs0.4.1">0.4.1</link>). | |
| 176 <para> | |
| 177 For example, with the following request headers: | |
| 178 <example> | |
| 179 Host: localhost | |
| 180 Foo: bar | |
| 181 foo: bar2 | |
| 182 </example> | |
| 183 the output of <literal>r.rawHeadersIn</literal> will be: | |
| 184 <example> | |
| 185 [ | |
| 186 ['Host', 'localhost'], | |
| 187 ['Foo', 'bar'], | |
| 188 ['foo', 'bar2'] | |
| 189 ] | |
| 190 </example> | |
| 191 All <literal>foo</literal> headers | |
| 192 can be collected with the syntax: | |
| 193 <example> | |
| 194 r.rawHeadersIn.filter(v=>v[0].toLowerCase() == 'foo').map(v=>v[1]) | |
| 195 </example> | |
| 196 the output will be: | |
| 197 <example> | |
| 198 ['bar', 'bar2'] | |
| 199 </example> | |
| 200 Header field names are not converted to lower case, | |
| 201 duplicate field values are not merged. | |
| 202 </para> | |
| 203 </tag-desc> | |
| 204 | |
| 205 <tag-name id="r_raw_headers_out"><literal>r.rawHeadersOut{}</literal></tag-name> | |
| 206 <tag-desc> | |
| 207 returns an array of key-value pairs of response headers | |
| 208 (<link doc="changes.xml" id="njs0.4.1">0.4.1</link>). | |
| 209 Header field names are not converted to lower case, | |
| 210 duplicate field values are not merged. | |
| 211 </tag-desc> | |
| 212 | |
| 171 <tag-name id="r_request_body"><literal>r.requestBody</literal></tag-name> | 213 <tag-name id="r_request_body"><literal>r.requestBody</literal></tag-name> |
| 172 <tag-desc> | 214 <tag-desc> |
| 173 returns the client request body if it has not been | 215 returns the client request body if it has not been |
| 174 written to a temporary file. | 216 written to a temporary file. |
| 175 To ensure that the client request body is in memory, | 217 To ensure that the client request body is in memory, |