
发送 PostMessage 操作
Send PostMessage 操作通过浏览器的 postMessage API 将消息从您正在运行的 Labvanced 实验发送到外部目标,例如父网页、自定义应用程序或嵌入框架。
概述
此操作在操作选择菜单中列为 API Actions。

常见用例
- 通知父应用程序(例如,LMS 或机构门户)当参与者达到某一特定点或完成任务时。
- 实时将变量值(例如分数、响应或条件标签)传递到外部系统。
双边设置
在 Labvanced 和外部页面(例如 iFrame 或父应用程序)之间使用 postMessage 是一个 双边过程。Labvanced 处理一侧:此操作发送消息。另一侧是外部页面,必须被编程以接收它。
postMessage API 是标准的浏览器功能。外部页面需要一个 window.addEventListener('message', handler) 侦听器来接收来自 Labvanced 的消息。该侦听器还应按域进行过滤,检查消息来源是否为 Labvanced,以便仅对来自受信任来源的消息采取行动。您或您的开发者需要编写该代码。如果需要,AI 编码工具可以帮助快速生成它。
工作原理
当此操作触发时,Labvanced 向目标窗口发送一个 postMessage。该消息会传递给任何在 Destination Domain 上以 window.addEventListener('message', handler) 进行侦听的页面。
消息有效载荷包含 Value to send。如果设置了 Key,它将包含在有效载荷中,以便接收端可以标识消息类型并相应处理。
外部页面负责处理消息。其侦听器在对其采取行动之前应检查消息来源,以确保它仅对从 Labvanced 发送的消息做出响应。
选择 Send PostMessage 后,会显示以下配置:

操作选项
| 菜单项 | 发送 PostMessage 操作选项 |
|---|---|
Destination Domain | 指定应接收消息的目标来源。默认值为 *,它会发送到任何来源。当目标已知时,将 * 替换为完整的目标 URL(例如 https://yoursite.com)。建议为安全指定确切域。 |
Key | 附加一个标识符键到发送的消息。它将消息有效载荷结构化为 Key: value,接收方可以使用它来区分不同类型的消息。如果不需要键,则留空。 |
Value to send | 定义要包含在发送消息中的数据。单击编辑图标以打开 Value-Select Menu 并指定要发送的内容:常量值、Labvanced 变量或表达式。 |
注意: 接收消息的系统(父页面或外部应用程序)必须实现 window.addEventListener('message', ...) 侦听器以处理来自 Labvanced 的传入 postMessage。