Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

window.postMessage — komunikácia medzi oknami

window.postMessage asynchrónne odosiela údaje do cieľového okna, a to aj medzi rôznymi originmi. Odporúča sa zadať presný `targetOrigin`; ak sa vynechá, doručenie sa obmedzí na rovnaký origin. Príjemca by mal overiť origin odosielateľa, odosielajúce okno a štruktúru údajov.

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

Syntax

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

window.postMessage je rozhranie prehliadača definované štandardom HTML Living Standard, nie funkcia konkrétneho vydania ECMAScriptu. Súčasné prehliadačové enginy ho podporujú; prítomnosť Node 24 v repozitári nedokazuje jeho dostupnosť. Metódu volajte na prijímajúcom okne, napríklad iframe.contentWindow alebo referencii na otvorené okno. Odoslanie správy neposkytuje prístup k DOM iného originu.

Príjemca dostane asynchrónnu udalosť message: event.data obsahuje údaje, event.origin obsahuje serializovaný origin odosielateľa v čase odoslania a event.source odkazuje na odosielajúce okno. Origin vo forme trojice určujú schéma, hostiteľ a port, nie cesta. Nepriehľadný origin takúto trojicu nemá a serializuje sa ako reťazec "null". Samotná kontrola tohto reťazca neumožňuje rozlíšiť jeden nepriehľadný origin od druhého. Poslucháča zaregistrujte pred odoslaním; pri novom rámci sa dohodnite na pripravenosti príjemcu.

Zadajte presný targetOrigin. Ak sa nezhoduje s originom príjemcu, správa sa zahodí. Vo variante s objektom možností má vynechaný targetOrigin predvolenú hodnotu "/", ktorá obmedzuje doručenie na rovnaký origin. "*" povoľuje ľubovoľný origin — nepoužívajte ho pre dôverné údaje. Príjemcovia by mali overovať event.origin, event.source a štruktúru údajov; so správami nikdy nezaobchádzajte ako s kódom.

Údaje sa serializujú algoritmom štruktúrovaného klonovania, nie ako JSON. Funkcie sa nedajú klonovať. Zoznam transfer presúva prostriedky namiesto ich kopírovania: prenesený ArrayBuffer sa na strane odosielateľa odpojí. Neklonovateľné údaje alebo duplicitné položky v zozname prenosu môžu spôsobiť DataCloneError. V príklade rámec iframe izolovaný v sandboxe posiela správu nadradenému oknu pomocou window.parent.postMessage. Nadradené okno overí, či má event.origin hodnotu "null" a či event.source odkazuje na okno tohto rámca. Potom overí údaje a vypíše do konzoly received: 42.

Príklady

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

Výsledok

received: 42

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje