comparison xml/ru/docs/http/ngx_http_js_module.xml @ 2787:005b056c267f

Added note about async calls for js_body_filter, js_header_filter.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 21 Oct 2021 15:11:56 +0100
parents 65591dd31d64
children 652356b39f0f
comparison
equal deleted inserted replaced
2786:6b3a80a735bf 2787:005b056c267f
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="32"> 12 rev="33">
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> позволяет задавать
211 (если присутствует) в 211 (если присутствует) в
212 <link id="js_header_filter"><literal>js_header_filter</literal></link>, 212 <link id="js_header_filter"><literal>js_header_filter</literal></link>,
213 чтобы применить поблочное кодирование. 213 чтобы применить поблочное кодирование.
214 </para> 214 </para>
215 215
216 <para>
217 <note>
218 Так как обработчик <literal>js_body_filter</literal>
219 должен сразу возвращать результат,
220 то поддерживаются только синхронные операции,
221 Таким образом, асинхронные операции, например
222 <link doc="../njs/reference.xml" id="r_subrequest">r.subrequest()</link>
223 или
224 <link doc="../njs/reference.xml" id="settimeout">setTimeout()</link>,
225 не поддерживаются.
226 </note>
227 </para>
228
216 </directive> 229 </directive>
217 230
218 231
219 <directive name="js_content"> 232 <directive name="js_content">
220 <syntax><value>функция</value> | <value>модуль.функция</value></syntax> 233 <syntax><value>функция</value> | <value>модуль.функция</value></syntax>
316 <appeared-in>0.5.1</appeared-in> 329 <appeared-in>0.5.1</appeared-in>
317 330
318 <para> 331 <para>
319 Задаёт функцию njs в качестве фильтра заголовка ответа. 332 Задаёт функцию njs в качестве фильтра заголовка ответа.
320 Директива позволяет менять произвольные поля заголовка ответа. 333 Директива позволяет менять произвольные поля заголовка ответа.
334 </para>
335
336 <para>
337 <note>
338 Так как обработчик <literal>js_header_filter</literal>
339 должен сразу возвращать результат,
340 то поддерживаются только синхронные операции,
341 Таким образом, асинхронные операции, например
342 <link doc="../njs/reference.xml" id="r_subrequest">r.subrequest()</link>
343 или
344 <link doc="../njs/reference.xml" id="settimeout">setTimeout()</link>,
345 не поддерживаются.
346 </note>
321 </para> 347 </para>
322 348
323 </directive> 349 </directive>
324 350
325 351
428 454
429 <para> 455 <para>
430 <note> 456 <note>
431 Так как обработчик <literal>js_set</literal> 457 Так как обработчик <literal>js_set</literal>
432 должен сразу возвращать результат, 458 должен сразу возвращать результат,
433 то поддерживаются только синхронные вызовы, 459 то поддерживаются только синхронные операции,
434 Таким образом, асинхронные вызовы, например 460 Таким образом, асинхронные операции, например
435 <link doc="../njs/reference.xml" id="r_subrequest">r.subrequest()</link> 461 <link doc="../njs/reference.xml" id="r_subrequest">r.subrequest()</link>
436 или 462 или
437 <link doc="../njs/reference.xml" id="settimeout">setTimeout()</link>, 463 <link doc="../njs/reference.xml" id="settimeout">setTimeout()</link>,
438 не поддерживаются. 464 не поддерживаются.
439 </note> 465 </note>