Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Prenos ArrayBuffer z metodo postMessage: lastništvo in odklop

Prenos `ArrayBuffer` z `postMessage()` odklopi medpomnilnik pošiljatelja pred dostavo. Brez seznama za prenos se bajti kopirajo.

Različica: 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] })

Če je običajni ArrayBuffer v sporočilu, ni pa na seznamu za prenos, strukturirano kloniranje kopira njegove bajte, pošiljatelj pa lahko svoj medpomnilnik še naprej uporablja. Vpis na seznam prenese lastništvo pomnilnika, namesto da bi si ga pošiljatelj in prejemnik delila. Po uspešnem prenosu je medpomnilnik pošiljatelja odklopljen že ob vrnitvi iz klica. Če sporočilo prispe, prejemnik ob poznejšem dogodku message v event.data dobi nov objekt medpomnilnika z izvirnimi bajti. Odklop ne potrjuje dostave.

Isti medpomnilnik navedi v sporočilu, na primer { buffer }, in na seznamu za prenos [buffer]. Če je naveden samo na seznamu, se lahko odklopi, ne da bi bil dostopen v podatkih sporočila. Pogled Uint8Array ali DataView lahko kloniraš, ne moreš pa ga neposredno uvrstiti na seznam za prenos. Uporabi view.buffer: prenese se celoten medpomnilnik, ne le območje pogleda.

Odklop ne izbriše objekta niti referenc nanj. buffer.byteLength in lastnost byteLength obstoječih tipiziranih polj, ki uporabljajo ta medpomnilnik, vrneta 0. Branje byteLength na objektu DataView, ki ga uporablja, pa sproži TypeError. Vrednost 0 sama ne dokazuje odklopa: tudi neodklopljen medpomnilnik je lahko prazen. Če je podprt getter ArrayBuffer.prototype.detached iz ECMAScripta 2024, preveri buffer.detached.

Podvojen ali že odklopljen medpomnilnik, pogled ali SharedArrayBuffer na seznamu za prenos oziroma vrednost v sporočilu, ki je ni mogoče klonirati, na primer funkcija, lahko sinhrono sproži izjemo DOMException z imenom DataCloneError. Kadar je pošiljanje SharedArrayBuffer dovoljeno, se pomnilnik deli, ne da bi se lastništvo preneslo.

Worker, MessagePort in globalni kontekst namenskega workerja za sporočilom sprejmejo seznam ali možnosti { transfer }. Za okno podaj targetOrigin pred seznamom ali uporabi { targetOrigin, transfer }. Privzeti "/" pomeni izvor pošiljatelja. Če ciljni izvor poznaš, ga navedi natančno, namesto da uporabiš "*". Ob prejemu preveri event.origin, po potrebi event.source in veljavnost podatkov. postMessage() je API spletne platforme in ni del ECMAScripta; podpora je odvisna od izvajalnega okolja.

Primeri

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

Kodo zaženi v razvijalski konzoli brskalnika. Obe vrati delujeta na isti strani, brez workerja. Najprej pričakuj dve vrstici pošiljatelja, nato vrstico prejemnika s tremi nespremenjenimi bajti.

Povezane lekcije

  • JavaScript · Lekcija 5 · Napredna · Različica: 4

Viri