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
- 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