CKTIS / JavaScript
Prijenos ArrayBuffera metodom postMessage: vlasništvo i odvajanje
Prijenos `ArrayBuffer` objekta metodom `postMessage()` odvaja međuspremnik pošiljatelja prije isporuke. Bez popisa za prijenos bajtovi se kopiraju.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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] })Ako je obični ArrayBuffer u poruci, ali ne i na popisu za prijenos, strukturirano kloniranje kopira njegove bajtove, a pošiljatelj može nastaviti upotrebljavati svoj međuspremnik. Uvrštavanje na popis prenosi vlasništvo nad memorijom umjesto da je dijeli. Ako prijenos uspije, međuspremnik pošiljatelja odvojen je već pri povratku iz poziva. Ako poruka stigne, primatelj dobiva novi objekt međuspremnika s izvornim bajtovima u event.data pri kasnijem događaju message. Odvajanje ne potvrđuje isporuku.
Isti međuspremnik stavi u poruku, primjerice { buffer }, i na popis za prijenos [buffer]. Samo navođenje na popisu može ga odvojiti, a da ne postane dostupan u podacima poruke. Uint8Array ili DataView može se klonirati, ali se ne može izravno staviti na popis za prijenos. Upotrijebi view.buffer: prenosi se cijeli međuspremnik, a ne samo raspon pogleda.
Odvajanje ne briše objekt ni reference na njega. buffer.byteLength i svojstvo byteLength postojećih tipiziranih polja koja koriste taj međuspremnik vraćaju 0, no čitanje byteLength na objektu DataView koji ga koristi izaziva TypeError. Sama vrijednost 0 ne dokazuje odvajanje: i neodvojeni međuspremnik može biti prazan. Ako je dostupan getter ArrayBuffer.prototype.detached iz ECMAScripta 2024, provjeri buffer.detached.
Ponovljen ili već odvojen međuspremnik, pogled ili SharedArrayBuffer na popisu za prijenos, ili vrijednost u poruci koja se ne može klonirati, kao što je funkcija, mogu sinkrono izazvati iznimku DOMException naziva DataCloneError. Ako je dopušteno poslati SharedArrayBuffer, memorija se dijeli umjesto da se prenosi vlasništvo nad njom.
Worker, MessagePort i globalni kontekst namjenskog workera nakon poruke prihvaćaju popis ili opcije { transfer }. Za prozor navedi targetOrigin prije popisa ili upotrijebi { targetOrigin, transfer }. Zadana vrijednost "/" označava podrijetlo pošiljatelja. Ako znaš podrijetlo odredišta, navedi ga točno umjesto "*". Pri primitku provjeri event.origin, prema potrebi event.source, i valjanost podataka. postMessage() je API web-platforme, a ne dio ECMAScripta; podrška ovisi o izvršnom okruženju.
Primjeri
(() => {
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}`);
})();Rezultat
before: buffer=3, view=3 after: buffer=0, view=0 received: 3 bytes (7, 42, 255)
Pokreni kôd u razvojnoj konzoli preglednika. Oba porta rade na istoj stranici, bez workera. Očekuj prvo dva retka pošiljatelja, a zatim redak primatelja s trima nepromijenjenim bajtovima.
Povezane lekcije
- JavaScript · Lekcija 5 · Napredno · Verzija: 4
Izvori
- 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