comparison xml/ru/docs/http/ngx_http_js_module.xml @ 2675:893cd7724c8c

Documented the "r" argument for js_body_filter.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 09 Mar 2021 18:44:56 +0000
parents 9e39e64bff84
children 8751cab1d562
comparison
equal deleted inserted replaced
2674:e87c0ffc3492 2675:893cd7724c8c
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_http_js_module" 9 <module name="Модуль ngx_http_js_module"
10 link="/ru/docs/http/ngx_http_js_module.html" 10 link="/ru/docs/http/ngx_http_js_module.html"
11 lang="ru" 11 lang="ru"
12 rev="24"> 12 rev="25">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_http_js_module</literal> позволяет задавать 17 Модуль <literal>ngx_http_js_module</literal> позволяет задавать
130 Задаёт функцию njs в качестве фильтра тела ответа. 130 Задаёт функцию njs в качестве фильтра тела ответа.
131 Функция фильтра вызывается для каждого блока данных тела ответа 131 Функция фильтра вызывается для каждого блока данных тела ответа
132 со следующими аргументами: 132 со следующими аргументами:
133 133
134 <list type="tag"> 134 <list type="tag">
135 <tag-name><literal>r</literal></tag-name>
136 <tag-desc>
137 объект <link doc="../njs/reference.xml" id="http">HTTP request</link>
138 </tag-desc>
139
135 <tag-name><literal>data</literal></tag-name> 140 <tag-name><literal>data</literal></tag-name>
136 <tag-desc> 141 <tag-desc>
137 входящий блок данных 142 входящий блок данных
138 может быть строкой или буфером 143 может быть строкой или буфером
139 в зависимости от значения <literal>buffer_type</literal>, 144 в зависимости от значения <literal>buffer_type</literal>,
159 Функция фильтра может передавать свою модифицированную версию 164 Функция фильтра может передавать свою модифицированную версию
160 входящего блока данных следующему фильтру тела ответа при помощи вызова 165 входящего блока данных следующему фильтру тела ответа при помощи вызова
161 <link doc="../njs/reference.xml" id="r_sendbuffer"><literal>r.sendBuffer()</literal></link>. 166 <link doc="../njs/reference.xml" id="r_sendbuffer"><literal>r.sendBuffer()</literal></link>.
162 Пример преобразования букв в нижний регистр в теле ответа: 167 Пример преобразования букв в нижний регистр в теле ответа:
163 <example> 168 <example>
164 function filter(data, flags) { 169 function filter(r, data, flags) {
165 r.sendBuffer(data.toLowerCase(), flags); 170 r.sendBuffer(data.toLowerCase(), flags);
166 } 171 }
167 </example> 172 </example>
168 Для отмены фильтра (блоки данных будут передаваться клиенту 173 Для отмены фильтра (блоки данных будут передаваться клиенту
169 без вызова <literal>js_body_filter</literal>), 174 без вызова <literal>js_body_filter</literal>),