WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ArrayBuffer mit postMessage übertragen: Besitz und Abtrennung

Beim Übertragen eines `ArrayBuffer` mit `postMessage()` wird der Puffer des Senders vor der Zustellung abgetrennt. Ohne Transferliste werden die Bytes kopiert.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

worker.postMessage(message)
worker.postMessage(message, [buffer])
worker.postMessage(message, { transfer: [buffer] })
self.postMessage(message, [buffer]) // Dedicated worker global scope
port.postMessage(message, [buffer])
port.postMessage(message, { transfer: [buffer] })
targetWindow.postMessage(message, targetOrigin, [buffer])
targetWindow.postMessage(message, { targetOrigin, transfer: [buffer] })

Steht ein gewöhnlicher ArrayBuffer in der Nachricht, aber nicht in der Transferliste, kopiert der strukturierte Klonalgorithmus seine Bytes; der Sender kann seinen Puffer weiterverwenden. Ein Eintrag in der Liste überträgt den zugrunde liegenden Speicher, statt ihn gemeinsam zu nutzen. Bei erfolgreicher Übertragung ist der Puffer des Senders bereits abgetrennt, wenn der Aufruf zurückkehrt. Kommt die Nachricht an, erhält der Empfänger bei einem späteren message-Ereignis in event.data ein neues Pufferobjekt mit den ursprünglichen Bytes. Die Abtrennung bestätigt keine Zustellung.

Gib denselben Puffer sowohl in der Nachricht, etwa { buffer }, als auch in der Transferliste [buffer] an. Die Liste allein kann den Puffer abtrennen, ohne ihn über die Nachrichtendaten zugänglich zu machen. Uint8Array und DataView sind klonbar, gehören aber selbst nicht in die Transferliste. Verwende view.buffer: Damit überträgst du den ganzen Puffer, nicht nur den von der Sicht abgedeckten Bereich.

Die Abtrennung löscht weder das Objekt noch Verweise darauf. buffer.byteLength und byteLength bestehender typisierter Arrays auf diesem Puffer liefern 0; der Zugriff auf byteLength einer solchen DataView löst dagegen TypeError aus. 0 allein beweist keine Abtrennung, denn auch ein nicht abgetrennter Puffer kann leer sein. Falls der Getter ArrayBuffer.prototype.detached aus ECMAScript 2024 verfügbar ist, prüfe buffer.detached.

Ein doppelter oder bereits abgetrennter Puffer, eine Sicht oder ein SharedArrayBuffer in der Transferliste sowie ein nicht klonbarer Nachrichtenwert wie eine Funktion können synchron eine DOMException namens DataCloneError auslösen. Soweit das Senden eines SharedArrayBuffer zulässig ist, wird sein Speicher gemeinsam genutzt, nicht übertragen.

Worker, MessagePort und der globale Kontext eines dedizierten Workers akzeptieren nach der Nachricht eine Liste oder Optionen als { transfer }. Bei einem Fenster gibst du targetOrigin vor der Liste an oder verwendest { targetOrigin, transfer }. Der Standardwert "/" steht für den Origin des Senders. Gib einen bekannten Ziel-Origin exakt an, statt "*" zu verwenden. Prüfe beim Empfang event.origin, gegebenenfalls event.source und die Gültigkeit der Daten. postMessage() ist eine Webplattform-API, kein Teil von ECMAScript; die Unterstützung hängt von der Laufzeitumgebung ab.

Beispiele

(() => {
  const { port1, port2 } = new MessageChannel();
  const view = new Uint8Array([7, 42, 255]);
  const buffer = view.buffer;

  port2.onmessage = ({ data }) => {
    const bytes = new Uint8Array(data.buffer);
    console.log(`received: ${bytes.byteLength} bytes (${bytes.join(', ')})`);
    port1.close();
    port2.close();
  };

  console.log(`before: buffer=${buffer.byteLength}, view=${view.byteLength}`);
  port1.postMessage({ buffer }, [buffer]);
  console.log(`after: buffer=${buffer.byteLength}, view=${view.byteLength}`);
})();

Ergebnis

before: buffer=3, view=3
after: buffer=0, view=0
received: 3 bytes (7, 42, 255)

Führe den Code in der Entwicklerkonsole eines Browsers aus. Beide Ports laufen auf derselben Seite, ohne Worker. Erwartet werden zuerst die beiden Ausgaben des Senders, dann die Ausgabe des Empfängers mit den drei unveränderten Bytes.

Zugehörige Lektionen

  • JavaScript · Lektion 5 · Fortgeschritten · Version: 4

Quellen