RTCSctpTransport: maxMessageSize-Eigenschaft

Baseline 2023

Newly available

Since May 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die schreibgeschützte Eigenschaft maxMessageSize des RTCSctpTransport-Interfaces gibt die maximale Größe einer Nachricht an, die mit der RTCDataChannel.send()-Methode gesendet werden kann.

Wert

Ein Ganzzahlwert, der die maximale Größe in Bytes angibt, einer Nachricht, die mit der RTCDataChannel.send()-Methode gesendet werden kann.

Beispiele

Dieses Beispiel zeigt, wie Sie eine Zeichenfolge in kleine Teile aufteilen können, um sie basierend auf der maximalen Nachrichtenlänge zu senden.

js
// Function splits strings to a specified size and returns array.
function splitStringToMax(str, maxLength) {
  const result = [];
  let i = 0;
  while (i < str.length) {
    result.push(str.substring(i, i + maxLength));
    i += maxLength;
  }
  return result;
}

const peerConnection = new RTCPeerConnection(options);
const channel = peerConnection.createDataChannel("chat");
channel.onopen = (event) => {
  const maximumMessageSize = peerConnection.sctp.maxMessageSize;
  const textToSend = "This is my possibly overly long string!";
  splitStringToMax(textToSend, maximumMessageSize).forEach((elem) => {
    channel.send(elem);
  });
};

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcsctptransport-maxmessagesize

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch