Mercurial > hg > nginx-site
changeset 3015:3a85326ed38c
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>,