Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

window.postMessage — komunikacija između prozora

window.postMessage asinkrono šalje podatke ciljnom prozoru, uključujući i slanje između različitih origina. Preporučuje se navesti točan `targetOrigin`; ako ga izostavite, isporuka je ograničena na isti origin. Primatelj treba provjeriti origin pošiljatelja, prozor pošiljatelja i strukturu podataka.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

targetWindow.postMessage(message, targetOrigin[, transfer])
targetWindow.postMessage(message[, { targetOrigin, transfer }])

window.postMessage API je preglednika definiran standardom HTML Living Standard, a ne značajka određenog izdanja ECMAScripta. Podržavaju ga suvremeni preglednički pogoni; prisutnost Node 24 u repozitoriju ne dokazuje da je API ondje dostupan. Pozovite metodu na prozoru primatelja, primjerice iframe.contentWindow ili referenci na otvoreni prozor. Slanje poruka ne omogućuje pristup DOM-u drugog origina.

Primatelj dobiva asinkroni događaj message: event.data sadrži podatke, event.origin sadrži serijalizirani origin pošiljatelja u trenutku slanja, a event.source upućuje na prozor pošiljatelja. Origin u obliku trojke određuju shema, host i port, a ne putanja. Neprozirni origin nema takvu trojku i serijalizira se kao niz znakova "null". Samom provjerom tog niza ne može se razlikovati jedan neprozirni origin od drugoga. Registrirajte slušatelja prije slanja; za novi okvir uskladite kada će primatelj biti spreman.

Navedite točan targetOrigin. Ako se ne podudara s originom primatelja, poruka se odbacuje. U obliku s objektom opcija, izostavljeni targetOrigin ima zadanu vrijednost "/", koja ograničava isporuku na isti origin. "*" dopušta bilo koji origin — nemojte ga upotrebljavati za povjerljive podatke. Primatelji trebaju provjeriti event.origin, event.source i strukturu podataka; poruke nikada nemojte tretirati kao kod.

Podaci se serijaliziraju algoritmom strukturiranog kloniranja, a ne kao JSON. Funkcije se ne mogu klonirati. Popis transfer premješta resurse umjesto da ih kopira: preneseni ArrayBuffer odvaja se na strani pošiljatelja. Podaci koji se ne mogu klonirati ili duplicirani unosi na popisu prijenosa mogu izazvati DataCloneError. U primjeru okvir iframe izoliran u sandboxu šalje poruku nadređenom prozoru pomoću window.parent.postMessage. Nadređeni prozor provjerava ima li event.origin vrijednost "null" i upućuje li event.source na prozor tog okvira. Zatim provjerava podatke i u konzolu ispisuje received: 42.

Primjeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Send a message from an iframe</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Message sender';
    frame.hidden = true;
    frame.setAttribute('sandbox', 'allow-scripts');

    // Use the page's exact origin when it has an HTTP(S) origin.
    // The wildcard fallback carries only the fixed, non-sensitive fixture.
    const targetOrigin = /^https?:\/\//.test(window.origin) ? window.origin : '*';

    function receive(event) {
      // The sandboxed sender has an opaque origin, serialized as "null".
      if (event.origin !== 'null' || event.source !== frame.contentWindow) return;
      const data = event.data;
      if (data === null || typeof data !== 'object' || Array.isArray(data)) return;
      if (data.type !== 'cktis-demo' || data.value !== 42) return;

      window.removeEventListener('message', receive);
      console.log(`received: ${data.value}`);
    }

    window.addEventListener('message', receive);
    frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Message sender</title></head>
<body>
  <script>
    window.parent.postMessage({ type: 'cktis-demo', value: 42 }, ${JSON.stringify(targetOrigin)});
  <\/script>
</body>
</html>`;
    document.body.append(frame);
  </script>
</body>
</html>

Rezultat

received: 42

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori