Mercurial > hg > nginx-site
changeset 2884:ccd42f2b99fb
Deprecated several methods in njs reference.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 23 Aug 2022 14:51:52 +0100 |
parents | 4959250ba429 |
children | 38f5cf5d3d41 |
files | xml/en/docs/njs/reference.xml |
diffstat | 1 files changed, 29 insertions(+), 10 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/njs/reference.xml Tue Aug 23 14:51:40 2022 +0100 +++ b/xml/en/docs/njs/reference.xml Tue Aug 23 14:51:52 2022 +0100 @@ -9,7 +9,7 @@ <article name="Reference" link="/en/docs/njs/reference.html" lang="en" - rev="86"> + rev="87"> <section id="summary"> @@ -2399,30 +2399,44 @@ <tag-name id="string_frombytes"><literal>String.prototype.fromBytes(<value>start</value>[, <value>end</value>])</literal></tag-name> <tag-desc> -Returns a new Unicode string from a byte string -where each byte is replaced with a corresponding Unicode code point. +the property is deprecated since +<link doc="changes.xml" id="njs0.7.7">0.7.7</link>. +Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>, +returned a new Unicode string from a byte string +where each byte was replaced with a corresponding Unicode code point. </tag-desc> <tag-name id="string_fromutf8"><literal>String.prototype.fromUTF8(<value>start</value>[, <value>end</value>])</literal></tag-name> <tag-desc> -Converts a byte string containing a valid UTF-8 string +the property is deprecated since +<link doc="changes.xml" id="njs0.7.7">0.7.7</link>, +the <link id="textedeoder"><literal>TextDecoder</literal></link> method +should be used instead. +Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>, +converted a byte string containing a valid UTF-8 string into a Unicode string, -otherwise <literal>null</literal> is returned. +otherwise <literal>null</literal> was returned. </tag-desc> <tag-name id="string_tobytes"><literal>String.prototype.toBytes(<value>start</value>[, <value>end</value>])</literal></tag-name> <tag-desc> -Serializes a Unicode string to a byte string. -Returns <literal>null</literal> if a character larger than 255 is +the property is deprecated since +<link doc="changes.xml" id="njs0.7.7">0.7.7</link>. +Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>, +serialized a Unicode string to a byte string, +returned <literal>null</literal> if a character larger than 255 was found in the string. </tag-desc> <tag-name id="string_tostring"><literal>String.prototype.toString(<value>encoding</value>)</literal></tag-name> <tag-desc> <para> -Encodes a string to +the property is deprecated since +<link doc="changes.xml" id="njs0.7.7">0.7.7</link>. +Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>, +encoded a string to <literal>hex</literal>, <literal>base64</literal>, or <literal>base64url</literal>: @@ -2442,8 +2456,13 @@ <tag-name id="string_toutf8"><literal>String.prototype.toUTF8(<value>start</value>[, <value>end</value>])</literal></tag-name> <tag-desc> -Serializes a Unicode string -to a byte string using UTF-8 encoding. +the property is deprecated since +<link doc="changes.xml" id="njs0.7.7">0.7.7</link>, +the <link id="textencoder"><literal>TextEncoder</literal></link> method +should be used instead. +Before <link doc="changes.xml" id="njs0.7.7">0.7.7</link>, +serialized a Unicode string +to a byte string using UTF-8 encoding: <example> >> 'αβγδ'.toUTF8().length 8