Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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