io.sails
オブジェクトio.sails
オブジェクトは、sails.io.js
ライブラリとその作成するすべてのソケットに関するグローバルな設定オプションの格納場所です。io.sails
のプロパティのほとんどは、クライアントソケットをサーバーに接続する際のsettingsとして、またはクライアントライブラリ自体の最上位設定として使用されます。io.sails
は、新しいソケット接続を手動で作成するために使用される.connect()
メソッドも提供します。
io.sails
の設定方法については、Socket クライアントを参照してください。
.connect()
メソッドio.sails.autoConnect
がfalse
の場合、またはsails.io.js
ライブラリで複数のソケット接続を作成する必要がある場合、io.sails.connect([url], [options])
を使用して作成します。両方の引数はオプションであり、io.sails
のプロパティ(url
、transports
など)の値がデフォルトとして使用されます。オプションについては、SailsSocket プロパティリファレンスを参照してください。
io.sails.autoConnect
io.sails.autoConnect
がtrue
(デフォルト設定)に設定されている場合、ライブラリはロード後にイベントループの1サイクルを待ってから、新しいSailsSocket
を作成し、io.sails.url
で指定されたURLに接続しようとします。ブラウザで使用する場合、新しいソケットはio.socket
として公開されます。Node.jsスクリプトで使用する場合、新しいソケットはsails.io.js
ライブラリを初期化するために使用された変数のsocket
プロパティとして添付されます。
io.sails.reconnection
io.sails.reconnection
がtrue
に設定されている場合、ソケットは予期せず切断された場合(つまり、.disconnect()
の呼び出しの結果ではない場合)、自動的に(そして継続的に)サーバーへの再接続を試みます。false
(デフォルト)に設定されている場合、自動的な再接続の試行は行われません。デフォルトはfalse
です。
io.sails.environment
io.sails.environment
を使用して、sails.io.js
の環境を設定します。これは、コンソールにログ出力される情報の量に影響します。有効な値はdevelopment
(完全なログ)とproduction
(最小限のログ)です。
io.sails
の他のプロパティは、新しいソケット(eager socketまたはio.sails.connect()
経由)を作成する際のデフォルト値として使用されます。利用可能なオプションの完全なリストと、デフォルトのio.sails
値の表については、SailsSocket プロパティリファレンスを参照してください。最も一般的に使用されるプロパティを以下に示します。
プロパティ | 型 | デフォルト | 詳細 |
---|---|---|---|
url | io.sails.url の値 |
ソケットが接続している、または接続しようとしているURL。 | |
transports | io.sails.transports の値 |
ソケットが接続を試みるトランスポート。トランスポートは順番に試され、アップグレードが許可されます。つまり、「polling」と「websocket」の両方をリストした場合、ロングポーリング接続を確立した後、サーバーはそれをwebsocket接続にアップグレードしようとします。この設定は、Sailsアプリのsails.config.sockets.transports の値と一致する必要があります。 |
|
headers | io.sails.headers の値 |
このソケットからのすべてのリクエストでデフォルトで送信されるヘッダーの辞書。 .request() のheaders オプションで上書きできます。 |