annotate xml/ru/docs/njs/reference.xml @ 2340:537130c40c1f

Updated r.subrequest desctiption in njs.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 27 Feb 2019 20:25:42 +0300
parents 39ac205f90b7
children ea8ccaac18b4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
2
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
3 <!--
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
4 Copyright (C) Nginx, Inc.
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
5 -->
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
6
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
7 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
8
2246
32ba43abf9cd Renamed njs API, njs Changes.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2244
diff changeset
9 <article name="Справочник"
32ba43abf9cd Renamed njs API, njs Changes.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2244
diff changeset
10 link="/ru/docs/njs/reference.html"
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
11 lang="ru"
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
12 rev="1">
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
13
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
14 <section id="summary">
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
15
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
16 <para>
2244
467aef18bf12 Renamed the "About njs" page.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2189
diff changeset
17 <link doc="index.xml">njs</link> предоставляет объекты, методы и свойства
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
18 для расширения функциональности nginx.
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
19 </para>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
20
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
21 </section>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
22
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
23
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
24 <section id="http_stream" name="Объекты nginx">
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
25
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
26
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
27 <section id="http" name="HTTP-запрос">
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
28
2189
23cfb62121d1 Mentioned byte strings for njs HTTP and stream objects.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2182
diff changeset
29 <para>
23cfb62121d1 Mentioned byte strings for njs HTTP and stream objects.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2182
diff changeset
30 Объект <literal>HTTP</literal> доступен только в
23cfb62121d1 Mentioned byte strings for njs HTTP and stream objects.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2182
diff changeset
31 модуле <link doc="../http/ngx_http_js_module.xml">ngx_http_js_module</link>.
23cfb62121d1 Mentioned byte strings for njs HTTP and stream objects.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2182
diff changeset
32 Все строки в объекте <literal>HTTP</literal> являются
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
33 <link id="string">байтовыми строками</link>.
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
34
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
35 <list type="tag">
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
36
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
37 <tag-name><literal>r.args{}</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
38 <tag-desc>
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
39 объект аргументов запроса, только чтение
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
40 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
41
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
42 <tag-name><literal>r.error(<value>строка</value>)</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
43 <tag-desc>
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
44 записывает <literal>строку</literal> в лог-файл ошибок
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
45 на уровне лога <literal>error</literal>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
46 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
47
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
48 <tag-name><literal>r.finish()</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
49 <tag-desc>
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
50 завершает отправку ответа клиенту
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
51 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
52
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
53 <tag-name><literal>r.headersIn{}</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
54 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
55 объект входящих заголовков, только чтение.
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
56 <para>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
57 Например, доступ к заголовку <literal>Foo</literal>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
58 можно получить при помощи синтаксиса <literal>headersIn.foo</literal>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
59 или <literal>headersIn['Foo']</literal>
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
60 </para>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
61 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
62
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
63 <tag-name><literal>r.headersOut{}</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
64 <tag-desc>
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
65 объект исходящих заголовков, доступно для записи.
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
66 <para>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
67 Например, доступ к заголовку <literal>Foo</literal>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
68 можно получить при помощи синтаксиса <literal>headersOut.foo</literal>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
69 или <literal>headersOut['Foo']</literal>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
70 </para>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
71 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
72
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
73 <tag-name><literal>r.httpVersion</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
74 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
75 версия HTTP, только чтение
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
76 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
77
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
78 <tag-name><literal>r.log(<value>строка</value>)</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
79 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
80 записывает <literal>строку</literal> в лог-файл ошибок
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
81 на уровне лога <literal>info</literal>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
82 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
83
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
84 <tag-name id="r_internal_redirect"><literal>r.internalRedirect(<value>uri</value>)</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
85 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
86 осуществляет внутреннее перенаправление на указанный <literal>uri</literal>.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
87 Если uri начинается с префикса “<literal>@</literal>”,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
88 то он считается именованным location.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
89 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
90
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
91 <tag-name><literal>r.method</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
92 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
93 HTTP метод, только чтение
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
94 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
95
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
96 <tag-name><literal>r.parent</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
97 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
98 ссылается на родительский объект запроса
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
99 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
100
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
101 <tag-name><literal>r.remoteAddress</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
102 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
103 адрес клиента, только чтение
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
104 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
105
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
106 <tag-name id="r_request_body"><literal>r.requestBody</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
107 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
108 возвращает тело запроса клиента, если оно не было
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
109 записано во временный файл.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
110 Чтобы убедиться, что тело запроса клиента находится в памяти,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
111 его размер должен быть ограничен
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
112 <link doc="../http/ngx_http_core_module.xml" id="client_max_body_size"/>,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
113 и также необходимо установить достаточный размер буфера при помощи
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
114 <link doc="../http/ngx_http_core_module.xml" id="client_body_buffer_size"/>.
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
115 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
116
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
117 <tag-name><literal>r.responseBody</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
118 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
119 хранит тело ответа <link id="subrequest">подзапроса</link>, только чтение.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
120 Размер <literal>r.responseBody</literal> ограничивается директивой
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
121 <link doc="../http/ngx_http_core_module.xml" id="subrequest_output_buffer_size"/>.
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
122 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
123
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
124 <tag-name><literal>r.return(код[, строка])</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
125 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
126 отправляет
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
127 клиенту полный ответ с указанным <literal>кодом</literal>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
128 <para>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
129 Можно задать или URL перенаправления
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
130 (для кодов 301, 302, 303, 307 и 308),
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
131 или текст тела ответа (для остальных кодов) в качестве второго аргумента
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
132 </para>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
133 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
134
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
135 <tag-name><literal>r.send(<value>строка</value>)</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
136 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
137 отправляет часть тела ответа клиенту
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
138 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
139
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
140 <tag-name><literal>r.sendHeader()</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
141 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
142 отправляет заголовки HTTP клиенту
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
143 </tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
144
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
145 <tag-name><literal>r.status</literal></tag-name>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
146 <tag-desc>
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
147 статус, доступно для записи
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
148 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
149
2338
39ac205f90b7 Documented that r.variables{} and s.variables{} are writable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2337
diff changeset
150 <tag-name id="r_variables"><literal>r.variables{}</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
151 <tag-desc>
2338
39ac205f90b7 Documented that r.variables{} and s.variables{} are writable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2337
diff changeset
152 объект переменных nginx, доступно для записи
39ac205f90b7 Documented that r.variables{} and s.variables{} are writable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2337
diff changeset
153 (начиная с версии <link doc="changes.xml" id="njs0.2.8">0.2.8</link>)
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
154 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
155
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
156 <tag-name><literal>r.warn(<value>строка</value>)</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
157 <tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
158 записывает <literal>строку</literal> в лог-файл ошибок
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
159 на уровне лога <literal>warning</literal>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
160 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
161
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
162 <tag-name><literal>r.uri</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
163 <tag-desc>
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
164 текущий URI, только чтение
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
165 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
166
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
167 <tag-name id="subrequest"><literal>r.subrequest(<value>uri</value>[,
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
168 <value>options</value>[, <value>callback</value>]])</literal></tag-name>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
169 <tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
170 создаёт подзапрос с заданными <literal>uri</literal> и
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
171 <literal>options</literal> и устанавливает
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
172 необязательный <literal>callback</literal> завершения.
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
173
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
174 <para>
2340
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
175 <link doc="../dev/development_guide.xml.xml" id="http_subrequests">Подзапрос</link>
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
176 использует входящиe заголовки клиентского запроса.
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
177 Для отправки на проксируемый сервер заголовков, отличных от оригинальных,
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
178 может использоваться директива
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
179 <link doc="../http/ngx_http_proxy_module.xml" id="proxy_set_header"/>.
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
180 Для отправки на проксируемый сервер нового набора заголовков
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
181 может использоваться директива
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
182 <link doc="../http/ngx_http_proxy_module.xml" id="proxy_pass_request_headers"/>.
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
183 </para>
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
184
537130c40c1f Updated r.subrequest desctiption in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2338
diff changeset
185 <para>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
186 Если <literal>options</literal> является строкой, то в ней
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
187 содержится срока аргументов подзапроса.
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
188 В противном случае ожидается, что <literal>options</literal> является
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
189 объектом со следующими ключами:
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
190 <list type="tag">
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
191 <tag-name><literal>args</literal></tag-name>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
192 <tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
193 строка с аргументами
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
194 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
195 <tag-name><literal>body</literal></tag-name>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
196 <tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
197 тело запроса
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
198 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
199
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
200 <tag-name><literal>method</literal></tag-name>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
201 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
202 метод HTTP
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
203 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
204
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
205 </list>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
206 </para>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
207
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
208 <para>
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
209 <literal>callback</literal> получает
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
210 объект ответа подзапроса с методами и свойствами,
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
211 идентичными родительскому объекту запроса.
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
212 </para>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
213 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
214
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
215 </list>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
216 </para>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
217
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
218 </section>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
219
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
220
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
221 <section id="stream" name="Stream-сессия">
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
222
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
223 <para>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
224 Объект stream-сессии доступен только в
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
225 модуле
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
226 <link doc="../stream/ngx_stream_js_module.xml">ngx_stream_js_module</link>.
2189
23cfb62121d1 Mentioned byte strings for njs HTTP and stream objects.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2182
diff changeset
227 Все строки в объекте <literal>stream</literal> являются
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
228 <link id="string">байтовыми строками</link>.
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
229 </para>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
230
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
231 <para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
232 <note>
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
233 До версии njs <link doc="changes.xml" id="njs0.2.4">0.2.4</link>,
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
234 у объекта stream-сессии были некоторые свойства, которые на данный момент
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
235 <link id="stream_obsolete">удалены</link>.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
236 </note>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
237 </para>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
238
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
239 <para>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
240 <list type="tag">
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
241
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
242 <tag-name id="s_allow"><literal>s.allow()</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
243 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
244 успешно финализирует обработчик фазы
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
245 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>)
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
246 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
247
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
248 <tag-name id="s_decline"><literal>s.decline()</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
249 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
250 финализирует обработчик фазы и передаёт контроль следующему обработчику
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
251 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>)
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
252 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
253
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
254 <tag-name id="s_deny"><literal>s.deny()</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
255 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
256 финализирует обработчик фазы с кодом ошибки доступа
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
257 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>)
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
258 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
259
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
260 <tag-name id="s_done"><literal>s.done</literal>(<value>[код]</value>)</tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
261 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
262 успешно финализирует текущий обработчик фазы
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
263 или финализирует его с указанным числовым кодом
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
264 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>).
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
265 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
266
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
267 <tag-name><literal>s.error(<value>строка</value>)</literal></tag-name>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
268 <tag-desc>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
269 записывает отправленную <literal>строку</literal> в лог-файл ошибок
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
270 на уровне лога <literal>error</literal>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
271 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
272
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
273 <tag-name><literal>s.log(<value>строка</value>)</literal></tag-name>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
274 <tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
275 записывает отправленную <value>строку</value> в лог-файл ошибок
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
276 на уровне лога <literal>info</literal>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
277 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
278
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
279 <tag-name id="s_off"><literal>s.off(<value>имяСобытия</value>)</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
280 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
281 отменяет регистрацию callback'а, установленного методом
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
282 <link id="s_on">s.on()</link>
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
283 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>)
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
284 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
285
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
286 <tag-name id="s_on"><literal>s.on(<value>событие</value>,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
287 <value>callback</value>)</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
288 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
289 регистрирует <literal>callback</literal> для указанного <literal>события</literal>
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
290 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>).
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
291
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
292 <para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
293 <literal>Событием</literal> может являться одна из следующих строк:
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
294 <list type="tag">
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
295 <tag-name><literal>upload</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
296 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
297 новые данные от клиента
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
298 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
299
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
300 <tag-name><literal>download</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
301 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
302 новые данные к клиенту
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
303 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
304
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
305 </list>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
306 </para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
307
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
308 <para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
309 Callback завершения имеет следующий прототип:
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
310 <literal>callback(данные, флаги)</literal>, где
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
311 <literal>данные</literal> являются строкой,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
312 <literal>флаги</literal> являются объектом
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
313 со следующими свойствами:
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
314 <list type="tag">
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
315 <tag-name id="s_on_callback_last"><literal>last</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
316 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
317 логическое свойство,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
318 true, если данные являются последним буфером.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
319 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
320
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
321 </list>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
322 </para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
323 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
324
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
325 <tag-name><literal>s.remoteAddress</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
326 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
327 адрес клиента, только чтение
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
328 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
329
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
330 <tag-name id="s_send"><literal>s.send(<value>данные</value>[,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
331 <value>параметры</value>])</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
332 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
333 отправляет данные клиенту
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
334 (<link doc="changes.xml" id="njs0.2.4">0.2.4</link>).
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
335 <literal>Параметры</literal> являются объектом, используемым
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
336 для переопределения флагов буфера nginx,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
337 полученных из буфера входных данных.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
338 Флаги могут быть переопределены при помощи следующих флагов:
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
339 <para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
340 <list type="tag">
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
341
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
342 <tag-name><literal>last</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
343 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
344 логическое свойство,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
345 true, если буфер является последним буфером
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
346 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
347
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
348 <tag-name><literal>flush</literal></tag-name>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
349 <tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
350 логическое свойство,
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
351 true, если буфер должен иметь флаг <literal>flush</literal>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
352 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
353 </list>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
354 </para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
355 Метод может быть вызван несколько раз в течение одного вызова callback'a.
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
356 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
357
2338
39ac205f90b7 Documented that r.variables{} and s.variables{} are writable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2337
diff changeset
358 <tag-name id="s_variables"><literal>s.variables{}</literal></tag-name>
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
359 <tag-desc>
2338
39ac205f90b7 Documented that r.variables{} and s.variables{} are writable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2337
diff changeset
360 объект переменных nginx, доступно для записи
39ac205f90b7 Documented that r.variables{} and s.variables{} are writable.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2337
diff changeset
361 (начиная с версии <link doc="changes.xml" id="njs0.2.8">0.2.8</link>)
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
362 </tag-desc>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
363
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
364 <tag-name><literal>s.warn(<value>строка</value>)</literal></tag-name>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
365 <tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
366 записывает отправленную <literal>строку</literal> в лог-файл ошибок
2182
7865ca0da0ab Merged HTTP request,response, and reply in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2175
diff changeset
367 на уровне лога <literal>warning</literal>
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
368 </tag-desc>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
369
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
370 </list>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
371 </para>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
372
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
373 </section>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
374
2295
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
375 </section>
a1d0238ffb61 Updated HTTP and stream objects in Russian njs reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2290
diff changeset
376
2316
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
377
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
378 <section id="core" name="Core">
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
379
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
380
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
381 <section id="string" name="Строка">
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
382
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
383 <para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
384 В njs существует два типа строк: строка Unicode (по умолчанию) и
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
385 байтовая строка.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
386 </para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
387
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
388 <para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
389 Строка Unicode соответствует строке ECMAScript,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
390 содержащей символы Unicode.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
391 </para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
392
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
393 <para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
394 Байтовые строки содержат последовательность байт и
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
395 используются для сериализации строк Unicode
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
396 во внешние данные и десериализации из внешних источников.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
397 Например метод <link id="string_toutf8">toUTF8()</link> сериализует
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
398 строку Unicode в байтовую строку используя кодировку UTF8:
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
399 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
400 >> '£'.toUTF8().toString('hex')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
401 'c2a3' /* C2 A3 является UTF8-представлением codepoint 00A3 ('£') */
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
402 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
403 Метод <link id="string_tobytes">toBytes()</link> сериализует
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
404 строку Unicode с codepoints до 255 в байтовую строку,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
405 в противном случае возвращается <literal>null</literal>:
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
406 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
407 >> '£'.toBytes().toString('hex')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
408 'a3' /* a3 является байтом, равным codepoint 00A3 ('£') */
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
409 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
410 В различные кодировки могут быть преобразованы только байтовые строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
411 Например строка не может быть кодирована напрямую в <literal>hex</literal>:
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
412 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
413 >> 'αβγδ'.toString('base64')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
414 TypeError: argument must be a byte string
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
415 at String.prototype.toString (native)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
416 at main (native)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
417 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
418 Чтобы преобразовать строку Unicode в hex,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
419 сначала необходимо её преобразовать в байтовую строку и затем в hex:
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
420 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
421 >> 'αβγδ'.toUTF8().toString('base64')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
422 'zrHOss6zzrQ='
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
423 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
424
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
425 <list type="tag">
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
426
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
427 <tag-name id="string_bytesfrom"><literal>String.bytesFrom(<value>массив</value>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
428 | <value>строка</value>, <value>кодировка</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
429 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
430 (только в njs) Создаёт байтовую строку или из массива, содержащего октеты,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
431 или из кодированной строки
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
432 (<link doc="changes.xml" id="njs0.2.3">0.2.3</link>).
2316
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
433 Кодировкой может быть
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
434 <literal>hex</literal>,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
435 <literal>base64</literal> и
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
436 <literal>base64url</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
437 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
438 >> String.bytesFrom([0x62, 0x75, 0x66, 0x66, 0x65, 0x72])
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
439 'buffer'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
440
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
441 >> String.bytesFrom('YnVmZmVy', 'base64')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
442 'buffer'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
443 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
444 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
445
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
446 <tag-name id="string_fromcharcode"><literal>String.fromCharCode(<value>CharCode1</value>[, ...[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
447 <value>CharCodeN</value>]])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
448 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
449 Возвращает строку из одной или более Unicode codepoints.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
450 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
451 >> String.fromCharCode(97, 98, 99, 100)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
452 'abcd'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
453 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
454 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
455
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
456 <tag-name id="string_fromcodepoint"><literal>String.fromCodePoint(<value>codePoint1</value>[, ...[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
457 <value>codePoint2</value>]])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
458 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
459 Возвращает строку из одной или более Unicode codepoints.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
460 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
461 >> String.fromCodePoint(97, 98, 99, 100)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
462 'abcd'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
463 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
464 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
465
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
466 <tag-name id="string_charat"><literal>String.prototype.charAt(<value>индекс</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
467 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
468 Возвращает строку, представляющую одну кодовую единицу Unicode
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
469 внутри указанного <literal>индекса</literal>;
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
470 пустая строка, если индекс вне диапазона значений.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
471 Индекс может быть числом
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
472 между 0 и длиной строки минус 1.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
473 Если индекс не указан, то значение по умолчанию равно <literal>0</literal>,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
474 т.е. возвращается первый символ в строке.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
475 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
476
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
477 <tag-name id="string_codepointat"><literal>String.prototype.CodePointAt(<value>позиция</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
478 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
479 Возвращает число, представляющее codepoint-значение символа
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
480 в пределах указанной <literal>позиции</literal>;
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
481 <literal>undefined</literal>, если элемент в позиции отсутствует.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
482 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
483 >> 'ABCD'.codePointAt(3);
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
484 68
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
485 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
486 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
487
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
488 <tag-name id="string_concat"><literal>String.prototype.concat(<value>строка1</value>[, ...,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
489 <value>строкаN</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
490 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
491 Возвращает строку, содержающую результат объединения указанных
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
492 <literal>строк</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
493 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
494 >> "a".concat("b", "c")
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
495 'abc'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
496 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
497 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
498
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
499 <tag-name id="string_endswith"><literal>String.prototype.endsWith(<value>ПоисковаяСтрока</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
500 <value>длина</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
501 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
502 Возвращает <literal>true</literal>, если строка заканчивается символами
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
503 указанной строки, иначе <literal>false</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
504 Необязательный параметр <literal>длина</literal> задаёт длину строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
505 Если <value>ПоисковаяСтрока</value> не указана,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
506 значением по умолчанию является длина строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
507 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
508 >> 'abc'.endsWith('abc')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
509 true
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
510 >> 'abca'.endsWith('abc')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
511 false
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
512 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
513 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
514
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
515 <tag-name id="string_frombytes"><literal>String.prototype.fromBytes(<value>начало</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
516 <value>конец</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
517 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
518 (только в njs) Возвращает новую строку Unicode из байтовой строки,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
519 в которой каждый байт заменяется соответствующей Unicode codepoint.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
520 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
521
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
522 <tag-name id="string_fromutf8"><literal>String.prototype.fromUTF8(<value>начало</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
523 <value>конец</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
524 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
525 (только в njs) Преобразует байтовую строку, содержащую валидную строку UTF8,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
526 в строку Unicode,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
527 иначе возвращается <literal>null</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
528 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
529
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
530 <tag-name id="string_includes"><literal>String.prototype.includes(<value>поисковаяСтрока</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
531 <value>позиция</value>]))</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
532 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
533 Возвращает <literal>true</literal>, если строка ищется внутри другой строки,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
534 иначе <literal>false</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
535 Необязательный параметр <literal>позиция</literal> задаёт позицию
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
536 внутри строки, от которой начинается поиск для <literal>поисковойСтроки</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
537 Значение по умолчанию равно 0.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
538 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
539 >> 'abc'.includes('bc')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
540 true
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
541 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
542 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
543
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
544 <tag-name id="string_indexof"><literal>String.prototype.indexOf(<value>поисковаяСтрока</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
545 <value>fromIndex</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
546 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
547 Возвращает позицию первого появления
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
548 <literal>поисковойСтроки</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
549 Поиск начинается с <literal>fromIndex</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
550 Возвращает <value>-1</value>, если значение не найдено.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
551 <literal>fromIndex</literal> является числом,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
552 значение по умолчанию равно 0.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
553 Если <literal>fromIndex</literal> меньше, чем 0
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
554 или больше, чем
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
555 <link id="string_length">String.prototype.length</link><value></value>,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
556 поиск начнётся на индексе <value>0</value> и
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
557 <value>String.prototype.length</value>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
558 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
559 >> 'abcdef'.indexOf('de', 2)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
560 3
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
561 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
562 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
563
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
564 <tag-name id="string_lastindexof"><literal>String.prototype.lastIndexOf(<value>поисковаяСтрока</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
565 <value>fromIndex</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
566 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
567 Возвращает позицию последнего появления
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
568 of the <literal>поисковойСтроки</literal>,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
569 поиск осуществляется в обратном порядке от <literal>fromIndex</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
570 Возвращает <value>-1</value>, если значение не найдено.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
571 Если значение <literal>поисковойСтроки</literal> пустое,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
572 то возвращается <literal>fromIndex</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
573 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
574 >> "nginx".lastIndexOf("gi")
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
575 1
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
576 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
577 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
578
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
579 <tag-name id="string_length"><literal>String.prototype.length</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
580 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
581 Возвращает длину строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
582 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
583 >> 'αβγδ'.length
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
584 4
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
585 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
586 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
587
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
588 <tag-name id="string_match"><literal>String.prototype.match([<value>регулярноеВыражение</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
589 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
590 Возвращает совпадение при сопоставлении строки с
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
591 регулярным выражением.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
592 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
593 >> 'nginx'.match( /ng/i )
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
594 'ng'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
595 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
596 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
597
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
598 <tag-name id="string_padend"><literal>String.prototype.padEnd(<value>длина</value>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
599 [, <value>строка</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
600 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
601 Возвращает строку указанной длины,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
602 добавляя строку в конец указанной
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
603 строки (<link doc="changes.xml" id="njs0.2.3">0.2.3</link>).
2316
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
604 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
605 >> '1234'.padEnd(8, 'abcd')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
606 '1234abcd'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
607 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
608 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
609
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
610 <tag-name id="string_padstart"><literal>String.prototype.padStart(<value>длина</value>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
611 [, <value>строка</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
612 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
613 Возвращает строку указанной длины,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
614 добавляя строку к началу указанной
2337
867fe207f13e Updated links to changes.xml in njs Reference.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2332
diff changeset
615 строки (<link doc="changes.xml" id="njs0.2.3">0.2.3</link>).
2316
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
616 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
617 >> '1234'.padStart(8, 'abcd')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
618 'abcd1234'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
619 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
620 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
621
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
622 <tag-name id="string_repeat"><literal>String.prototype.repeat(<value>число</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
623 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
624 Возвращает строку
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
625 с указанным числом копий строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
626 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
627 >> 'abc'.repeat(3)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
628 'abcabcabc'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
629 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
630 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
631
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
632 <tag-name id="string_replace"><literal>String.prototype.replace([<value>регулярноеВыражение</value>|<value>string</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
633 <value>string</value>|<value>function</value>]])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
634 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
635 Возвращает новую строку, которая сопоставляется со
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
636 строкой или регулярным выражением,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
637 и заменяется на <literal>строку</literal> или <literal>функцию</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
638 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
639 >> 'abcdefgh'.replace('d', 1)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
640 'abc1efgh'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
641 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
642 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
643
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
644 <tag-name id="string_search"><literal>String.prototype.search([<value>регулярноеВыражение</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
645 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
646 Осуществляет поиск строки при помощи регулярного выражения.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
647 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
648 >> 'abcdefgh'.search('def')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
649 3
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
650 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
651 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
652
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
653 <tag-name id="string_slice"><literal>String.prototype.slice(<value>начало</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
654 <value>конец</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
655 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
656 Возвращает новую строку, содержащую часть
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
657 исходной строки между <literal>началом</literal>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
658 и <literal>концом</literal> или
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
659 от <literal>начала</literal> до конца строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
660 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
661 >> 'abcdefghijklmno'.slice(NaN, 5)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
662 'abcde'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
663 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
664 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
665
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
666 <tag-name id="string_split"><literal>String.prototype.split(([<value>строка</value>|<value>регулярноеВыражение</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
667 <value>лимит</value>]]))</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
668 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
669 Возвращает совпадение строки регулярному выражению.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
670 Необязательный параметр <literal>лимит</literal> является числом, задающим
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
671 ограничение на количество найденных подстрок.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
672 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
673 >> 'abc'.split('')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
674 [
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
675 'a',
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
676 'b',
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
677 'c'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
678 ]
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
679 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
680 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
681
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
682 <tag-name id="string_startswith"><literal>String.prototype.startsWith(<value>поисковаяСтрока</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
683 <value>позиция</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
684 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
685 Возвращает <literal>true</literal>, если строка начинается с символов
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
686 указанной строки, иначе <literal>false</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
687 Необязательный параметр <literal>позиция</literal> является местом
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
688 в этой строке, с которого начинается поиск <literal>поисковойСтоки</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
689 Значение по умолчанию равно 0.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
690 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
691 >> 'abc'.startsWith('abc')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
692 true
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
693 > 'aabc'.startsWith('abc')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
694 false
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
695 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
696 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
697
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
698 <tag-name id="string_substr"><literal>String.prototype.substr(<value>начало</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
699 <value>длина</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
700 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
701 Возвращает часть строки указанной <literal>длины</literal>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
702 от <literal>начала</literal>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
703 или от <literal>начала</literal> до конца строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
704 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
705 >> 'abcdefghijklmno'.substr(3, 5)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
706 'defgh'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
707 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
708 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
709
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
710 <tag-name id="string_substring"><literal>String.prototype.substring(<value>начало</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
711 <value>конец</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
712 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
713 Возвращает часть строки между
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
714 <literal>началом</literal> и <literal>концом</literal> или
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
715 от от <literal>начала</literal> до конца строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
716 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
717 >> 'abcdefghijklmno'.substring(3, 5)
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
718 'de'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
719 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
720 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
721
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
722 <tag-name id="string_tobytes"><literal>String.prototype.toBytes(начало[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
723 конец])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
724 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
725 (только в njs) Сериализует строку Unicode в байтовую строку.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
726 Возвращает <literal>null</literal>, если в строке найден символ больше, чем 255.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
727 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
728
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
729 <tag-name id="string_tolowercase"><literal>String.prototype.toLowerCase()</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
730 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
731 Преобразует строку в нижний регистр.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
732 Метод поддерживает только простое свёртывание Unicode.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
733 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
734 >> 'ΑΒΓΔ'.toLowerCase()
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
735 'αβγδ'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
736 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
737 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
738
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
739 <tag-name><literal>String.prototype.toString([<value>кодировка</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
740 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
741 <para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
742 Если кодировка не указана,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
743 возвращает указанную строку Unicode string или байтовую строку как в ECMAScript.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
744 </para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
745
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
746 <para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
747 (только в njs) Если кодировка указана,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
748 кодирует <link id="string_tobytes">байтовую строку</link> в
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
749 <literal>hex</literal>,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
750 <literal>base64</literal> или
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
751 <literal>base64url</literal>.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
752 </para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
753 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
754 >> 'αβγδ'.toUTF8().toString('base64url')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
755 'zrHOss6zzrQ'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
756 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
757 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
758
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
759 <tag-name id="string_touppercase"><literal>String.prototype.toUpperCase()</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
760 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
761 Преобразует строку в верхний регистр.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
762 Метод поддерживает только простое свёртывание Unicode.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
763 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
764 >> 'αβγδ'.toUpperCase()
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
765 'ΑΒΓΔ'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
766 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
767 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
768
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
769 <tag-name id="string_toutf8"><literal>String.prototype.toUTF8(<value>начало</value>[,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
770 <value>конец</value>])</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
771 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
772 (только в njs) Сериализует строку Unicode
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
773 в байтовую строку при помощи кодирования UTF8.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
774 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
775 >> 'αβγδ'.toUTF8().length
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
776 8
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
777 >> 'αβγδ'.length
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
778 4
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
779 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
780 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
781
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
782 <tag-name id="string_trim"><literal>String.prototype.trim()</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
783 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
784 Удаляет пробелы в начале и конце строки.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
785 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
786 >> ' abc '.trim()
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
787 'abc'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
788 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
789 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
790
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
791 <tag-name id="encodeuri"><literal>encodeURI(<value>URI</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
792 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
793 Кодирует URI путём замены определённых символов
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
794 на одну, две, три или четыре последовательности,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
795 представляющие UTF-8 кодировку символа.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
796 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
797 >> encodeURI('012αβγδ')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
798 '012%CE%B1%CE%B2%CE%B3%CE%B4'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
799 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
800 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
801
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
802 <tag-name id="encodeuricomponent"><literal>encodeURIComponent(<value>encodedURIString</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
803 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
804 Кодирует URI путём замены определённых символов
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
805 на одну, две, три или четыре последовательности,
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
806 представляющие UTF-8 кодировку символа.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
807 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
808 >> encodeURIComponent('[@?=')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
809 '%5B%40%3F%3D'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
810 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
811 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
812
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
813 <tag-name id="decodeuri"><literal>decodeURI(<value>encodedURI</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
814 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
815 Декодирует ранее <link id="encodeuri">кодированный</link> URI.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
816 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
817 >> decodeURI('012%CE%B1%CE%B2%CE%B3%CE%B4')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
818 '012αβγδ'
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
819 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
820 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
821
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
822 <tag-name id="decodeuricomponent"><literal>decodeURIComponent(<value>decodedURIString</value>)</literal></tag-name>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
823 <tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
824 Декодирует ранее <link id="encodeuri">кодированный</link> URI.
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
825 <example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
826 >> decodeURIComponent('%5B%40%3F%3D')
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
827 '[@?='
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
828 </example>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
829 </tag-desc>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
830
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
831 </list>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
832 </para>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
833
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
834 </section>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
835
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
836 </section>
3a8d96efece6 Translated String object into Russian in njs.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2295
diff changeset
837
2175
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
838 </article>
cd4889fdcfa4 Moved njs HTTP and Stream API to a separate page.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
839