path: root/files/ru/web/api/websocket/index.html

---
title: WebSocket
slug: Web/API/WebSocket
tags:
  - API
  - WebSocket
  - WebSockets
translation_of: Web/API/WebSocket
---
<p>Объект <strong>WebSocket </strong>предоставляет API для создания и управления <a href="/ru/WebSockets">веб-сокет</a>-подключения к серверу, а также для отправки и получения данных в этом подключении.</p>

<p>Конструктор WebSocket принимает один обязательный и один опциональный параметр:</p>

<pre>WebSocket WebSocket(
  in DOMString url,
  in optional DOMString protocols
);

WebSocket WebSocket(
  in DOMString url,
  in optional DOMString[] protocols
);
</pre>

<dl>
 <dt><code>url</code></dt>
 <dd>URL-адрес к которому подключаться; сервер по этому адресу должен ответить на websocket-запрос.</dd>
 <dt><code>protocols</code> {{ optional_inline() }}</dt>
 <dd>Протокол в виде строки или массив строк протоколов. Эти строки используются для определения подпротоколов клиента, т.к. один сервер может поддерживать несколько WebSocket-подпротоколов (например, вы можете захотеть, чтобы один сервер мог обрабатывать разные типы взаимодействия в зависимости от указанного протокола).  Если вы не укажете значение протокола, по умолчанию будет использоваться пустая строка.</dd>
</dl>

<p>Конструктор может выбросить исключение:</p>

<dl>
 <dt><code>SECURITY_ERR</code></dt>
 <dd>Порт, на который устанавливается подключение заблокирован.</dd>
</dl>

<dl>
</dl>

<h2 id="Method_overview">Обзор метода</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td><code>void <a href="#close()">close</a>(in optional unsigned long code, in optional DOMString reason);</code></td>
  </tr>
  <tr>
   <td><code>void <a href="#send()">send</a>(in DOMString data);</code></td>
  </tr>
 </tbody>
</table>

<h2 id="Атрибуты"><font face="x-locale-heading-primary, zillaslab, Palatino, Palatino Linotype, x-locale-heading-secondary, serif"><span style="font-size: 40px;"><strong>Атрибуты</strong></span></font></h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td class="header">Атрибут</td>
   <td class="header">Тип</td>
   <td class="header">Описание</td>
  </tr>
  <tr>
   <td><code>binaryType</code></td>
   <td>{{ DOMXref("DOMString") }}</td>
   <td>Строка, указывающая на тип двоичных данных, которые будут переданы по соединению. Это может быть "blob" если будут использованы {{ domxref("Blob") }} объекты или "arraybuffer" если будут использованы объекты <a href="/en/JavaScript_typed_arrays/ArrayBuffer" title="en/JavaScript typed arrays/ArrayBuffer"><code>ArrayBuffer</code></a> </td>
  </tr>
  <tr>
   <td><code>bufferedAmount</code></td>
   <td><code><a href="/en/unsigned_long" title="en/unsigned long">unsigned long</a></code></td>
   <td>Количество байтов данных, которые были поставлены в очередь, используя вызовы {{ manch("send") }}, но ещё не переданные в сеть. Это значение не сбрасывается в ноль, при закрытии соединения; если продолжить вызывать  {{ manch("send") }}, значение будет расти. <strong>Только чтение.</strong></td>
  </tr>
  <tr>
   <td><code>extensions</code></td>
   <td>{{ DOMXref("DOMString") }}</td>
   <td>Расширения, выбранные сервером. В настоящее время это только пустая строка или список расширений, согласованных соединением.</td>
  </tr>
  <tr>
   <td><code>onclose</code></td>
   <td>{{ domxref("EventListener") }}</td>
   <td>Обработчик событий, вызываемый, когда <code>readyState </code>WebSocket соединения изменяется на <code>CLOSED</code>. Наблюдатель получает <a href="/en/WebSockets/WebSockets_reference/CloseEvent" title="en/WebSockets/WebSockets reference/CloseEvent"><code>CloseEvent</code></a> с именем "close".</td>
  </tr>
  <tr>
   <td><code>onerror</code></td>
   <td>{{ domxref("EventListener") }}</td>
   <td>
    <p>Обработчик событий, вызываемый, когда происходит ошибка. Это простое событие, называемое "error".</p>
   </td>
  </tr>
  <tr>
   <td><code>onmessage</code></td>
   <td>{{ domxref("EventListener") }}</td>
   <td>
    <p>Обработчик событий , вызываемый, когда получается сообщение с сервера. Наблюдатель получает <code><a href="en-US/docs/Web/API/MessageEvent" title="en-US/docs/Web/API/MessageEvent">MessageEvent</a></code>,  называемое "message".</p>
   </td>
  </tr>
  <tr>
   <td><code>onopen</code></td>
   <td>{{ domxref("EventListener") }}</td>
   <td>
    <p>Наблюдатель событий, вызываемый, когда <code>readyState</code> WebSocket - соединения изменяется на <code>OPEN</code>; это показывает, что соединение готово отсылать и принимать данные. Это простое событие, называемое "open".</p>
   </td>
  </tr>
  <tr>
   <td><code>protocol</code></td>
   <td>{{ DOMXref("DOMString") }}</td>
   <td>
    <p>Строка, обозначающая имя подпротокола выбранного сервера; это будет одной из строк, указываемой в параметре <code>protocols</code> при создании WebSocket - объекта.</p>
   </td>
  </tr>
  <tr>
   <td><code>readyState</code></td>
   <td><code><a href="/en/unsigned_short" title="en/unsigned short">unsigned short</a></code></td>
   <td>
    <p>Текущее состояние подключения; это одно из {{ anch("Ready state constants") }}. <strong>Только для чтения</strong><strong>.</strong></p>
   </td>
  </tr>
  <tr>
   <td><code>url</code></td>
   <td>{{ DOMXref("DOMString") }}</td>
   <td>
    <p>URL, создаваемый конструктором. Это всегда абсолютный URL. <strong>Только для чтения.</strong></p>
   </td>
  </tr>
 </tbody>
</table>

<h2 id="Constants">Константы</h2>

<h3 id="Константы_состояния_готовности">Константы состояния готовности</h3>

<p>Эти константы используются атрибутом <code>readyState</code> для описания состояния WebSocket - подключения</p>

<table class="standard-table">
 <tbody>
  <tr>
   <td class="header">Константа</td>
   <td class="header">Значение</td>
   <td class="header">Описание</td>
  </tr>
  <tr>
   <td><code>CONNECTING</code></td>
   <td><code>0</code></td>
   <td>Соединение ещё не открыто.</td>
  </tr>
  <tr>
   <td><code>OPEN</code></td>
   <td><code>1</code></td>
   <td>Соединение открыто и готово к обмену данными.</td>
  </tr>
  <tr>
   <td><code>CLOSING</code></td>
   <td><code>2</code></td>
   <td>Соединение в процессе закрытия.</td>
  </tr>
  <tr>
   <td><code>CLOSED</code></td>
   <td><code>3</code></td>
   <td>Соединение закрыто или не может открыться.</td>
  </tr>
 </tbody>
</table>

<h2 id="Methods">Методы</h2>

<h3 id="close">close()</h3>

<p>Закрывает WebSocket - подключение или заканчивает попытку подключения. Если подключение уже закрыто, этот метод не делает ничего.</p>

<pre class="eval">void close(
  in optional unsigned short code,
  in optional DOMString reason
);
</pre>

<h6 id="Parameters">Параметры</h6>

<dl>
 <dt><code>code</code> {{ optional_inline() }}</dt>
 <dd>Числовое значение, обозначающее статус-код, описывающий почему подключение будет закрыто. Если параметр не указан, значение по умолчанию равно 1000(обозначает "обмен завершён"). Смотрите <a href="en-US/docs/Web/API/CloseEvent#properties" title="en-US/docs/Web/API/CloseEvent#properties">list of status codes</a> для <code><a href="en-US/docs/Web/API/CloseEvent" title="en-US/docs/Web/API/CloseEvent">CloseEvent</a></code>, чтобы узнать разрешённые значения.</dd>
 <dt><code>reason</code> {{ optional_inline() }}</dt>
 <dd>Читаемая человеком строка, объясняющая, почему подключение закрывается. Строка должна быть не длиннее, чем 123 байта UTF-8 текста (<strong>не</strong> символов). </dd>
</dl>

<h6 id="Возможные_исключения">Возможные исключения</h6>

<dl>
 <dt><code>INVALID_ACCESS_ERR</code></dt>
 <dd>Указан неверный <code>code</code>.</dd>
 <dt><code>SYNTAX_ERR</code></dt>
 <dd>Строка <code>reason</code> слишком длинные или содержит непарные суррогаты.</dd>
</dl>

<h6 id="Примечания">Примечания</h6>

<p>В Gecko этот метод не поддерживает никакие параметры включительно до Gecko 8.0 {{ geckoRelease("8.0") }}.</p>

<h3 id="send">send()</h3>

<p>Передаёт данные на сервер через WebSocket - соединение.</p>

<pre class="eval">void send(
  in DOMString data
);

void send(
  in ArrayBuffer data
);

void send(
  in Blob data
);
</pre>

<h6 id="Parameters">Параметры</h6>

<dl>
 <dt><code>data</code></dt>
 <dd>Текстовая строка, которая будет отправлена на сервер.</dd>
</dl>

<h6 id="Возможные_исключения_2">Возможные исключения</h6>

<dl>
 <dt><code>INVALID_STATE_ERR</code></dt>
 <dd>Соединение ещё не открыто.</dd>
 <dt><code>SYNTAX_ERR</code></dt>
 <dd>Строка <code>data</code> содержит непарные суррогаты</dd>
</dl>

<div class="note">
<p><strong>Заметьте:</strong> Gecko - реализация метода <code>send()</code> несколько отличается от специфицированной в {{Gecko("6.0")}}; Gecko возвращает <code>boolean</code>, обозначающий, открыто ли соединение до сих пор (и, в дополнение, были ли доставлены данные); это было исправлено в {{Gecko("8.0")}}.</p>

<p>Начиная с {{Gecko("11.0")}}, поддержка <code><a href="/en/JavaScript_typed_arrays/ArrayBuffer" title="en/JavaScript typed arrays/ArrayBuffer">ArrayBuffer</a></code> была реализована, но не {{ domxref("Blob") }} типы данных.</p>
</div>

<h2 id="See_also">Спецификации</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td> <strong>Спецификация</strong></td>
   <td><strong>Статус</strong></td>
  </tr>
  <tr>
   <td>{{SpecName("HTML WHATWG", "web-sockets.html#the-websocket-interface", "WebSocket")}}</td>
   <td>{{Spec2("HTML WHATWG")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="See_also">Пример</h2>

<pre class="brush: js"><code>// Создаёт WebSocket - подключение.
const socket = new WebSocket('ws://localhost:8080');

// Соединение открыто
socket.addEventListener('open', function (event) {
    socket.send('Hello Server!');
});

// Наблюдает за сообщениями
socket.addEventListener('message', function (event) {
    console.log('Message from server ', event.data);
});</code></pre>

<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2>

<div>


<p>{{Compat("api.WebSocket")}}</p>
</div>

<h2 id="See_also">Смотрите также</h2>

<ul>
 <li><a href="/en/WebSockets/Writing_WebSocket_client_applications" title="en/WebSockets/Writing WebSocket client applications">Writing WebSocket client applications</a></li>
 <li><a class="external" href="http://dev.w3.org/html5/websockets/">HTML5: WebSockets</a></li>
</ul>