
Send PostMessage Aktion
Die Send PostMessage Aktion sendet eine Nachricht von Ihrem laufenden Labvanced-Experiment an ein externes Ziel, wie eine übergeordnete Webseite, eine benutzerdefinierte Anwendung oder einen eingebetteten Rahmen, unter Verwendung der postMessage-API des Browsers.
Inhaltsverzeichnis
Überblick
Diese Aktion ist unter API Actions im Aktionsauswahlmenü aufgeführt.

Häufige Anwendungsfälle
- Benachrichtigung einer übergeordneten Anwendung (z. B. eines LMS oder institutionellen Portals), wenn ein Teilnehmer einen bestimmten Punkt erreicht oder eine Aufgabe abschließt.
- Weitergabe eines Variablenwerts, wie z. B. einer Punktzahl, einer Antwort oder eines Bedingungslabels, an ein externes System in Echtzeit.
Das zweiseitige Setup
Die Verwendung von postMessage zwischen Labvanced und einer externen Seite (z. B. einem iFrame oder einer übergeordneten Anwendung) ist ein zweiseitiger Prozess. Labvanced übernimmt eine Seite: diese Aktion sendet die Nachricht. Die andere Seite ist die externe Seite, die programmiert werden muss, um sie zu empfangen.
Die postMessage-API ist ein Standardbrowsermerkmal. Die externe Seite benötigt einen window.addEventListener('message', handler)-Listener, um Nachrichten von Labvanced zu empfangen. Dieser Listener sollte auch nach Domain filtern und sicherstellen, dass der Nachrichtenursprung Labvanced ist, damit nur auf Nachrichten von einer vertrauenswürdigen Quelle reagiert wird. Sie oder Ihr Entwickler müssen diesen Code schreiben. Ein KI-Coding-Tool kann helfen, ihn schnell zu generieren, falls notwendig.
Wie es funktioniert
Wenn diese Aktion ausgelöst wird, sendet Labvanced eine postMessage an das Ziel-Fenster. Die Nachricht wird an jede Seite an der Destination Domain zugestellt, die mit einem window.addEventListener('message', handler) hört.
Die Nachricht trägt die Value to send. Wenn ein Key festgelegt ist, wird er im Payload enthalten, damit die empfangende Seite den Nachrichtentyp erkennen und entsprechend darauf reagieren kann.
Die externe Seite ist verantwortlich für die Verarbeitung der Nachricht. Ihr Listener sollte den Nachrichtenursprung überprüfen, bevor er darauf reagiert, um sicherzustellen, dass nur auf Nachrichten reagiert wird, die von Labvanced gesendet wurden.
Nach Auswahl von Send PostMessage erscheint die folgende Konfiguration:

Aktionsoptionen
| Menüpunkt | Optionen für die Send PostMessage Aktion |
|---|---|
Destination Domain | Gibt den Zielursprung an, der die Nachricht erhalten soll. Der Standardwert ist *, der an jeden Ursprung sendet. Ersetzen Sie * durch die vollständige Ziel-URL (z. B. https://yoursite.com), wenn das Ziel bekannt ist. Es wird empfohlen, die genaue Domain aus Sicherheitsgründen anzugeben. |
Key | Fügt der ausgehenden Nachricht einen Identifikationsschlüssel hinzu. Dies strukturiert den NachrichtPayload als Key: value, den die empfangende Seite verwenden kann, um verschiedene Arten von Nachrichten zu unterscheiden. Leer lassen, wenn kein Schlüssel benötigt wird. |
Value to send | Definiert die Daten, die in der ausgehenden Nachricht enthalten sein sollen. Klicken Sie auf das Bearbeitungssymbol, um das Value-Select Menu zu öffnen und anzugeben, was gesendet werden soll: ein fester Wert, eine Labvanced-Variable oder ein Ausdruck. |
Hinweis: Das System, das die Nachricht empfängt (die übergeordnete Seite oder externe Anwendung), muss einen window.addEventListener('message', ...)-Listener implementieren, um die eingehende postMessage von Labvanced zu verarbeiten.
Weiterführende Literatur
PostMessage Received Trigger
Der gekoppelte Trigger zum Anhören eingehender postMessages von externen Quellen.
Wertauswahlmenü
Wie man definiert, welchen Wert man durch Variablen, Konstanten oder Ausdrücke senden möchte.
Labvanced Web Bridge Extension
Kontext, wie postMessage für die Kommunikation mit eingebetteten externen Websites verwendet wird.