diff xml/en/docs/http/ngx_http_js_module.xml @ 2747:42fb92e582db

Added note to js_set about asyncronous calls.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 05 Jul 2021 15:32:26 +0100
parents 3cbd6e440581
children a2852750c379
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_js_module.xml
+++ b/xml/en/docs/http/ngx_http_js_module.xml
@@ -9,7 +9,7 @@
 <module name="Module ngx_http_js_module"
         link="/en/docs/http/ngx_http_js_module.html"
         lang="en"
-        rev="28">
+        rev="29">
 
 <section id="summary">
 
@@ -319,6 +319,19 @@ This handler can be used to do some clea
 right before the request is freed.
 </para>
 
+<para>
+<note>
+As the <literal>js_set</literal> handler
+returns its result immediately, it supports
+only synchronous callbacks.
+Thus, asynchronous callbacks such as
+<link doc="../njs/reference.xml" id="r_subrequest">r.subrequest()</link>
+or
+<link doc="../njs/reference.xml" id="settimeout">setTimeout()</link>
+are not supported.
+</note>
+</para>
+
 </directive>