Mercurial > hg > nginx-site
diff xml/ru/docs/http/ngx_http_js_module.xml @ 2149:6df1a86a60b8
Added new njs HTTP properties and methods.
author | Roman Arutyunyan <arut@nginx.com> |
---|---|
date | Fri, 06 Apr 2018 20:34:26 +0300 |
parents | ca7568f67dee |
children | cd4889fdcfa4 |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_js_module.xml +++ b/xml/ru/docs/http/ngx_http_js_module.xml @@ -9,7 +9,7 @@ <module name="Модуль ngx_http_js_module" link="/ru/docs/http/ngx_http_js_module.html" lang="ru" - rev="9"> + rev="10"> <section id="summary"> @@ -209,11 +209,73 @@ function baz(req, res) { объект переменных nginx, только чтение </tag-desc> +<tag-name><literal>response</literal></tag-name> +<tag-desc> +объект ответа (0.2.0), только чтение +</tag-desc> +</list> +</para> + +<para> +Объект запроса имеет следующие свойства: +<list type="tag"> + <tag-name><literal>log(<value>строка</value>)</literal></tag-name> <tag-desc> записывает <literal>строку</literal> в лог-файл ошибок на уровне лога <literal>info</literal> </tag-desc> + +<tag-name><literal>warn(<value>строка</value>)</literal></tag-name> +<tag-desc> +записывает <literal>строку</literal> в лог-файл ошибок +на уровне лога <literal>warning</literal> (0.2.0) +</tag-desc> + +<tag-name><literal>error(<value>строка</value>)</literal></tag-name> +<tag-desc> +записывает <literal>строку</literal> в лог-файл ошибок +на уровне лога <literal>error</literal> (0.2.0) +</tag-desc> + +<tag-name><literal>subrequest(<value>uri</value>[, <value>options</value>[, +<value>callback</value>]])</literal></tag-name> +<tag-desc> +создаёт подзапрос с заданными <literal>uri</literal> и +<literal>options</literal> и +устанавливает необязательный <literal>callback</literal> завершения (0.2.0). + +<para> +Если <literal>options</literal> является строкой, то в ней +содержится срока аргументов подзапроса. +В противном случае ожидается, что <literal>options</literal> является объектом +со следующими ключами: +<list type="tag"> +<tag-name><literal>args</literal></tag-name> +<tag-desc>строка с аргументами</tag-desc> + +<tag-name><literal>body</literal></tag-name> +<tag-desc>тело запроса</tag-desc> + +<tag-name><literal>method</literal></tag-name> +<tag-desc>метод HTTP</tag-desc> +</list> +</para> + +<para> +<literal>callback</literal> получает объект ответа +со следующими свойствами: +<literal>uri</literal>, <literal>method</literal>, +<literal>status</literal>, <literal>contentType</literal>, +<literal>contentLength</literal>, <literal>headers</literal>, +<literal>args</literal>. +Эти свойства имеют те же значения, что и свойства объекта запроса. +Дополнительно у объекта ответа есть свойство <literal>body</literal>, +содержащее тело ответа подзапроса, +и свойство <literal>parent</literal>, +ссылающееся на родительский объект запроса. +</para> +</tag-desc> </list> </para> @@ -263,6 +325,18 @@ function baz(req, res) { <tag-desc> завершает отправку ответа клиенту </tag-desc> + +<tag-name><literal>return(код[, строка])</literal></tag-name> +<tag-desc> +отправляет +клиенту полный ответ с указанным <literal>кодом</literal> (0.2.0) +<para> +Можно задать или URL перенаправления +(для кодов 301, 302, 303, 307 и 308), +или текст тела ответа (для остальных кодов) в качестве второго аргумента. +</para> +</tag-desc> + </list> </para>