Web 拡張機能の条件のタイプ

条件タイプライブラリモジュールの目的は、何が true か false かを評価することです。何を評価するかは、自由に設定できます。

メモ

このドキュメントでは、Web 拡張機能の条件のタイプについて説明します。エッジ拡張機能を開発する場合は、代わりにエッジ拡張機能の条件のタイプに関するガイドを参照してください。

このドキュメントは、ライブラリモジュールと、それらが Platform Launch の拡張機能に統合される仕組みについても精通していることを前提としています。説明が必要な場合は、このガイドに戻る前に、ライブラリモジュールの形式の概要を参照してください。

例えば、ユーザーが example.com ホスト上にいるかどうかを評価したい場合、モジュールは次のようになります。

module.exports = function(settings) {
  return document.location.hostname === 'example.com';
};

次に、Adobe Experience Platform Launch ユーザーがホスト名を設定できるようにする場合を考えてみましょう。 ユーザーがホスト名を入力し、そのホスト名を設定オブジェクトに保存できるようにします。オブジェクトは次のようになります。

{
  "hostname": "example.com"
}

ユーザー定義のホスト名を操作するには、モジュールを次のように変更する必要があります。

module.exports = function(settings) {
  return document.location.hostname === settings.hostname;
};

コンテキストイベントデータ

2 つ目の引数は、ルールを起動したイベントに関するコンテキスト情報を含むモジュールに渡されます。 これは状況によってはメリットがあり、次のように指定することで実現できます。

module.exports = function(settings, event) {
  // event contains information regarding the event that fired the rule
};

event オブジェクトには次のプロパティが含まれている必要があります。

プロパティ 説明
$type 拡張機能名とイベント名を表す文字列(ピリオドを使用して結合)。例:youtube.play
$rule 現在実行中のルールに関する情報を含むオブジェクト。 オブジェクトには、次のサブプロパティが含まれている必要があります。
  • id:現在実行中のルールの ID。
  • name:現在実行中のルールの名前。

ルールをトリガーしたイベントタイプを提供する拡張機能では、必要に応じて、その他の役に立つ情報をこの event オブジェクトに追加できます。

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now