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

CKTIS / JavaScript

window.postMessage — sporočanje med okni

window.postMessage asinhrono pošlje podatke ciljnemu oknu, tudi med različnimi izvori. Priporočljivo je navesti natančen `targetOrigin`; če ga izpustite, je dostava omejena na isti izvor. Prejemnik naj preveri izvor pošiljatelja, pošiljateljevo okno in strukturo podatkov.

Različica: 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 je brskalniški API, določen s standardom HTML Living Standard, ne pa funkcija določene izdaje ECMAScripta. Podpirajo ga sodobni brskalniški pogoni; prisotnost Node 24 v repozitoriju ne dokazuje, da je API tam na voljo. Metodo pokličite na sprejemnem oknu, na primer iframe.contentWindow ali sklicu na odprto okno. Pošiljanje sporočil ne omogoča dostopa do DOM-a drugega izvora.

Prejemnik dobi asinhroni dogodek message: event.data vsebuje podatke, event.origin vsebuje serializirani izvor pošiljatelja ob pošiljanju, event.source pa se sklicuje na pošiljateljevo okno. Izvor v obliki trojice določajo shema, gostitelj in vrata, ne pa pot. Neprosojni izvor nima takšne trojice in se serializira kot niz "null". Zgolj s preverjanjem tega niza ne morete razlikovati med neprosojnimi izvori. Poslušalca registrirajte pred pošiljanjem; pri novem okvirju se dogovorite, kdaj bo prejemnik pripravljen.

Navedite natančen targetOrigin. Če se ne ujema z izvorom prejemnika, se sporočilo zavrže. V obliki z objektom možnosti ima izpuščeni targetOrigin privzeto vrednost "/", kar dostavo omeji na isti izvor. "*" dovoljuje kateri koli izvor — ne uporabljajte ga za zaupne podatke. Prejemniki naj preverijo event.origin, event.source in strukturo podatkov; sporočil nikoli ne obravnavajte kot kodo.

Podatki se serializirajo z algoritmom strukturiranega kloniranja, ne kot JSON. Funkcij ni mogoče klonirati. Seznam transfer vire premakne namesto kopiranja: preneseni ArrayBuffer se na strani pošiljatelja odklopi. Podatki, ki jih ni mogoče klonirati, ali podvojeni vnosi na seznamu za prenos lahko povzročijo DataCloneError. V primeru okvir iframe, izoliran v peskovniku, pošlje sporočilo nadrejenemu oknu z metodo window.parent.postMessage. Nadrejeno okno preveri, ali ima event.origin vrednost "null" in ali se event.source sklicuje na okno okvirja. Nato preveri podatke in v konzolo izpiše received: 42.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri