Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

window.postMessage — komunikace mezi okny

window.postMessage asynchronně odesílá data do cílového okna, a to i mezi různými originy. Doporučuje se zadat přesný `targetOrigin`; při jeho vynechání je doručení omezeno na stejný origin. Příjemce by měl ověřit origin odesílatele, odesílající okno a strukturu dat.

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

Syntaxe

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

window.postMessage je rozhraní prohlížeče definované standardem HTML Living Standard, nikoli funkce konkrétní edice ECMAScriptu. Současné prohlížečové enginy ho podporují; přítomnost Node 24 v repozitáři nedokazuje jeho dostupnost. Metodu volejte na přijímajícím okně, například iframe.contentWindow nebo referenci na otevřené okno. Odeslání zprávy neposkytuje přístup k DOM jiného originu.

Příjemce obdrží asynchronní událost message: event.data obsahuje data, event.origin obsahuje serializovaný origin odesílatele v okamžiku odeslání a event.source odkazuje na odesílající okno. Origin ve formě trojice určují schéma, hostitel a port, nikoli cesta. Neprůhledný origin takovou trojici nemá a serializuje se jako řetězec "null". Samotná kontrola tohoto řetězce nedokáže rozlišit jeden neprůhledný origin od druhého. Posluchač zaregistrujte před odesláním; u nově vytvořeného rámce se domluvte na připravenosti příjemce.

Zadejte přesný targetOrigin. Pokud se neshoduje s originem příjemce, zpráva se zahodí. Ve variantě s objektem možností má vynechaný targetOrigin výchozí hodnotu "/", která omezuje doručení na stejný origin. "*" povoluje libovolný origin — nepoužívejte ho pro důvěrná data. Příjemci by měli ověřovat event.origin, event.source a strukturu dat; se zprávami nikdy nezacházejte jako s kódem.

Data se serializují algoritmem strukturovaného klonování, nikoli jako JSON. Funkce nelze klonovat. Seznam transfer prostředky přesouvá místo kopírování: přenesený ArrayBuffer se na straně odesílatele odpojí. Neklonovatelná data nebo duplicitní položky v seznamu přenosu mohou způsobit DataCloneError. V příkladu rámec iframe izolovaný v sandboxu posílá zprávu nadřazenému oknu pomocí window.parent.postMessage. Nadřazené okno ověří, že event.origin má hodnotu "null" a event.source odkazuje na okno tohoto rámce. Poté ověří data a vypíše do konzole received: 42.

Pří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ýsledek

received: 42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje