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	Fri Apr 06 20:17:57 2018 +0300
+++ b/xml/ru/docs/http/ngx_http_js_module.xml	Fri Apr 06 20:34:26 2018 +0300
@@ -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 @@
 объект переменных 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 @@
 <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>