Mercurial > hg > nginx-site

changeset 3015:3a85326ed38c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented Console object in njs Reference.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 03 Oct 2023 09:31:29 +0100
parents c0a4a4a55e45
children 8e7eced98610
files xml/en/docs/njs/changes.xml xml/en/docs/njs/compatibility.xml xml/en/docs/njs/reference.xml xml/ru/docs/njs/compatibility.xml
diffstat 4 files changed, 96 insertions(+), 6 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/njs/changes.xml
+++ b/xml/en/docs/njs/changes.xml
@@ -9,7 +9,7 @@
 <article name="Changes"
         link="/en/docs/njs/changes.html"
         lang="en"
-        rev="64"
+        rev="65"
         toc="no">
 
 <section id="njs0.8.1" name="Changes with njs 0.8.1">
@@ -5087,8 +5087,10 @@ making global object mutable.
 <listitem>
 <para>
 Feature:
-<literal>console.time()</literal> and
-<literal>console.timeEnd()</literal> methods.
+<link doc="reference.xml" id="console_time"><literal>console.time()</literal></link>
+and
+<link doc="reference.xml" id="console_time_end"><literal>console.timeEnd()</literal></link>
+methods.
 </para>
 </listitem>
 
--- a/xml/en/docs/njs/compatibility.xml
+++ b/xml/en/docs/njs/compatibility.xml
@@ -9,7 +9,7 @@
 <article name="Compatibility"
         link="/en/docs/njs/compatibility.html"
         lang="en"
-        rev="42"
+        rev="43"
         toc="no">
 
 <section>
@@ -981,6 +981,17 @@ Global objects
 <list type="bullet">
 
 <listitem>
+<link doc="reference.xml" id="console"><literal>console</literal></link>
+(<link doc="changes.xml" id="njs0.8.2">0.8.2</link>):
+<link doc="reference.xml" id="console_error"><literal>error</literal></link>,
+<link doc="reference.xml" id="console_info"><literal>info</literal></link>,
+<link doc="reference.xml" id="console_log"><literal>log</literal></link>,
+<link doc="reference.xml" id="console_time"><literal>time</literal></link>,
+<link doc="reference.xml" id="console_time_end"><literal>timeEnd</literal></link>,
+<link doc="reference.xml" id="console_warn"><literal>warn</literal></link>
+</listitem>
+
+<listitem>
 <link doc="reference.xml" id="builtin_crypto"><literal>crypto</literal></link>
 (<link doc="changes.xml" id="njs0.7.0">0.7.0</link>):
 <link doc="reference.xml" id="crypto_get_random_values"><literal>getRandomValues</literal></link>,
--- a/xml/en/docs/njs/reference.xml
+++ b/xml/en/docs/njs/reference.xml
@@ -9,7 +9,7 @@
 <article name="Reference"
         link="/en/docs/njs/reference.html"
         lang="en"
-        rev="117">
+        rev="118">
 
 <section id="summary">
 
@@ -1840,6 +1840,72 @@ or
 <section id="builtin_objects" name="built-in objects">
 
 
+<section id="console" name="console">
+
+<para>
+<table width="100%">
+<tr><td><link id="console_error"><literal>console.error()</literal></link></td></tr>
+<tr><td><link id="console_info"><literal>console.info()</literal></link></td></tr>
+<tr><td><link id="console_log"><literal>console.log()</literal></link></td></tr>
+<tr><td><link id="console_time"><literal>console.time()</literal></link></td></tr>
+<tr><td><link id="console_time_end"><literal>console.timeEnd()</literal></link></td></tr>
+<tr><td><link id="console_warn"><literal>console.warn()</literal></link></td></tr>
+</table>
+</para>
+
+<para>
+The <literal>console</literal> object is available
+in nginx since <link doc="changes.xml" id="njs0.8.2">0.8.2</link>,
+in CLI since <link doc="changes.xml" id="njs0.2.6">0.2.6</link>.
+<list type="tag">
+
+<tag-name id="console_error"><literal>console.error(<value>msg</value>[, <value>msg2</value> ...])</literal></tag-name>
+<tag-desc>
+Outputs one or more error messages.
+The message may be a string or an object.
+</tag-desc>
+
+<tag-name id="console_info"><literal>console.info(<value>msg</value>[, <value>msg2</value> ...])</literal></tag-name>
+<tag-desc>
+Outputs one or more info messages.
+The message may be a string or an object.
+</tag-desc>
+
+<tag-name id="console_log"><literal>console.log(<value>msg</value>[, <value>msg2</value> ...])</literal></tag-name>
+<tag-desc>
+Outputs one or more log messages.
+The message may be a string or an object.
+</tag-desc>
+
+<tag-name id="console_time"><literal>console.time(<value>label</value>)</literal></tag-name>
+<tag-desc>
+Starts a timer that can track how long an operation takes.
+The <literal>label</literal> parameter allows naming different timers.
+If <link id="console_time_end"><literal>console.timeEnd()</literal></link>
+with the same name is called,
+the time that elapsed since the timer was started will be output,
+in milliseconds.
+</tag-desc>
+
+<tag-name id="console_time_end"><literal>console.timeEnd(<value>label</value>)</literal></tag-name>
+<tag-desc>
+Stops a timer previously started by
+<link id="console_time"><literal>console.time()</literal></link>
+The <literal>label</literal> parameter allows naming different timers.
+</tag-desc>
+
+<tag-name id="console_warn"><literal>console.warn(<value>msg</value>[, <value>msg2</value> ...])</literal></tag-name>
+<tag-desc>
+Outputs one or more warning messages.
+The message may be a string or an object.
+</tag-desc>
+
+</list>
+</para>
+
+</section>
+
+
 <section id="builtin_crypto" name="crypto">
 
 <para>
--- a/xml/ru/docs/njs/compatibility.xml
+++ b/xml/ru/docs/njs/compatibility.xml
@@ -9,7 +9,7 @@
 <article name="Совместимость"
         link="/ru/docs/njs/compatibility.html"
         lang="ru"
-        rev="42"
+        rev="43"
         toc="no">
 
 <section>
@@ -981,6 +981,17 @@ ES6 поддержка стрелочных функций
 <list type="bullet">
 
 <listitem>
+<link doc="reference.xml" id="console"><literal>console</literal></link>
+(<link doc="changes.xml" id="njs0.8.2">0.8.2</link>):
+<link doc="reference.xml" id="console_error"><literal>error</literal></link>,
+<link doc="reference.xml" id="console_info"><literal>info</literal></link>,
+<link doc="reference.xml" id="console_log"><literal>log</literal></link>,
+<link doc="reference.xml" id="console_time"><literal>time</literal></link>,
+<link doc="reference.xml" id="console_time_end"><literal>timeEnd</literal></link>,
+<link doc="reference.xml" id="console_warn"><literal>warn</literal></link>
+</listitem>
+
+<listitem>
 <link doc="reference.xml" id="builtin_crypto"><literal>crypto</literal></link>
 (<link doc="changes.xml" id="njs0.7.0">0.7.0</link>):
 <link doc="reference.xml" id="crypto_get_random_values"><literal>getRandomValues</literal></link>,