Mercurial > hg > nginx-site

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
2531:9c8a89d3876f 2532:423d813dc8bb
74 74
75 <tag-name id="r_headers_out"><literal>r.headersOut{}</literal></tag-name> 75 <tag-name id="r_headers_out"><literal>r.headersOut{}</literal></tag-name>
76 <tag-desc> 76 <tag-desc>
77 объект исходящих заголовков, доступно для записи. 77 объект исходящих заголовков, доступно для записи.
78 <para> 78 <para>
79 Например, доступ к заголовку <literal>Foo</literal> 79 Доступ к заголовку ответа <literal>Foo</literal>
80 можно получить при помощи синтаксиса <literal>headersOut.foo</literal> 80 можно получить при помощи синтаксиса:
81 или <literal>headersOut['Foo']</literal> 81 <literal>headersOut.foo</literal> или <literal>headersOut['Foo']</literal>
82 </para>
83
84 <para>
85 Значения полей многозначных заголовков ответа
86 (<link doc="changes.xml" id="njs0.4.0">0.4.0</link>)
87 можно задать при помощи синтаксиса:
88 <example>
89 r.headersOut[‘Foo’] = [‘a’, ‘b’]
90 </example>
91 результат:
92 <example>
93 Foo: a
94 Foo: b
95 </example>
96 Все предыдущие значения поля заголовка ответа <header>Foo</header>
97 будут удалены.
98 </para>
99
100 <para>
101 В стандартных заголовках ответа,
102 поля которых могут принимать только одно значение, например
103 <header>Content-Type</header>,
104 учитывается только последний элемент массива.
105 Дубликаты значений поля в заголовках ответа
106 <header>Age</header>,
107 <header>Content-Encoding</header>,
108 <header>Content-Length</header>,
109 <header>Content-Type</header>,
110 <header>ETag</header>,
111 <header>Expires</header>,
112 <header>Last-Modified</header>,
113 <header>Location</header>,
114 <header>Retry-After</header>
115 игнорируются.
116 Все другие дубликаты значений поля заголовка ответа
117 соединяются при помощи запятой (“<literal>,</literal>”).
118 Значения поля в заголовке ответа <header>Set-Cookie</header>
119 всегда возвращаются в виде массива.
82 </para> 120 </para>
83 </tag-desc> 121 </tag-desc>
84 122
85 <tag-name><literal>r.httpVersion</literal></tag-name> 123 <tag-name><literal>r.httpVersion</literal></tag-name>
86 <tag-desc> 124 <tag-desc>