diff xml/ru/docs/njs/reference.xml @ 2569:2edc64c05b0e

Removed ECMAScript methods from njs Reference.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 14 Jul 2020 16:44:46 +0100
parents 6093e9f3615e
children 44792f1ee284
line wrap: on
line diff
--- a/xml/ru/docs/njs/reference.xml	Tue Jul 14 15:04:35 2020 +0300
+++ b/xml/ru/docs/njs/reference.xml	Tue Jul 14 16:44:46 2020 +0100
@@ -18,6 +18,17 @@
 для расширения функциональности nginx.
 </para>
 
+<para>
+Справочник содержит описания методов, свойств и модулей,
+доступных только в njs и не соответствующих стандарту ECMAScript.
+Описания методов и свойств njs,
+соответствующих стандарту, доступны в
+<link url="http://www.ecma-international.org/ecma-262/">спецификации
+ECMAScript</link>.
+Список всех методов и свойств njs доступен в разделе
+<link doc="compatibility.xml">Совместимость</link>.
+</para>
+
 </section>
 
 
@@ -591,7 +602,7 @@
 <tag-name id="string_bytesfrom"><literal>String.bytesFrom(<value>массив</value>
 | <value>строка</value>, <value>кодировка</value>)</literal></tag-name>
 <tag-desc>
-(только в njs) Создаёт байтовую строку или из массива, содержащего октеты,
+Создаёт байтовую строку или из массива, содержащего октеты,
 или из кодированной строки
 (<link doc="changes.xml" id="njs0.2.3">0.2.3</link>).
 Кодировкой может быть
@@ -607,299 +618,28 @@
 </example>
 </tag-desc>
 
-<tag-name id="string_fromcharcode"><literal>String.fromCharCode(<value>CharCode1</value>[, ...[,
-<value>CharCodeN</value>]])</literal></tag-name>
-<tag-desc>
-Возвращает строку из одной или более Unicode codepoints.
-<example>
->> String.fromCharCode(97, 98, 99, 100)
-'abcd'
-</example>
-</tag-desc>
-
-<tag-name id="string_fromcodepoint"><literal>String.fromCodePoint(<value>codePoint1</value>[, ...[,
-<value>codePoint2</value>]])</literal></tag-name>
-<tag-desc>
-Возвращает строку из одной или более Unicode codepoints.
-<example>
->> String.fromCodePoint(97, 98, 99, 100)
-'abcd'
-</example>
-</tag-desc>
-
-<tag-name id="string_charat"><literal>String.prototype.charAt(<value>индекс</value>)</literal></tag-name>
-<tag-desc>
-Возвращает строку, представляющую одну кодовую единицу Unicode
-внутри указанного <literal>индекса</literal>;
-пустая строка, если индекс вне диапазона значений.
-Индекс может быть числом
-между 0 и длиной строки минус 1.
-Если индекс не указан, то значение по умолчанию равно <literal>0</literal>,
-т.е. возвращается первый символ в строке.
-</tag-desc>
-
-<tag-name id="string_codepointat"><literal>String.prototype.CodePointAt(<value>позиция</value>)</literal></tag-name>
-<tag-desc>
-Возвращает число, представляющее codepoint-значение символа
-в пределах указанной <literal>позиции</literal>;
-<literal>undefined</literal>, если элемент в позиции отсутствует.
-<example>
->> 'ABCD'.codePointAt(3);
-68
-</example>
-</tag-desc>
-
-<tag-name id="string_concat"><literal>String.prototype.concat(<value>строка1</value>[, ...,
-<value>строкаN</value>])</literal></tag-name>
-<tag-desc>
-Возвращает строку, содержающую результат объединения указанных
-<literal>строк</literal>.
-<example>
->> "a".concat("b", "c")
-'abc'
-</example>
-</tag-desc>
-
-<tag-name id="string_endswith"><literal>String.prototype.endsWith(<value>ПоисковаяСтрока</value>[,
-<value>длина</value>])</literal></tag-name>
-<tag-desc>
-Возвращает <literal>true</literal>, если строка заканчивается символами
-указанной строки, иначе <literal>false</literal>.
-Необязательный параметр <literal>длина</literal> задаёт длину строки.
-Если <value>ПоисковаяСтрока</value> не указана,
-значением по умолчанию является длина строки.
-<example>
->> 'abc'.endsWith('abc')
-true
->> 'abca'.endsWith('abc')
-false
-</example>
-</tag-desc>
-
 <tag-name id="string_frombytes"><literal>String.prototype.fromBytes(<value>начало</value>[,
 <value>конец</value>])</literal></tag-name>
 <tag-desc>
-(только в njs) Возвращает новую строку Unicode из байтовой строки,
+Возвращает новую строку Unicode из байтовой строки,
 в которой каждый байт заменяется соответствующей Unicode codepoint.
 </tag-desc>
 
 <tag-name id="string_fromutf8"><literal>String.prototype.fromUTF8(<value>начало</value>[,
 <value>конец</value>])</literal></tag-name>
 <tag-desc>
-(только в njs) Преобразует байтовую строку, содержащую валидную строку UTF8,
+Преобразует байтовую строку, содержащую валидную строку UTF8,
 в строку Unicode,
 иначе возвращается <literal>null</literal>.
 </tag-desc>
 
-<tag-name id="string_includes"><literal>String.prototype.includes(<value>поисковаяСтрока</value>[,
-<value>позиция</value>]))</literal></tag-name>
-<tag-desc>
-Возвращает <literal>true</literal>, если строка ищется внутри другой строки,
-иначе <literal>false</literal>.
-Необязательный параметр <literal>позиция</literal> задаёт позицию
-внутри строки, от которой начинается поиск для <literal>поисковойСтроки</literal>. 
-Значение по умолчанию равно 0.
-<example>
->> 'abc'.includes('bc')
-true
-</example>
-</tag-desc>
-
-<tag-name id="string_indexof"><literal>String.prototype.indexOf(<value>поисковаяСтрока</value>[,
-<value>fromIndex</value>])</literal></tag-name>
-<tag-desc>
-Возвращает позицию первого появления
-<literal>поисковойСтроки</literal>.
-Поиск начинается с <literal>fromIndex</literal>.
-Возвращает <value>-1</value>, если значение не найдено.
-<literal>fromIndex</literal> является числом,
-значение по умолчанию равно 0.
-Если <literal>fromIndex</literal> меньше, чем 0
-или больше, чем
-<link id="string_length">String.prototype.length</link><value></value>,
-поиск начнётся на индексе <value>0</value> и
-<value>String.prototype.length</value>.
-<example>
->> 'abcdef'.indexOf('de', 2)
-3
-</example>
-</tag-desc>
-
-<tag-name id="string_lastindexof"><literal>String.prototype.lastIndexOf(<value>поисковаяСтрока</value>[,
-<value>fromIndex</value>])</literal></tag-name>
-<tag-desc>
-Возвращает позицию последнего появления
-of the <literal>поисковойСтроки</literal>,
-поиск осуществляется в обратном порядке от <literal>fromIndex</literal>.
-Возвращает <value>-1</value>, если значение не найдено.
-Если значение <literal>поисковойСтроки</literal> пустое,
-то возвращается <literal>fromIndex</literal>.
-<example>
->> "nginx".lastIndexOf("gi")
-1
-</example>
-</tag-desc>
-
-<tag-name id="string_length"><literal>String.prototype.length</literal></tag-name>
-<tag-desc>
-Возвращает длину строки.
-<example>
->> 'αβγδ'.length
-4
-</example>
-</tag-desc>
-
-<tag-name id="string_match"><literal>String.prototype.match([<value>регулярноеВыражение</value>])</literal></tag-name>
-<tag-desc>
-Возвращает совпадение при сопоставлении строки с
-регулярным выражением.
-<example>
->> 'nginx'.match( /ng/i )
-'ng'
-</example>
-</tag-desc>
-
-<tag-name id="string_padend"><literal>String.prototype.padEnd(<value>длина</value>
-[, <value>строка</value>])</literal></tag-name>
-<tag-desc>
-Возвращает строку указанной длины,
-добавляя строку в конец указанной
-строки (<link doc="changes.xml" id="njs0.2.3">0.2.3</link>).
-<example>
->> '1234'.padEnd(8, 'abcd')
-'1234abcd'
-</example>
-</tag-desc>
-
-<tag-name id="string_padstart"><literal>String.prototype.padStart(<value>длина</value>
-[, <value>строка</value>])</literal></tag-name>
-<tag-desc>
-Возвращает строку указанной длины,
-добавляя строку к началу указанной
-строки (<link doc="changes.xml" id="njs0.2.3">0.2.3</link>).
-<example>
->> '1234'.padStart(8, 'abcd')
-'abcd1234'
-</example>
-</tag-desc>
-
-<tag-name id="string_repeat"><literal>String.prototype.repeat(<value>число</value>)</literal></tag-name>
-<tag-desc>
-Возвращает строку
-с указанным числом копий строки.
-<example>
->> 'abc'.repeat(3)
-'abcabcabc'
-</example>
-</tag-desc>
-
-<tag-name id="string_replace"><literal>String.prototype.replace([<value>регулярноеВыражение</value>|<value>string</value>[,
-<value>string</value>|<value>function</value>]])</literal></tag-name>
-<tag-desc>
-Возвращает новую строку, которая сопоставляется со
-строкой или регулярным выражением,
-и заменяется на <literal>строку</literal> или <literal>функцию</literal>.
-<example>
->> 'abcdefgh'.replace('d', 1)
-'abc1efgh'
-</example>
-</tag-desc>
-
-<tag-name id="string_search"><literal>String.prototype.search([<value>регулярноеВыражение</value>])</literal></tag-name>
-<tag-desc>
-Осуществляет поиск строки при помощи регулярного выражения.
-<example>
->> 'abcdefgh'.search('def')
-3
-</example>
-</tag-desc>
-
-<tag-name id="string_slice"><literal>String.prototype.slice(<value>начало</value>[,
-<value>конец</value>])</literal></tag-name>
-<tag-desc>
-Возвращает новую строку, содержащую часть
-исходной строки между <literal>началом</literal>
-и <literal>концом</literal> или
-от <literal>начала</literal> до конца строки.
-<example>
->> 'abcdefghijklmno'.slice(NaN, 5)
-'abcde'
-</example>
-</tag-desc>
-
-<tag-name id="string_split"><literal>String.prototype.split(([<value>строка</value>|<value>регулярноеВыражение</value>[,
-<value>лимит</value>]]))</literal></tag-name>
-<tag-desc>
-Возвращает совпадение строки регулярному выражению.
-Необязательный параметр <literal>лимит</literal> является числом, задающим
-ограничение на количество найденных подстрок.
-<example>
->> 'abc'.split('')
-[
- 'a',
- 'b',
- 'c'
-]
-</example>
-</tag-desc>
-
-<tag-name id="string_startswith"><literal>String.prototype.startsWith(<value>поисковаяСтрока</value>[,
-<value>позиция</value>])</literal></tag-name>
-<tag-desc>
-Возвращает <literal>true</literal>, если строка начинается с символов
-указанной строки, иначе <literal>false</literal>.
-Необязательный параметр <literal>позиция</literal> является местом
-в этой строке, с которого начинается поиск <literal>поисковойСтоки</literal>.
-Значение по умолчанию равно 0.
-<example>
->> 'abc'.startsWith('abc')
-true
-> 'aabc'.startsWith('abc')
-false
-</example>
-</tag-desc>
-
-<tag-name id="string_substr"><literal>String.prototype.substr(<value>начало</value>[,
-<value>длина</value>])</literal></tag-name>
-<tag-desc>
-Возвращает часть строки указанной <literal>длины</literal>
-от <literal>начала</literal>
-или от <literal>начала</literal> до конца строки.
-<example>
->>  'abcdefghijklmno'.substr(3, 5)
-'defgh'
-</example>
-</tag-desc>
-
-<tag-name id="string_substring"><literal>String.prototype.substring(<value>начало</value>[,
-<value>конец</value>])</literal></tag-name>
-<tag-desc>
-Возвращает часть строки между
-<literal>началом</literal> и <literal>концом</literal> или
-от от <literal>начала</literal> до конца строки.
-<example>
->> 'abcdefghijklmno'.substring(3, 5)
-'de'
-</example>
-</tag-desc>
-
 <tag-name id="string_tobytes"><literal>String.prototype.toBytes(начало[,
 конец])</literal></tag-name>
 <tag-desc>
-(только в njs) Сериализует строку Unicode в байтовую строку.
+Сериализует строку Unicode в байтовую строку.
 Возвращает <literal>null</literal>, если в строке найден символ больше, чем 255.
 </tag-desc>
 
-<tag-name id="string_tolowercase"><literal>String.prototype.toLowerCase()</literal></tag-name>
-<tag-desc>
-Преобразует строку в нижний регистр.
-Метод поддерживает только простое свёртывание Unicode.
-<example>
->> 'ΑΒΓΔ'.toLowerCase()
-'αβγδ'
-</example>
-</tag-desc>
-
 <tag-name><literal>String.prototype.toString([<value>кодировка</value>])</literal></tag-name>
 <tag-desc>
 <para>
@@ -908,7 +648,7 @@
 </para>
 
 <para>
-(только в njs) Если кодировка указана,
+Если кодировка указана,
 кодирует <link id="string_tobytes">байтовую строку</link> в
 <literal>hex</literal>,
 <literal>base64</literal> или
@@ -920,20 +660,10 @@
 </example>
 </tag-desc>
 
-<tag-name id="string_touppercase"><literal>String.prototype.toUpperCase()</literal></tag-name>
-<tag-desc>
-Преобразует строку в верхний регистр.
-Метод поддерживает только простое свёртывание Unicode.
-<example>
->> 'αβγδ'.toUpperCase()
-'ΑΒΓΔ'
-</example>
-</tag-desc>
-
 <tag-name id="string_toutf8"><literal>String.prototype.toUTF8(<value>начало</value>[,
 <value>конец</value>])</literal></tag-name>
 <tag-desc>
-(только в njs) Сериализует строку Unicode
+Сериализует строку Unicode
 в байтовую строку при помощи кодирования UTF8.
 <example>
 >> 'αβγδ'.toUTF8().length
@@ -943,75 +673,6 @@
 </example>
 </tag-desc>
 
-<tag-name id="string_trim"><literal>String.prototype.trim()</literal></tag-name>
-<tag-desc>
-Удаляет пробелы в начале и конце строки.
-<example>
->> '   abc  '.trim()
-'abc'
-</example>
-</tag-desc>
-
-<tag-name id="string_trimend"><literal>String.prototype.trimEnd()</literal></tag-name>
-<tag-desc>
-Удаляет пробелы в конце строки.
-(<link doc="changes.xml" id="njs0.3.4">0.3.4</link>).
-<example>
->> '   abc  '.trimEnd()
-'   abc'
-</example>
-</tag-desc>
-
-<tag-name id="string_trimstart"><literal>String.prototype.trimStart()</literal></tag-name>
-<tag-desc>
-Удаляет пробелы в начале строки.
-(<link doc="changes.xml" id="njs0.3.4">0.3.4</link>).
-<example>
->> '   abc  '.trimStart()
-'abc  '
-</example>
-</tag-desc>
-
-<tag-name id="encodeuri"><literal>encodeURI(<value>URI</value>)</literal></tag-name>
-<tag-desc>
-Кодирует URI путём замены определённых символов
-на одну, две, три или четыре последовательности,
-представляющие UTF-8 кодировку символа.
-<example>
->> encodeURI('012αβγδ')
-'012%CE%B1%CE%B2%CE%B3%CE%B4'
-</example>
-</tag-desc>
-
-<tag-name id="encodeuricomponent"><literal>encodeURIComponent(<value>encodedURIString</value>)</literal></tag-name>
-<tag-desc>
-Кодирует URI путём замены определённых символов
-на одну, две, три или четыре последовательности,
-представляющие UTF-8 кодировку символа.
-<example>
->> encodeURIComponent('[@?=')
-'%5B%40%3F%3D'
-</example>
-</tag-desc>
-
-<tag-name id="decodeuri"><literal>decodeURI(<value>encodedURI</value>)</literal></tag-name>
-<tag-desc>
-Декодирует ранее <link id="encodeuri">кодированный</link> URI.
-<example>
->> decodeURI('012%CE%B1%CE%B2%CE%B3%CE%B4')
-'012αβγδ'
-</example>
-</tag-desc>
-
-<tag-name id="decodeuricomponent"><literal>decodeURIComponent(<value>decodedURIString</value>)</literal></tag-name>
-<tag-desc>
-Декодирует ранее <link id="encodeuri">кодированный</link> URI.
-<example>
->> decodeURIComponent('%5B%40%3F%3D')
-'[@?='
-</example>
-</tag-desc>
-
 </list>
 </para>