Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Prenos ArrayBuffer pomocou postMessage: vlastníctvo a odpojenie

Prenos `ArrayBuffer` pomocou `postMessage()` odpojí buffer odosielateľa ešte pred doručením. Bez zoznamu na prenos sa bajty skopírujú.

Verzia: 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] })

Ak je bežný ArrayBuffer v správe, ale nie v zozname na prenos, štruktúrované klonovanie skopíruje jeho bajty a odosielateľ môže svoj buffer ďalej používať. Zaradením do zoznamu sa vlastníctvo podkladovej pamäte prenesie namiesto toho, aby sa pamäť zdieľala. Po úspešnom prenose je buffer odosielateľa odpojený už pri návrate z volania. Ak správa dorazí, príjemca dostane v event.data nový objekt buffera s pôvodnými bajtmi pri neskoršej udalosti message. Odpojenie nepotvrdzuje doručenie.

Vlož ten istý buffer do správy, napríklad { buffer }, aj do zoznamu na prenos [buffer]. Samotné uvedenie v zozname môže buffer odpojiť bez toho, aby bol dostupný v údajoch správy. Uint8Array alebo DataView možno klonovať, no nemožno ich priamo vložiť do zoznamu na prenos. Použi view.buffer: prenesie sa celý podkladový buffer, nielen rozsah pohľadu.

Odpojenie nevymaže objekt ani odkazy naň. buffer.byteLength a vlastnosť byteLength existujúcich typovaných polí nad týmto bufferom vracajú 0. Čítanie byteLength z DataView nad týmto bufferom však vyvolá TypeError. Samotná dĺžka 0 odpojenie nedokazuje: aj neodpojený buffer môže byť prázdny. Ak prostredie podporuje getter ArrayBuffer.prototype.detached z ECMAScriptu 2024, skontroluj buffer.detached.

Duplicitný či už odpojený buffer, pohľad alebo SharedArrayBuffer v zozname na prenos, prípadne neklonovateľná hodnota v správe, napríklad funkcia, môžu synchrónne vyvolať výnimku DOMException s názvom DataCloneError. Ak je odoslanie SharedArrayBuffer povolené, pamäť sa zdieľa a jej vlastníctvo sa neprenáša.

Worker, MessagePort a globálny kontext vyhradeného workera prijímajú za správou zoznam alebo možnosti { transfer }. Pri okne uveď targetOrigin pred zoznamom alebo použi { targetOrigin, transfer }. Predvolené "/" označuje pôvod odosielateľa. Ak poznáš cieľový pôvod, uveď ho presne namiesto "*". Pri príjme over event.origin, podľa potreby event.source a platnosť údajov. postMessage() je API webovej platformy, nie súčasť ECMAScriptu; podpora sa líši podľa prostredia vykonávania.

Prí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ýsledok

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

Spusť kód vo vývojárskej konzole prehliadača. Oba porty fungujú na tej istej stránke, bez workera. Najprv očakávaj dva riadky od odosielateľa a potom riadok od príjemcu s tromi nezmenenými bajtmi.

Súvisiace lekcie

  • JavaScript · Lekcia 5 · Pokročilá · Verzia: 4

Zdroje