# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1579624674 0
# Node ID b60e5be733cdc5078845a9c94c9c308c4f865bff
# Parent  9bf87153b1b3b0308fe51d63b5cc2242acf581b0
Added Example of promisified requests to njs.

diff --git a/xml/en/docs/njs/examples.xml b/xml/en/docs/njs/examples.xml
--- a/xml/en/docs/njs/examples.xml
+++ b/xml/en/docs/njs/examples.xml
@@ -9,7 +9,7 @@
 <article name="Examples"
         link="/en/docs/njs/examples.html"
         lang="en"
-        rev="7">
+        rev="8">
 
 <section id="helloword" name="Hello World">
 
@@ -353,4 +353,51 @@ are available as part of our
 
 </section>
 
+
+<section id="promisified_subrequest" name="Promisified Subrequest">
+
+<para>
+The example works since
+<link doc="changes.xml" id="njs0.3.8">0.3.8</link>.
+<path>nginx.conf</path>:
+<example>
+js_include promisified_subrequest.js;
+
+location /start {
+    js_content content;
+}
+
+location /auth {
+    proxy_pass http://auth_backend;
+}
+
+location /backend {
+    proxy_pass http://backend;
+}
+</example>
+</para>
+
+<para>
+<path>promisified_subrequest.js</path>:
+<example>
+function content(r) {
+   r.subrequest(r, '/auth')
+   .then(reply => JSON.parse(reply.responseBody))
+   .then(response => {
+       if (!response['token']) {
+           throw new Error("token is not available");
+       }
+       return token;
+   })
+  .then(token => {
+      r.subrequest('/backend', `token=${token}`)
+      .then(reply => r.return(reply.status, reply.responseBody));
+  })
+  .catch(_ => r.return(500));
+}
+</example>
+</para>
+
+</section>
+
 </article>
diff --git a/xml/ru/docs/njs/examples.xml b/xml/ru/docs/njs/examples.xml
--- a/xml/ru/docs/njs/examples.xml
+++ b/xml/ru/docs/njs/examples.xml
@@ -9,7 +9,7 @@
 <article name="Примеры использования"
         link="/ru/docs/njs/examples.html"
         lang="ru"
-        rev="7">
+        rev="8">
 
 <section id="helloword" name="Hello World">
 
@@ -353,4 +353,51 @@ function num_requests(r)
 
 </section>
 
+
+<section id="promisified_subrequest" name="Подзапрос с promise">
+
+<para>
+Пример работает начиная с версии
+<link doc="changes.xml" id="njs0.3.8">0.3.8</link>.
+<path>nginx.conf</path>:
+<example>
+js_include promisified_subrequest.js;
+
+location /start {
+    js_content content;
+}
+
+location /auth {
+    proxy_pass http://auth_backend;
+}
+
+location /backend {
+    proxy_pass http://backend;
+}
+</example>
+</para>
+
+<para>
+<path>promisified_subrequest.js</path>:
+<example>
+function content(r) {
+   r.subrequest(r, '/auth')
+   .then(reply => JSON.parse(reply.responseBody))
+   .then(response => {
+       if (!response['token']) {
+           throw new Error("token is not available");
+       }
+       return token;
+   })
+  .then(token => {
+      r.subrequest('/backend', `token=${token}`)
+      .then(reply => r.return(reply.status, reply.responseBody));
+  })
+  .catch(_ => r.return(500));
+}
+</example>
+</para>
+
+</section>
+
 </article>