recursal/MDN huggingface dataset:
String.prototype.link()
=======================

**Устарело:** Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

Сводка
------

Метод **`link()`** создаёт HTML-элемент `<a>`, заставляющий строку отображаться в виде ссылки на другой URL.

Синтаксис
---------
```

str.link(url)
```

### Параметры

`url`

Любая строка, определяющая атрибут `href` тега `<a>`; она должна содержать допустимый URL (относительный или абсолютный), символы амперсанда `&` должны быть закодированы в ней как `&amp;`, а символы кавычки `"` — как `&quot;`.

Описание
--------

Метод `link()` используется для создания кусочка HTML со ссылкой в гипертексте. Возвращённая строка затем может быть добавлена в документ при помощи метода `document.write()` или свойства `element.innerHTML`

Ссылки, созданные методом `link()`, становятся элементами в массиве `document.links`.

Примеры
-------

### Пример: использование метода `link()`

В следующем примере слово «MDN» отображается в виде гипертекстовой ссылки, ведущей на сайт Сети разработчиков Mozilla.


```js
var hotText = "MDN";
var URL = "https://developer.mozilla.org/";

document.write("Нажмите для возврата на " + hotText.link(URL));
```


Этот пример генерирует такой же вывод, как и следующий HTML:


```html
Нажмите для возврата на <a href="https://developer.mozilla.org/">MDN</a>
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.link |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.anchor()`
String.prototype.toLocaleLowerCase()
====================================

Сводка
------

Метод **`toLocaleLowerCase()`** возвращает значение строки, на которой он был вызван, преобразованное в нижний регистр согласно правилам преобразования регистра локали.

Синтаксис
---------
```

str.toLocaleLowerCase()
```

Описание
--------

Метод `toLocaleLowerCase()` возвращает значение строки, преобразованное в нижний регистр согласно правилам преобразования регистра локали. Метод `toLocaleLowerCase()` не изменяет значение самой строки. В большинстве случаев он возвращает тот же результат, что и метод `toLowerCase()`, но для некоторых локалей, например, турецкой, в которой правила преобразования регистра отличаются от правил по умолчанию, принятых в Юникоде, он может вернуть другой результат.

Примеры
-------

### Пример: использование метода `toLocaleLowerCase()`


```js
console.log("АЛФАВИТ".toLocaleLowerCase()); // 'алфавит'
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.tolocalelowercase |
| ECMAScript Internationalization API Specification # sup-string.prototype.tolocalelowercase |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.toLocaleUpperCase()`
* `String.prototype.toLowerCase()`
* `String.prototype.toUpperCase()`
String.prototype.blink()
========================

**Устарело:** Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

Сводка
------

Метод **`blink()`** создаёт HTML-элемент `<blink>`, заставляющий строку мерцать.

**Предупреждение:** мерцающий текст осуждается некоторыми стандартами доступности. Сам элемент `<blink>` является нестандартным и устаревшим!

Синтаксис
---------
```

str.blink()
```

Описание
--------

Метод `blink()` заключает строку в тег `<blink>`: `"<blink>str</blink>"`.

Примеры
-------

### Пример: использование метода `blink()`

В следующем примере демонстрируется использование нескольких строковых методов для изменения форматирования строки:


```js
var worldString = "Привет, мир";

document.write(worldString.blink());
document.write(worldString.bold());
document.write(worldString.italics());
document.write(worldString.strike());
```


Этот пример генерирует такой же вывод, как и следующий HTML:


```html
<blink>Привет, мир</blink>
<b>Привет, мир</b>
<i>Привет, мир</i>
<strike>Привет, мир</strike>
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.blink |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.bold()`
* `String.prototype.italics()`
* `String.prototype.strike()`
String.prototype.small()
========================

**Устарело:** Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

Сводка
------

Метод **`small()`** создаёт HTML-элемент `<small>` (en-US), заставляющий строку отображаться маленьким шрифтом.

Синтаксис
---------
```

str.small()
```

Описание
--------

Метод `small()` заключает строку в тег `<small>`: `"<small>str</small>"`.

Примеры
-------

### Пример: использование метода `small()`

В следующем примере демонстрируется использование нескольких строковых методов для изменения размера строки:


```js
var worldString = "Привет, мир";

console.log(worldString.small()); // <small>Привет, мир</small>
console.log(worldString.big()); // <big>Привет, мир</big>
console.log(worldString.fontsize(7)); // <fontsize=7>Привет, мир</fontsize>
```


При помощи объекта `element.style` (en-US) вы можете получить значение атрибута `style` элемента и управлять им более обобщённым способом, например:


```js
document.getElementById("yourElemId").style.fontSize = "0.7em";
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.small |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.fontsize()`
* `String.prototype.big()`
String.prototype.toString()
===========================

Сводка
------

Метод **`toString()`** возвращает строку, представляющую указанный объект.

Синтаксис
---------
```

str.toString()
```

Описание
--------

Объект `String` переопределяет метод `toString()`, унаследованный из объекта `Object`; он не наследует метод `Object.prototype.toString()`. Для объектов `String` метод `toString()` возвращает строку, представляющую объект и делает тоже самое, что и метод `String.prototype.valueOf()`.

Примеры
-------

### Пример: использование метода `toString()`

В следующем примере выводится строковое значение объекта `String`:


```js
var x = new String("Привет, мир");

console.log(x.toString()); // Отобразит 'Привет, мир'
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.tostring |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Object.prototype.toSource()` (en-US)
* `String.prototype.valueOf()`
String.prototype.anchor()
=========================

**Устарело:** Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

Сводка
------

Метод **`anchor()`** создаёт якорный HTML-элемент `<a>`, используемый в качестве цели гиперссылки.

Синтаксис
---------
```

str.anchor(name)
```

### Параметры

`name`

Строка, представляющая атрибут `name` создаваемого тега.

Описание
--------

Метод `anchor()` используется для программного создания и отображения якоря в документе.

Текстовая строка представляет из себя буквальный текст, который вы хотите показать пользователю. Строковый параметр `name` представляет атрибут `name` элемента `<a>`.

Якоря, созданные методом `anchor()`, становятся элементами в массиве `document.anchors`.

Примеры
-------

### Пример: использование метода `anchor()`


```js
var myString = "Оглавление";

document.body.innerHTML = myString.anchor("contents\_anchor");
```


приведёт к выводу следующего HTML:


```html
<a name="contents\_anchor">Оглавление</a>
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.anchor |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.link()`
String.prototype.fontsize()
===========================

**Устарело:** Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

Сводка
------

Метод **`fontsize()`** создаёт HTML-элемент `<font>`, заставляющий строку отображаться шрифтом указанного размера.

**Примечание:** элемент <font> был удалён из HTML5 (en-US) и больше не должен использоваться. Вместо него веб-разработчикам следует использовать свойства CSS.

Синтаксис
---------
```

str.fontsize(size)
```

### Параметры

`size`

Целое число от 1 до 7, либо строка с целым числом со знаком по модулю от 1 до 7.

Описание
--------

При задании размера в виде целого числа, вы устанавливаете размер шрифта строки `str` в один из 7 предопределённых размеров. При задании размера в виде строки, например, "-2", вы задаёте размер шрифта строки `str` относительно размера, установленного тегом `<basefont>` (en-US).

Примеры
-------

### Пример: использование метода `fontsize()`

В следующем примере демонстрируется использование нескольких строковых методов для изменения размера строки:


```js
var worldString = "Привет, мир";

console.log(worldString.small()); // <small>Привет, мир</small>
console.log(worldString.big()); // <big>Привет, мир</big>
console.log(worldString.fontsize(7)); // <fontsize=7>Привет, мир</fontsize>
```


При помощи объекта `element.style` (en-US) вы можете получить значение атрибута `style` элемента и управлять им более обобщённым способом, например:


```js
document.getElementById("yourElemId").style.fontSize = "0.7em";
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.fontsize |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.big()`
* `String.prototype.small()`
String.length
=============

Сводка
------

Свойство **`length`** представляет длину строки.

Синтаксис
---------
```

str.length
```

Описание
--------

Это свойство возвращает количество кодовых значений в строке. В UTF-16, строковом формате, используемом в JavaScript, для представления большинства символов используется одно 16-битное кодовое значение, но для представления не так часто используемых символов требуется два кодовых значения, так что вполне может быть так, что значение, возвращённое свойством `length` не будет соответствовать действительному количеству символов в строке.

Для пустых строк свойство `length` возвращает 0.

Статическое свойство `String.length` возвращает значение 1.

Примеры
-------

### Пример: базовое использование


```js
var x = "Mozilla";
var empty = "";

console.log("Слово «Mozilla» занимает " + x.length + " кодовых значений");
/\* "Слово «Mozilla» занимает 7 кодовых значений" \*/

console.log("Пустая строка имеет длину, равную " + empty.length);
/\* "Пустая строка имеет длину, равную 0" \*/
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-properties-of-string-instances-length |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Свойство `String.length` в JavaScript и интернационализация веб-приложений
String.prototype.trim()
=======================

Сводка
------

Метод **`trim()`** удаляет пробельные символы с начала и конца строки. Пробельными символами в этом контексте считаются все собственно пробельные символы (пробел, табуляция, неразрывный пробел и прочие) и все символы конца строки (LF, CR и прочие).

Синтаксис
---------
```

str.trim()
```

Описание
--------

Метод `trim()` возвращает строку с вырезанными пробельными символами с её концов. Метод `trim()` не изменяет значение самой строки.

Примеры
-------

### Пример: использование метода `trim()`

Следующий пример покажет строку `'foo'`:


```js
var orig = " foo ";
console.log(orig.trim()); // 'foo'

// Другой пример, в котором .trim() убирает пробельные символы только с одной стороны.

var orig = "foo ";
console.log(orig.trim()); // 'foo'
```

Полифил
-------

Запуск следующего кода до любого другого создаст метод `trim()`, если он ещё не реализуется браузером.


```js
if (!String.prototype.trim) {
  (function () {
    // Вырезаем BOM и неразрывный пробел
    String.prototype.trim = function () {
      return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, "");
    };
  })();
}
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.trim |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.trimLeft()` 
Non-standard
* `String.prototype.trimRight()` 
Non-standard
String.prototype.toUpperCase()
==============================

Сводка
------

Метод **`toUpperCase()`** возвращает значение строки, на которой он был вызван, преобразованное в верхний регистр.

Синтаксис
---------
```

str.toUpperCase()
```

Описание
--------

Метод `toUpperCase()` возвращает значение строки, преобразованное в верхний регистр. Метод `toUpperCase()` не изменяет значение самой строки.

Примеры
-------

### Пример: использование метода `toUpperCase()`


```js
console.log("алфавит".toUpperCase()); // 'АЛФАВИТ'
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.touppercase |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.toLocaleLowerCase()`
* `String.prototype.toLocaleUpperCase()`
* `String.prototype.toLowerCase()`
String.prototype.search()
=========================

Сводка
------

Метод **`search()`** выполняет поиск сопоставления между регулярным выражением и этим объектом `String`.

Синтаксис
---------
```

str.search([regexp])
```

### Параметры

`regexp`

Необязательный параметр. Объект регулярного выражения. Если будет передан не объект регулярного выражения, он будет неявно преобразован в объект `RegExp` через вызов конструктора `new RegExp(regexp)`.

Описание
--------

При успехе метод `search()` возвращает индекс первого сопоставления с регулярным выражением внутри строки. В противном случае метод вернёт -1.

Если вы хотите узнать, находится ли шаблон в строке, используйте метод `search()` (он работает почти так же, как и метод `test()` регулярного выражения, но вместо наличия подстроки возвращает её индекс); для получения дополнительной информации (за счёт более медленного выполнения) используйте метод `match()` (работает так же, как метод `exec()` регулярного выражения).

Примеры
-------

### Пример: использование метода `search()`

В следующем примере в журнал попадает сообщение, зависящее от успешности или неуспешности прохождения проверки.


```js
function testInput(re, str) {
  var midstring;
  if (str.search(re) != -1) {
    midstring = " содержит ";
  } else {
    midstring = " не содержит ";
  }
  console.log(str + midstring + re);
}

var testString = "hey JuDe";
var re = /[A-Z]/g;

testInput(re, testString); // выведет: hey Jude содержит /[A-Z]/g
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.search |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.match()`
* `RegExp.prototype.exec()`
String.prototype.italics()
==========================

**Устарело:** Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

Сводка
------

Метод **`italics()`** создаёт HTML-элемент `<i>` (en-US), заставляющий строку отображаться курсивом.

Синтаксис
---------
```

str.italics()
```

Описание
--------

Метод `italics()` заключает строку в тег `<i>`: `"<i>str</i>"`.

Примеры
-------

### Пример: использование метода `italics()`

В следующем примере демонстрируется использование нескольких строковых методов для изменения форматирования строки:


```js
var worldString = "Привет, мир";

document.write(worldString.blink());
document.write(worldString.bold());
document.write(worldString.italics());
document.write(worldString.strike());
```


Этот пример генерирует такой же вывод, как и следующий HTML:


```html
<blink>Привет, мир</blink>
<b>Привет, мир</b>
<i>Привет, мир</i>
<strike>Привет, мир</strike>
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.italics |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.prototype.blink()`
* `String.prototype.bold()`
* `String.prototype.strike()`
String.prototype.codePointAt()
==============================

Сводка
------

Метод **`codePointAt()`** возвращает неотрицательное целое число, являющееся закодированным в UTF-16 значением кодовой точки.

Синтаксис
---------
```

str.codePointAt(pos)
```

### Параметры

`pos`

Позиция элемента в строке, чья кодовая точка возвращается функцией.

Описание
--------

Если на указанной позиции нет элементов, будет возвращено значение `undefined`. Если суррогатная пара UTF-16 не начинается в позиции `pos`, будет возвращено кодовое значение в позиции `pos`.

Примеры
-------

### Пример: использование метода `codePointAt()`


```js
"ABC".codePointAt(1); // 66
"\uD800\uDC00".codePointAt(0); // 65536

"XYZ".codePointAt(42); // undefined
```

Полифил
-------

Следующий полифил расширяет прототип строки определённой в ECMAScript 6 функцией `codePointAt()`, если браузер не имеет её родной поддержки.


```js
/\*! http://mths.be/codepointat v0.1.0 от @mathias \*/
if (!String.prototype.codePointAt) {
  (function () {
    "use strict"; // необходимо для поддержки методов `apply`/`call` с `undefined`/`null`
    var codePointAt = function (position) {
      if (this == null) {
        throw TypeError();
      }
      var string = String(this);
      var size = string.length;
      // `ToInteger`
      var index = position ? Number(position) : 0;
      if (index != index) {
        // лучше, чем `isNaN`
        index = 0;
      }
      // Проверяем выход индекса за границы строки
      if (index < 0 || index >= size) {
        return undefined;
      }
      // Получаем первое кодовое значение
      var first = string.charCodeAt(index);
      var second;
      if (
        // проверяем, не начинает ли оно суррогатную пару
        first >= 0xd800 &&
        first <= 0xdbff && // старшая часть суррогатной пары
        size > index + 1 // следующее кодовое значение
      ) {
        second = string.charCodeAt(index + 1);
        if (second >= 0xdc00 && second <= 0xdfff) {
          // младшая часть суррогатной пары
          // http://mathiasbynens.be/notes/javascript-encoding#surrogate-formulae
          return (first - 0xd800) \* 0x400 + second - 0xdc00 + 0x10000;
        }
      }
      return first;
    };
    if (Object.defineProperty) {
      Object.defineProperty(String.prototype, "codePointAt", {
        value: codePointAt,
        configurable: true,
        writable: true,
      });
    } else {
      String.prototype.codePointAt = codePointAt;
    }
  })();
}
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.codepointat |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `String.fromCodePoint()`
* `String.fromCharCode()`
* `String.prototype.charCodeAt()`
* `String.prototype.charAt()`
String.raw()
============

Сводка
------

Статический метод **`String.raw()`** является теговой функцией для шаблонных строк; подобно префиксу `r` в Python или префиксу `@` в C# для строковых литералов, эта функция используется для получения необработанной строки из шаблона.

Синтаксис
---------
```

String.raw(callSite, ...substitutions)

String.raw`templateString`
```

### Параметры

`callSite`

Правильно сформированный объект вызова, например `{ raw: 'string' }`.

`...substitutions`

Значения подстановок.

`templateString`

Шаблонная строка, возможно с подстановками (`${...}`).

### Выбрасываемые исключения

`TypeError`

Если первый аргумент не является правильно сформированным объектом вызова, выбрасывается исключение `TypeError`.

Описание
--------

В большинстве случаев метод `String.raw()` используется вместе с шаблонными строками. Первый синтаксис, показанный выше, используется редко, поскольку движок JavaScript будет вызывать метод с соответствующими аргументами, подобно другим теговым функциям.

Метод `String.raw()` является единственной встроенной теговой функцией шаблонных строк, выступающей стандартной функцией по объединению их фрагментов. Вы и сами могли бы реализовать подобную функциональность на JavaScript.

Примеры
-------

### Пример: использование метода `String.raw()`


```js
String.raw`Привет\n${2 + 3}!`;
// 'Привет\n5!', символ после 'Привет' не является символом новой строки,
// '\' и 'n' - это два символа.

String.raw`Привет\u000A!`;
// 'Привет\u000A!', а здесь мы получим символы
// \, u, 0, 0, 0, A, всего 6 символов.
// Экранирующие символы не имеют особого значения и
// обратные слеши будут присутствовать в выходной строке.
// Вы можете убедиться в этом, проверив свойство .length строки.

let name = "Боб";
String.raw`Привет\n${name}!`;
// 'Привет\nБоб!', сработала подстановка.

// Обычно вам не нужно вызывать метод String.raw() как функцию,
// но никто не запрещает вам делать это:
String.raw({ raw: "тест" }, 0, 1, 2);
// 'т0е1с2т'
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.raw |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Шаблонные строки
* `String`
* Лексическая грамматика