diff xml/ru/docs/njs/reference.xml @ 2532:423d813dc8bb

Documented support for multi-value headers in r.headersOut.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 23 Apr 2020 12:57:43 +0100
parents 6ce28e0beec0
children d6bbfd20c82f
line wrap: on
line diff
--- a/xml/ru/docs/njs/reference.xml
+++ b/xml/ru/docs/njs/reference.xml
@@ -76,9 +76,47 @@
 <tag-desc>
 объект исходящих заголовков, доступно для записи.
 <para>
-Например, доступ к заголовку <literal>Foo</literal>
-можно получить при помощи синтаксиса <literal>headersOut.foo</literal>
-или <literal>headersOut['Foo']</literal>
+Доступ к заголовку ответа <literal>Foo</literal>
+можно получить при помощи синтаксиса:
+<literal>headersOut.foo</literal> или <literal>headersOut['Foo']</literal>
+</para>
+
+<para>
+Значения полей многозначных заголовков ответа
+(<link doc="changes.xml" id="njs0.4.0">0.4.0</link>)
+можно задать при помощи синтаксиса:
+<example>
+r.headersOut[‘Foo’] = [‘a’, ‘b’]
+</example>
+результат:
+<example>
+Foo: a
+Foo: b
+</example>
+Все предыдущие значения поля заголовка ответа <header>Foo</header>
+будут удалены.
+</para>
+
+<para>
+В стандартных заголовках ответа,
+поля которых могут принимать только одно значение, например
+<header>Content-Type</header>,
+учитывается только последний элемент массива.
+Дубликаты значений поля в заголовках ответа
+<header>Age</header>,
+<header>Content-Encoding</header>,
+<header>Content-Length</header>,
+<header>Content-Type</header>,
+<header>ETag</header>,
+<header>Expires</header>,
+<header>Last-Modified</header>,
+<header>Location</header>,
+<header>Retry-After</header>
+игнорируются.
+Все другие дубликаты значений поля заголовка ответа
+соединяются при помощи запятой (“<literal>,</literal>”).
+Значения поля в заголовке ответа <header>Set-Cookie</header>
+всегда возвращаются в виде массива.
 </para>
 </tag-desc>