Mercurial > hg > nginx-site
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>