dart:io

Метод connect

Создаёт новое соединение сокета с указанным хостом и портом и возвращает Future, который завершится либо значением Socket при успешном подключении, либо ошибкой, если поиск хоста или установление соединения завершились неудачно.

host может быть либо строкой String, либо адресом интернета InternetAddress. Если host является строкой String, метод connect выполнит поиск адреса интернета InternetAddress.lookup и попробует подключиться ко всем полученным адресам InternetAddress, пока не будет установлено соединение. В случае неудачи возвращается ошибка первого соединения, которое не удалось установить.

Аргумент sourceAddress может быть использован для указания локального адреса для привязки при установлении соединения. sourceAddress может быть либо строкой String, либо адресом интернета InternetAddress. Если передаётся строка String, она должна содержать числовой IP-адрес.

Аргумент sourcePort определяет локальный порт для привязки. Если sourcePort не указан или равен нулю, будет выбран порт.

Аргумент timeout используется для указания максимального допустимого времени ожидания установления соединения. Если timeout превышает системный предел времени ожидания, таймаут может произойти раньше, чем указано в timeout. При таймауте выбрасывается исключение SocketException, и все текущие попытки соединения с host отменяются.

Реализация

static Future<Socket> connect(host, int port,
    {sourceAddress, int sourcePort = 0, Duration? timeout}) {
  final IOOverrides? overrides = IOOverrides.current;
  if (overrides == null) {
    return Socket._connect(host, port,
        sourceAddress: sourceAddress,
        sourcePort: sourcePort,
        timeout: timeout);
  }
  return overrides.socketConnect(host, port,
      sourceAddress: sourceAddress, sourcePort: sourcePort, timeout: timeout);
}