Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Přenos ArrayBuffer pomocí postMessage: vlastnictví a odpojení

Přenos `ArrayBuffer` pomocí `postMessage()` odpojí buffer odesílatele ještě před doručením. Bez seznamu pro přenos se bajty kopírují.

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

Syntaxe

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 běžný ArrayBuffer ve zprávě, ale ne v seznamu pro přenos, strukturované klonování zkopíruje jeho bajty a odesílatel může svůj buffer dál používat. Zařazením do seznamu se vlastnictví podkladové paměti přenese, nikoli sdílí. Po úspěšném přenosu je buffer odesílatele odpojený už při návratu z volání. Pokud zpráva dorazí, příjemce dostane při pozdější události message v event.data nový objekt bufferu s původními bajty. Odpojení nepotvrzuje doručení.

Vlož stejný buffer do zprávy, například { buffer }, i do seznamu pro přenos [buffer]. Samotné uvedení v seznamu může buffer odpojit, aniž by byl dostupný v datech zprávy. Uint8Array nebo DataView lze klonovat, ale nelze je přímo vložit do seznamu pro přenos. Použij view.buffer: přenese se celý podkladový buffer, nejen rozsah pohledu.

Odpojení nesmaže objekt ani odkazy na něj. buffer.byteLength i vlastnost byteLength existujících typovaných polí nad tímto bufferem vracejí 0. Čtení byteLength u DataView nad stejným bufferem ale vyvolá TypeError. Samotná délka 0 odpojení nedokazuje: i neodpojený buffer může být prázdný. Pokud prostředí podporuje getter ArrayBuffer.prototype.detached z ECMAScriptu 2024, zkontroluj buffer.detached.

Duplicitní či už odpojený buffer, pohled nebo SharedArrayBuffer v seznamu pro přenos nebo neklonovatelná hodnota ve zprávě, například funkce, mohou synchronně vyvolat výjimku DOMException s názvem DataCloneError. Pokud lze SharedArrayBuffer odeslat, paměť se sdílí a její vlastnictví se nepřenáší.

Worker, MessagePort a globální kontext vyhrazeného workeru přijímají za zprávou seznam nebo možnosti { transfer }. U okna uveď targetOrigin před seznamem, nebo použij { targetOrigin, transfer }. Výchozí "/" znamená původ odesílatele. Pokud cílový původ znáš, uveď jej přesně místo "*". Při příjmu ověř event.origin, podle potřeby event.source a platnost dat. postMessage() je API webové platformy, nikoli součást ECMAScriptu; podpora se liší podle běhového prostředí.

Příklady

(() => {
  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}`);
})();

Výsledek

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

Spusť kód ve vývojářské konzoli prohlížeče. Oba porty fungují na stejné stránce, bez workeru. Očekávej nejdřív dva řádky od odesílatele a potom řádek od příjemce se třemi nezměněnými bajty.

Související lekce

  • JavaScript · Lekce 5 · Pokročilá · Verze: 4

Zdroje