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