append method

Future<bool> append(Object data)

Appends data to the socket.

• If data is a String, it writes the string followed by the HTTP terminal sequence.
• If data is a Stream<List<int>>, it adds the stream to the socket.
• If data is a List<int>:
  • On iOS, if the data length is greater than 100,000 bytes, it splits the data into chunks of 100,000 bytes, sending each chunk with a 10ms delay to avoid potential issues with large data writes.
  • On other platforms, it writes the entire data at once.

Returns true if the operation succeeds, otherwise logs a warning and returns false.

Implementation

Future<bool> append(Object data) async {
  try {
    if (data is String) {
      // Write string data with HTTP terminal.
      write('$data$httpTerminal');
    } else if (data is Stream<List<int>>) {
      // Add stream data to the socket.
      await addStream(data);
    } else if (data is List<int>) {
      if (Platform.isIOS) {
        // On iOS, split large data into chunks to avoid issues.
        if (data.length <= 100000) {
          add(data);
        } else {
          int startIndex = 0, endIndex = 100000;
          while (startIndex < data.length) {
            add(data.sublist(startIndex, endIndex));
            await Future.delayed(Duration(milliseconds: 10));
            startIndex = endIndex;
            endIndex += 100000;
            if (endIndex > data.length) {
              endIndex = data.length;
            }
          }
        }
      } else {
        // On other platforms, write all data at once.
        add(data);
      }
    }
    return true;
  } catch (e) {
    // Log a warning if the socket is closed or an error occurs.
    logW("Socket closed: $e, can't append data");
    return false;
  }
}