Mercurial > hg > nginx-site
diff xml/en/docs/njs/reference.xml @ 2543:f39c4724c0f8
Described multi-value headers in r.headersIn.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 19 May 2020 15:05:49 +0100 |
parents | d6bbfd20c82f |
children | 33347df1da9c |
line wrap: on
line diff
--- a/xml/en/docs/njs/reference.xml Tue May 19 12:54:47 2020 +0100 +++ b/xml/en/docs/njs/reference.xml Tue May 19 15:05:49 2020 +0100 @@ -9,7 +9,7 @@ <article name="Reference" link="/en/docs/njs/reference.html" lang="en" - rev="40"> + rev="41"> <section id="summary"> @@ -53,21 +53,36 @@ <tag-desc> incoming headers object, read-only. <para> -For example, the <literal>Foo</literal> header -can be accessed with the syntax <literal>headersIn.foo</literal> -or <literal>headersIn['Foo']</literal> -<note> -Before version <link doc="changes.xml" id="njs0.3.6">0.3.6</link>, -for headers that could appear multiple times such as -<header>Cookie</header> or <header>X-Forwarded-For</header>, -only the first value was returned. -To get all cookies, -<literal>r.variables.http_cookie</literal> -should be used. -To get the <literal>name</literal> cookie, -<literal>r.variables["cookie_<value>name</value>"]</literal> -should be used. -</note> +The <literal>Foo</literal> request header +can be accessed with the syntax: +<literal>headersIn.foo</literal> or <literal>headersIn['Foo']</literal>. +</para> + +<para> +The +<header>Authorization</header>, +<header>Content-Length</header>, +<header>Content-Range</header>, +<header>Content-Type</header>, +<header>ETag</header>, +<header>Expect</header>, +<header>From</header>, +<header>Host</header>, +<header>If-Match</header>, +<header>If-Modified-Since</header>, +<header>If-None-Match</header>, +<header>If-Range</header>, +<header>If-Unmodified-Since</header>, +<header>Max-Forwards</header>, +<header>Proxy-Authorization</header>, +<header>Referer</header>, +<header>Transfer-Encoding</header>, and +<header>User-Agent</header> +request headers can have only one field value +(<link doc="changes.xml" id="njs0.4.1">0.4.1</link>). +Duplicate field values in <header>Cookie</header> headers +are separated by semicolon (<literal>;</literal>). +Duplicate field values in all other request headers are separated by commas. </para> </tag-desc>