--- title: String slug: Web/JavaScript/Reference/Global_Objects/String tags: - JavaScript - NeedsUpdate - Reference - String translation_of: Web/JavaScript/Reference/Global_Objects/String --- <div>{{JSRef("Global_Objects", "String")}}</div> <p>Объект <strong><code>String</code></strong> используется, чтобы представить и конструировать последовательность символов.</p> <h2 id="Syntax" name="Syntax">Синтаксис</h2> <p>Строковые литералы могут быть следующих форм:</p> <pre class="syntaxbox notranslate"><code>'строка текста' "строка текста" "中文 español English हिन्दी العربية português বাংলা русский 日本語 ਪੰਜਾਬੀ 한국어 தமிழ்" </code></pre> <p>Кроме регулярных печатных символов можно использовать специальные символы, которые можно закодировать, используя нотацию escape-последовательностей:</p> <table class="standard-table"> <thead> <tr> <th scope="col">Код</th> <th scope="col">Вывод</th> </tr> </thead> <tbody> <tr> <td><code>\0</code></td> <td>нулевой символ (символ NUL)</td> </tr> <tr> <td><code>\'</code></td> <td>одинарная кавычка</td> </tr> <tr> <td><code>\"</code></td> <td>двойная кавычка</td> </tr> <tr> <td><code>\\</code></td> <td>обратный слэш</td> </tr> <tr> <td><code>\n</code></td> <td>новая строка</td> </tr> <tr> <td><code>\r</code></td> <td>возврат каретки</td> </tr> <tr> <td><code>\v</code></td> <td>вертикальная табуляция</td> </tr> <tr> <td><code>\t</code></td> <td>табуляция</td> </tr> <tr> <td><code>\b</code></td> <td>забой</td> </tr> <tr> <td><code>\f</code></td> <td>подача страницы</td> </tr> <tr> <td><code>\uXXXX</code></td> <td>кодовая точка Юникода</td> </tr> <tr> <td><code>\xXX</code></td> <td>символ из кодировки Latin-1</td> </tr> </tbody> </table> <p>Либо можно использовать глобальный объект <code>String</code> напрямую:</p> <pre class="syntaxbox notranslate"><code>String(thing) new String(thing) </code></pre> <h3 id="Parameters" name="Parameters">Параметры</h3> <dl> <dt><code>thing</code></dt> <dd>Всё, что может быть преобразовано в строку.</dd> </dl> <h2 id="Description" name="Description">Описание</h2> <p>Строки полезны для хранения данных, которые можно представить в текстовой форме. Некоторые из наиболее частых операций со строками — это проверка их {{jsxref("String.length", "длины", "", 1)}}, построение строки с помощью <a href="/ru/docs/Web/JavaScript/Reference/Operators/String_Operators">операций строковой конкатенации + и +=</a>, проверка на существование или местоположение подстрок с помощью метода {{jsxref("String.prototype.indexOf()", "indexOf()")}}, либо извлечение подстрок с помощью метода {{jsxref("String.prototype.substring()", "substring()")}}.</p> <h3 id="Character_access" name="Character_access">Доступ к символам</h3> <p>Существует два способа добраться до конкретного символа в строке. В первом способе используется метод {{jsxref("String.prototype.charAt()", "charAt()")}}:</p> <pre class="brush: js notranslate">return 'кот'.charAt(1); // вернёт "о" </pre> <p>Другим способом (введённым в ECMAScript 5) является рассмотрение строки как массивоподобного объекта, в котором символы имеют соответствующие числовые индексы:</p> <pre class="brush: js notranslate">return 'кот'[1]; // вернёт "о" </pre> <p>При доступе к символам посредством нотации с квадратными скобками, попытка удалить символ, или присвоить значение числовому свойству закончится неудачей, поскольку эти свойства являются незаписываемыми и ненастраиваемыми. Смотрите документацию по методу {{jsxref("Object.defineProperty()")}} для дополнительной информации.</p> <h3 id="Comparing_strings" name="Comparing_strings">Сравнение строк</h3> <p>Разработчики на C имеют для сравнения строк функцию <code>strcmp()</code>. В JavaScript вы просто используете <a href="https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Operators/%D0%9E%D0%BF%D0%B5%D1%80%D0%B0%D1%82%D0%BE%D1%80%D1%8B_%D1%81%D1%80%D0%B0%D0%B2%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F">операторы меньше и больше</a>:</p> <pre class="brush: js notranslate">var a = 'a'; var b = 'b'; if (a < b) { // true print(a + ' меньше чем ' + b); } else if (a > b) { print(a + ' больше чем ' + b); } else { print(a + ' и ' + b + ' равны.'); } </pre> <p>Подобный результат также может быть достигнут путём использования метода {{jsxref("String.prototype.localeCompare()", "localeCompare()")}}, имеющегося у всех экземпляров <code>String</code>.</p> <h3 id="Distinction_between_string_primitives_and_String_objects" name="Distinction_between_string_primitives_and_String_objects">Разница между строковыми примитивами и объектами <code>String</code></h3> <p>Обратите внимание, что JavaScript различает объекты <code>String</code> и значения строкового примитива (то же самое верно и для объектов {{jsxref("Global_Objects/Boolean", "Boolean")}} и {{jsxref("Global_Objects/Number", "Number")}}).</p> <p>Строковые литералы (обозначаемые двойными или одинарными кавычками) и строки, возвращённые вызовом <code>String</code> в неконструкторном контексте (то есть, без использования ключевого слова {{jsxref("Operators/new", "new")}}) являются строковыми примитивами. JavaScript автоматически преобразует примитивы в объекты <code>String</code>, так что на строковых примитивах возможно использовать методы объекта <code>String</code>. В контекстах, когда на примитивной строке вызывается метод или происходит поиск свойства, JavaScript автоматически оборачивает строковый примитив объектом и вызывает на нём метод или ищет в нём свойство.</p> <pre class="brush: js notranslate">var s_prim = 'foo'; var s_obj = new String(s_prim); console.log(typeof s_prim); // выведет 'string' console.log(typeof s_obj); // выведет 'object' </pre> <p>Строковые примитивы и объекты <code>String</code> также дают разные результаты при использовании глобальной функции {{jsxref("Global_Objects/eval", "eval()")}}. Примитивы, передаваемые в <code>eval()</code>, трактуются как исходный код; объекты же <code>String</code> трактуются так же, как и все остальные объекты, а именно: возвращается сам объект. Например:</p> <pre class="brush: js notranslate">var s1 = '2 + 2'; // создаёт строковый примитив var s2 = new String('2 + 2'); // создаёт объект String console.log(eval(s1)); // выведет число 4 console.log(eval(s2)); // выведет строку '2 + 2' </pre> <p>По этим причинам код может сломаться, если он получает объекты <code>String</code>, а ожидает строковые примитивы, хотя в общем случае вам не нужно беспокоиться о различиях между ними.</p> <p>Объект <code>String</code> также всегда может быть преобразован в его примитивный аналог при помощи метода {{jsxref("String.prototype.valueOf()", "valueOf()")}}.</p> <pre class="brush: js notranslate">console.log(eval(s2.valueOf())); // выведет число 4 </pre> <div class="note"><strong>Примечание:</strong> для того, чтобы узнать больше о другом возможном подходе к строкам в JavaScript, прочитайте статью о <a href="/ru/Add-ons/Code_snippets/StringView"><code>StringView</code> — C-подобном представлении строк на основе типизирванных массивов</a>.</div> <h2 id="Properties" name="Properties">Свойства</h2> <dl> <dt>{{jsxref("String.prototype")}}</dt> <dd>Позволяет добавлять свойства к объекту <code>String</code>.</dd> </dl> <div>{{jsOverrides("Function", "Properties", "prototype")}}</div> <h2 id="Methods" name="Methods">Методы</h2> <dl> <dt>{{jsxref("String.fromCharCode()")}}</dt> <dd>Возвращает строку, созданную из указанной последовательности значений Юникода.</dd> <dt>{{jsxref("String.fromCodePoint()")}} {{experimental_inline}}</dt> <dd>Возвращает строку, созданную из указанной последовательности кодовых точек Юникода.</dd> <dt>{{jsxref("String.raw()")}} {{experimental_inline}}</dt> <dd>Возвращает строку, созданную из сырой шаблонной строки.</dd> </dl> <div>{{jsOverrides("Function", "Methods", "fromCharCode", "fromCodePoint", "raw")}}</div> <h2 id="String_generic_methods" name="String_generic_methods">Общие методы объекта <code>String</code></h2> <p>Методы экземпляров <code>String</code> также доступны в Firefox как часть JavaScript 1.6 (который не является частью стандарта ECMAScript) на объекте <code>String</code>, что позволяет применять эти методы к любому объекту:</p> <pre class="brush: js notranslate">var num = 15; console.log(String.replace(num, /5/, '2')); </pre> <p>{{jsxref("Global_Objects/Array", "Общие методы", "#Array_generic_methods", 1)}} также доступны для объекта {{jsxref("Global_Objects/Array", "Array")}}.</p> <p>Следующая прослойка позволяет использовать их во всех браузерах:</p> <pre class="brush: js notranslate">/*globals define*/ // Предполагаем, что все требуемые методы экземпляров String уже присутствуют // (для них так же можно использовать полифиллы, если их нет) (function() { 'use strict'; var i, // Мы могли построить массив методов следующим образом, однако метод // getOwnPropertyNames() нельзя реализовать на JavaScript: // Object.getOwnPropertyNames(String).filter(function(methodName) { // return typeof String[methodName] === 'function'; // }); methods = [ 'quote', 'substring', 'toLowerCase', 'toUpperCase', 'charAt', 'charCodeAt', 'indexOf', 'lastIndexOf', 'startsWith', 'endsWith', 'trim', 'trimLeft', 'trimRight', 'toLocaleLowerCase', 'toLocaleUpperCase', 'localeCompare', 'match', 'search', 'replace', 'split', 'substr', 'concat', 'slice' ], methodCount = methods.length, assignStringGeneric = function(methodName) { var method = String.prototype[methodName]; String[methodName] = function(arg1) { return method.apply(arg1, Array.prototype.slice.call(arguments, 1)); }; }; for (i = 0; i < methodCount; i++) { assignStringGeneric(methods[i]); } }()); </pre> <h2 id="String_instances" name="String_instances">Экземпляры объекта <code>String</code></h2> <h3 id="Properties_of_String_instance" name="Properties_of_String_instance">Свойства</h3> <div>{{page('/ru/docs/Web/JavaScript/Reference/Global_Objects/String/prototype', 'Properties')}}</div> <h3 id="Methods_of_String_instance" name="Methods_of_String_instance">Методы</h3> <h4 id="Methods_unrelated_to_HTML" name="Methods_unrelated_to_HTML">Методы, не относящиеся к HTML</h4> <div>{{page('/ru/docs/Web/JavaScript/Reference/Global_Objects/String/prototype', 'Methods_unrelated_to_HTML')}}</div> <h4 id="HTML_wrapper_methods" name="HTML_wrapper_methods">Методы-обёртки HTML</h4> <div>{{page('/ru/docs/Web/JavaScript/Reference/Global_Objects/String/prototype', 'HTML_wrapper_methods')}}</div> <h2 id="Examples" name="Examples">Примеры</h2> <h3 id="Example_String_conversion" name="Example:_String_conversion">Пример: преобразование в строку</h3> <p>Объект <code>String</code> можно использовать как «безопасную» альтернативу методу {{jsxref("String.prototype.toString()", "toString()")}}, так как хотя он обычно и вызывает соответствующий метод <code>toString()</code>, он также работает и для значений {{jsxref("Global_Objects/null", "null")}} и {{jsxref("Global_Objects/undefined", "undefined")}}. Например:</p> <pre class="brush: js notranslate">var outputStrings = []; for (var i = 0, n = inputValues.length; i < n; ++i) { outputStrings.push(String(inputValues[i])); } </pre> <h2 id="Specifications" name="Specifications">Спецификации</h2> <table class="standard-table"> <tbody> <tr> <th scope="col">Спецификация</th> <th scope="col">Статус</th> <th scope="col">Комментарии</th> </tr> <tr> <td>ECMAScript 1-е издание.</td> <td>Стандарт</td> <td>Изначальное определение.</td> </tr> <tr> <td>{{SpecName('ES5.1', '#sec-15.5', 'String')}}</td> <td>{{Spec2('ES5.1')}}</td> <td></td> </tr> <tr> <td>{{SpecName('ES6', '#sec-string-objects', 'String')}}</td> <td>{{Spec2('ES6')}}</td> <td></td> </tr> </tbody> </table> <h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> <div class="hidden"> <p>The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> </div> <p>{{Compat("javascript.builtins.String",2)}}</p> <div></div> <h2 id="See_also" name="See_also">Смотрите также</h2> <ul> <li>{{domxref("DOMString")}}</li> <li><a href="/ru/Add-ons/Code_snippets/StringView"><code>StringView</code> — C-подобное представление строк на основе типизированных массивов</a></li> <li><a href="/ru/docs/Web/API/DOMString/Binary">Двоичные строки</a></li> </ul>