Mercurial > hg > nginx-site
diff xml/ru/docs/njs/reference.xml @ 2604:a29676472a11
Added Buffer object info to some njs methods.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Wed, 30 Sep 2020 22:12:05 +0100 |
parents | 90b32c2c0155 |
children | 0ec1e1b063d7 |
line wrap: on
line diff
--- a/xml/ru/docs/njs/reference.xml Tue Sep 29 20:02:36 2020 +0300 +++ b/xml/ru/docs/njs/reference.xml Wed Sep 30 22:12:05 2020 +0100 @@ -9,7 +9,7 @@ <article name="Справочник" link="/ru/docs/njs/reference.html" lang="ru" - rev="54"> + rev="55"> <section id="summary"> @@ -925,7 +925,12 @@ <literal>hex</literal>, <literal>base64</literal> и <literal>base64url</literal>. -Если кодировка не указана, то будет возвращена байтовая строка. +Если кодировка не указана, то будет возвращен объект буфера +(<link doc="changes.xml" id="njs0.4.4">0.4.4</link>). +<note> +До версии <link doc="changes.xml" id="njs0.4.4">0.4.4</link> +вместо объекта буфера возвращалась байтовая строка. +</note> </tag-desc> </list> @@ -1035,6 +1040,8 @@ <tag-desc> Синхронно добавляет указанные <literal>данные</literal> в файл с указанным <literal>именем</literal>. +<literal>Данными</literal> могут быть строка +или объект буфера (<link doc="changes.xml" id="njs0.4.4">0.4.4</link>. Если файл не существует, то он будет создан. Параметр <literal>options</literal> должен быть объектом со следующими ключами: @@ -1086,8 +1093,9 @@ <tag-name id="fs_readdirsync_encoding"><literal>кодировка</literal></tag-name> <tag-desc> -кодировка, по умолчанию не указана. -Кодировка может быть <literal>utf8</literal>. +кодировка, по умолчанию <literal>utf8</literal>. +Кодировка может быть <literal>utf8</literal> и <literal>буфер</literal> +(<link doc="changes.xml" id="njs0.4.4">0.4.4</link>). </tag-desc> <tag-name id="fs_readdirsync_withfiletypes"><literal>withFileTypes</literal></tag-name> @@ -1107,10 +1115,14 @@ с указанным <literal>именем</literal>. Параметр <literal>options</literal> хранит <literal>строку</literal>, которая задаёт кодировку. -Если кодировка не указана, -то будет возвращена <link id="string_tobytes">байтовая строка</link>. -Если указана кодировка <literal>utf8</literal>, -то будет возвращена строка Unicode. +Если кодировка указана, то будет возвращена строка, +иначе будет возвращён объект буфера +(<link doc="changes.xml" id="njs0.4.4">0.4.4</link>). +<note> +До версии <link doc="changes.xml" id="njs0.4.4">0.4.4</link> +возвращалась <link id="string_tobytes">байтовая строка</link> +в случае, если не была указана кодировка. +</note> Иначе ожидается, что <literal>options</literal> является объектом с ключами: <list type="tag"> @@ -1118,7 +1130,13 @@ <tag-name><literal>кодировка</literal></tag-name> <tag-desc> кодировка, по умолчанию не указана. -Кодировка может быть <literal>utf8</literal> +Кодировка может быть <literal>utf8</literal>, +<literal>hex</literal> +(<link doc="changes.xml" id="njs0.4.4">0.4.4</link>), +<literal>base64</literal> +(<link doc="changes.xml" id="njs0.4.4">0.4.4</link>), +<literal>base64url</literal> +(<link doc="changes.xml" id="njs0.4.4">0.4.4</link>). </tag-desc> <tag-name><literal>флаг</literal></tag-name> @@ -1133,7 +1151,7 @@ undefined >> var file = fs.readFileSync('/file/path.tar.gz') undefined ->> var gzipped = /^\x1f\x8b/.test(file); gzipped +>> var gzipped = file.slice(0,2).toString('hex') === '1f8b'; gzipped true </example> </tag-desc> @@ -1191,6 +1209,8 @@ <tag-desc> Синхронно записывает <literal>данные</literal> в файл с указанным <literal>именем</literal>. +<literal>Данными</literal> могут быть строка +или объект буфера (<link doc="changes.xml" id="njs0.4.4">0.4.4</link>. Если файл не существует, то он будет создан. Если файл существует, то он будет заменён. Параметр <literal>options</literal> должен быть