-
Notifications
You must be signed in to change notification settings - Fork 8k
/
index.md
51 lines (35 loc) · 2.63 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
---
title: "WebSocket: send() メソッド"
short-title: send()
slug: Web/API/WebSocket/send
l10n:
sourceCommit: 6a0f22ee0b3a854ed37271373cbc1d1099c0d361
---
{{APIRef("Web Sockets API")}}
**`WebSocket.send()`** メソッドは、 WebSocket 接続を介してサーバーに送るために指定されたデータを、格納するために必要なバイト数だけ `bufferedAmount` の値を増加させながらキューに入れます。もしデータが送信できなかった場合(例えば、バッファリングが必要だが、バッファが一杯であるなどの理由で)、ソケットは自動的に閉じられます。
接続が `CONNECTING` 状態のときに `send()` を呼び出すと、ブラウザーは例外を発生させます。接続が `CLOSING` または `CLOSED` の状態のときに `send()` を呼び出すと、ブラウザーはデータを暗黙に破棄します。
## 構文
```js-nolint
send(data)
```
### 引数
- `data`
- : サーバーに送信するデータです。以下の何れかの型のデータを指定します。
- `string`
- : テキスト文字列。文字列は UTF-8 形式でバッファーに追加され、 `bufferedAmount` の値は UTF-8 の文字列を表すのに必要とされるバイト数だけ増えます。
- {{jsxref("ArrayBuffer")}}
- : 型付きの配列オブジェクトで使用される基本的なバイナリーデータを送信することができます。このバイナリーデータのコンテンツは,必要なバイト数だけ `bufferedAmount` の値を増やして、バッファーのキューに入れられます。
- {{domxref("Blob")}}
- : `Blob` を指定すると、バイナリーフレームで送信される blob の生データをキューに入れます({{domxref("Blob.type")}} は無視されます)。
`bufferedAmount` の値は、その生データのバイトサイズだけ増えます。
- {{jsxref("TypedArray")}} または {{jsxref("DataView")}}
- : [JavaScript の型付き配列](/ja/docs/Web/JavaScript/Guide/Typed_arrays)オブジェクトをバイナリーフレームとして送信することができます。このバイナリーデータのコンテンツは,必要なバイト数だけ `bufferedAmount` の値を増やして、バッファのキューに入れられます。
### 返値
なし ({{jsxref("undefined")}})。
### 例外
- `InvalidStateError` {{domxref("DOMException")}}
- : {{domxref("WebSocket/readyState", "WebSocket.readyState")}} が `CONNECTING` である場合に発生します。
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}