changeset 2441:080581ce888d

Added note to r.headersIn in njs Reference.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 07 Oct 2019 14:41:16 +0300
parents 7a353370ffcd
children 437350febcb7
files xml/en/docs/njs/reference.xml xml/ru/docs/njs/reference.xml
diffstat 2 files changed, 23 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/njs/reference.xml
+++ b/xml/en/docs/njs/reference.xml
@@ -9,7 +9,7 @@
 <article name="Reference"
         link="/en/docs/njs/reference.html"
         lang="en"
-        rev="30">
+        rev="31">
 
 <section id="summary">
 
@@ -56,6 +56,17 @@ incoming headers object, read-only.
 For example, the <literal>Foo</literal> header
 can be accessed with the syntax <literal>headersIn.foo</literal>
 or <literal>headersIn['Foo']</literal>
+<note>
+For headers that can appear multiple times such as
+<header>Cookie</header> or <header>X-Forwarded-For</header>,
+only the first value will be 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>
 </para>
 </tag-desc>
 
--- a/xml/ru/docs/njs/reference.xml
+++ b/xml/ru/docs/njs/reference.xml
@@ -57,6 +57,17 @@
 Например, доступ к заголовку <literal>Foo</literal>
 можно получить при помощи синтаксиса <literal>headersIn.foo</literal>
 или <literal>headersIn['Foo']</literal>
+<note>
+Если заголовок может быть указан несколько раз, например
+<header>Cookie</header> или <header>X-Forwarded-For</header>,
+будет возвращено только первое значение.
+Чтобы получить все cookie
+необходимо использовать
+<literal>r.variables.http_cookie</literal>.
+Чтобы получить <literal>имя</literal> cookie
+необходимо использовать
+<literal>r.variables["cookie_<value>имя</value>"]</literal>.
+</note>
 </para>
 </tag-desc>