CKTIS / JavaScript
Przekazywanie ArrayBuffer przez postMessage: własność i odłączenie
Przekazanie `ArrayBuffer` przez `postMessage()` odłącza bufor nadawcy, zanim odbiorca otrzyma komunikat. Bez listy transferu bajty są kopiowane.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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] })Jeśli zwykły ArrayBuffer jest częścią komunikatu, ale nie ma go na liście transferu, klonowanie strukturalne kopiuje jego bajty, a nadawca nadal może używać swojego bufora. Dodanie bufora do listy przekazuje własność pamięci zamiast ją współdzielić. Po udanym transferze bufor nadawcy jest odłączony już w chwili powrotu z wywołania. Jeśli komunikat dotrze, odbiorca dostanie nowy obiekt bufora z pierwotnymi bajtami w event.data podczas późniejszego zdarzenia message. Odłączenie nie potwierdza dostarczenia.
Umieść ten sam bufor w komunikacie, np. { buffer }, i na liście transferu [buffer]. Sama lista może odłączyć bufor, ale nie udostępnia go w danych komunikatu. Uint8Array i DataView można klonować, lecz nie można ich przekazywać na liście transferu. Użyj view.buffer: przekazujesz cały bufor, a nie tylko zakres widoku.
Odłączenie nie usuwa obiektu ani odwołań do niego. buffer.byteLength i byteLength istniejących tablic typowanych opartych na tym buforze zwracają 0, natomiast odczyt byteLength z takiego DataView zgłasza TypeError. Samo 0 nie rozstrzyga, czy bufor jest odłączony: aktywny bufor też może być pusty. W środowiskach obsługujących getter ArrayBuffer.prototype.detached z ECMAScript 2024 sprawdź buffer.detached.
Powtórzenie bufora na liście, próba przekazania już odłączonego bufora, wpisanie widoku lub SharedArrayBuffer na listę, a także nieklonowalna wartość, np. funkcja w komunikacie, mogą spowodować synchroniczny wyjątek DataCloneError typu DOMException. SharedArrayBuffer, jeśli przesłanie go jest dozwolone, udostępnia wspólną pamięć zamiast przenosić jej własność.
Worker, MessagePort i globalny kontekst workera dedykowanego przyjmują po komunikacie listę lub opcje { transfer }. Dla okna użyj osobnego argumentu targetOrigin przed listą albo opcji { targetOrigin, transfer }. Domyślne "/" oznacza origin nadawcy. Jeśli znasz origin odbiorcy, podaj go dokładnie zamiast "*"; przy odbiorze sprawdź event.origin, w razie potrzeby event.source, oraz poprawność danych. postMessage() należy do platformy webowej, nie do ECMAScript; obsługa zależy od środowiska.
Przykłady
(() => {
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}`);
})();Wynik
before: buffer=3, view=3 after: buffer=0, view=0 received: 3 bytes (7, 42, 255)
Uruchom w konsoli deweloperskiej przeglądarki. Oba porty działają na tej samej stronie, bez workera. Oczekiwane są najpierw dwa wpisy nadawcy, a potem wpis odbiorcy z trzema niezmienionymi bajtami.
Powiązane lekcje
- JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4
Źródła
- 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