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
- HTML Standard — Safe passing of structured data
- HTML Standard — StructuredSerializeWithTransfer (value, transferList)
- HTML Standard — Cross-document messaging
- HTML Standard — Channel messaging
- HTML Standard — Dedicated workers and the Worker interface
- ECMAScript 2024 Language Specification — Properties of the ArrayBuffer Prototype Object
- ECMAScript 2024 Language Specification — get DataView.prototype.byteLength
- ECMAScript 2024 Language Specification — Properties of the %TypedArray% Prototype Object