Edge 扩展模块中的上下文

Edge 扩展中的所有库模块在执行时，都会获得一个 context 对象。本文档介绍了 context 对象提供的属性，以及些属性在库模块中发挥的作用。

Adobe 请求上下文 (arc)

arc 属性作为一个对象，提供了关于触发规则的事件的信息。以下各部分介绍了此对象中包含的各种子属性。

event

event 对象表示触发规则的事件。event 包含单个属性，rule 本身则包含以下值：

logger.log(context.arc.event);

request

不要与客户端设备的请求混淆，request 是来自 Adobe Experience Platform Edge Network 的稍作修改的对象。

logger.log(context.arc.request)

request 对象有两个顶级属性：body 和 head。body 属性包含体验数据模型 (XDM) 信息，当您导航到 Launch 并选择 Edge Trace 选项卡时，可在 Adobe Experience Platform Debugger 中检查该属性。

ruleStash

ruleStash 是一个对象，将从操作模块中收集所有结果。

logger.log(context.arc.ruleStash);

每个扩展都有自己的命名空间。例如，如果您将扩展命名为 send-beacon，则 send-beacon 操作的所有结果都将存储在 ruleStash['send-beacon'] 命名空间中。

每个扩展的命名空间都是唯一的，并且开头的值为 undefined。

从每个操作中返回的结果将会覆盖命名空间。例如，假定一个 transform 扩展中包含两个操作：generate-fullname 和 generate-fulladdress。则这两个操作随后会添加到规则中。

如果 generate-fullname 操作的结果为 Firstname Lastname，则完成该操作后的规则存储将如下所示：

{
  transform: 'Firstname Lastname'
}

如果 generate-address 操作的结果为 3900 Adobe Way，则完成该操作后的规则存储将如下所示：

{
  transform: '3900 Adobe Way'
}

请注意，“Firstname Lastname”不再存在于规则存储中，因为 generate-address 操作会用新值将其覆盖。

如果您想让 ruleStash 在 transform 命名空间内存储这两个操作的结果，您可以编写类似于以下示例的操作模块：

module.exports = (context) => {
  let transformRuleStash = context.arc.ruleStash.transform;

  if (!transformRuleStash) {
    transformRuleStash = {};
  }

  transformRuleStash.fullName = 'Firstname Lastname';

  return transformRuleStash;
}

首次执行此操作时，由于 ruleStash 开始于 undefined，因此将其初始化为一个空对象。下次执行该操作时，将会收到先前调用该操作时所返回的 ruleStash。通过将对象用作 ruleStash，您可以添加新数据，而不会丢失先前由扩展中的其他操作设置的数据。

使用此策略时，必须注意要始终返回完整的扩展规则存储。如果只返回了一个值，它将覆盖您可能已设置的任何其他属性。

实用工具

utils 属性表示一个提供了特定于 Platform Launch 运行时的实用程序的对象。

logger

通过 logger 实用程序，您可以记录在使用 Adobe Experience Cloud Debugger 调试会话期间显示的消息。

context.utils.logger.error('Error!');

该日志记录器包括以下方法，其中 message 是您要记录的消息：

fetch

该实用程序将实施 Fetch API。您可以使用该函数向第三方端点发送请求。

context.utils.fetch('http://example.com/movies.json')
  .then(response => response.json())

getBuildInfo

该实用程序返回了一个对象，其中包含有关构建当前 Platform Launch 运行时库的信息。

logger.log(context.utils.getBuildInfo().turbineBuildDate);

该对象包含以下值：

以下是一个示例 getBuildInfo 对象，用于演示它返回的值：

{
  turbineVersion: "1.0.0",
  turbineBuildDate: "2016-07-01T18:10:34Z",
  buildDate: "2016-03-30T16:27:10Z",
  environment: "development"
}

getExtensionSettings

该实用程序返回了上次从扩展配置视图中保存的 settings 对象。

logger.log(context.utils.getExtensionSettings());

getSettings

该实用程序返回了上次从相应的库模块视图中保存的 settings 对象。

logger.log(context.utils.getSettings());

getRule

该实用程序返回了一个对象，其中包含有关触发模块的规则的信息。

logger.log(context.utils.getRule());

该对象将包含以下值：