ContextHub JavaScript API リファレンス contexthub-javascript-api-reference

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

ContextHub コンポーネントをページに追加すると、ContextHub JavaScript API がスクリプトで使用できるようになります。

ContextHub 定数 contexthub-constants

ContextHub JavaScript API によって定義される定数値です。

イベント定数 event-constants

次の表に、ContextHub ストアに対して発生する名前イベントを示します。 関連トピック ContextHub.Utils.Eventing.

定数
説明
ContextHub.Constants.EVENT_NAMESPACE
ContextHub のイベント名前空間
ch
ContextHub.Constants.EVENT_ALL_STORES_READY
必要なすべてのストアが登録、初期化され、使用可能な状態であることを示します
all-stores-ready
ContextHub.Constants.EVENT_STORES_PARTIALLY_READY
指定されたタイムアウト内に一部のストアが初期化されなかったことを示します
stores-partially-ready
ContextHub.Constants.EVENT_STORE_REGISTERED
ストアの登録時に実行されます
store-registered
ContextHub.Constants.EVENT_STORE_READY
ストアの動作準備ができていることを示します。データが取得されると実行される JSONP ストアを除いて、登録後すぐにトリガーされます。
store-ready
ContextHub.Constants.EVENT_STORE_UPDATED
ストアが永続性を更新した場合に実行されます
store-updated
ContextHub.Constants.PERSISTENCE_CONTAINER_NAME
永続コンテナ名
ContextHubPersistence
ContextHub.Constants.SERVICE_RAW_RESPONSE_KEY
未加工の JSON 結果が格納される特定の永続キー名を格納します
/_/raw-response
ContextHub.Constants.SERVICE_RESPONSE_TIME_KEY
JSON データがフェッチされた日時を示す特定のタイムスタンプを格納します
/_/response-time
ContextHub.Constants.SERVICE_LAST_URL_KEY
前回の呼び出しで使用された JSON サービスの特定の URL を格納
/_/URL
ContextHub.Constants.IS_CONTAINER_EXPANDED
ContextHub の UI が展開されているかどうかを示します
/_/container-expanded

UI イベント定数 ui-event-constants

次の表に、ContextHub UI に関して発生するイベントの名前を示します。

定数
説明
ContextHub.Constants.EVENT_UI_MODE_REGISTERED
モードが登録されると実行されます
ui-mode-registered
ContextHub.Constants.EVENT_UI_MODE_UNREGISTERED
モードが未登録の場合に実行されます
ui-mode-unregistered
ContextHub.Constants.EVENT_UI_MODE_RENDERER_REGISTERED
モードレンダラーが登録されると実行されます
ui-mode-renderer-registered
ContextHub.Constants.EVENT_UI_MODE_RENDERER_UNREGISTERED
モードレンダラーの登録が解除されると実行されます
ui-mode-renderer-unregistered
ContextHub.Constants.EVENT_UI_MODE_ADDED
新しいモードが追加されると実行されます
ui-mode-added
ContextHub.Constants.EVENT_UI_MODE_REMOVED
モードが削除されると実行されます
ui-mode-removed
ContextHub.Constants.EVENT_UI_MODE_SELECTED
ユーザーがモードを選択した場合に実行されます
ui-mode-selected
ContextHub.Constants.EVENT_UI_MODULE_REGISTERED
新しいモジュールが登録されると実行されます
ui-module-registered
ContextHub.Constants.EVENT_UI_MODULE_UNREGISTERED
モジュールの登録が解除されると実行されます
ui-module-unregistered
ContextHub.Constants.EVENT_UI_MODULE_RENDERER_REGISTERED
モジュールレンダラーが登録されると実行されます
ui-module-renderer-registered
ContextHub.Constants.EVENT_UI_MODULE_RENDERER_UNREGISTERED
モジュールレンダラーの登録が解除されると実行されます
ui-module-renderer-unregistered
ContextHub.Constants.EVENT_UI_MODULE_ADDED
新しいモジュールが追加されると実行されます
ui-module-added
ContextHub.Constants.EVENT_UI_MODULE_REMOVED
モジュールが削除されると実行されます
ui-module-removed
ContextHub.Constants.EVENT_UI_CONTAINER_ADDED
UI コンテナがページに追加されると実行されます
ui-container-added
ContextHub.Constants.EVENT_UI_CONTAINER_OPENED
ContextHub UI が開かれると実行されます
ui-container-opened
ContextHub.Constants.EVENT_UI_CONTAINER_CLOSED
ContextHub UI が折りたたまれると実行されます
ui-container-closed
ContextHub.Constants.EVENT_UI_PROPERTY_MODIFIED
プロパティが変更されると実行されます
ui-property-modified
ContextHub.Constants.EVENT_UI_RENDERED
ContextHub UI がレンダリングされるたび(例:プロパティの変更後)に実行されます
ui-rendered
ContextHub.Constants.EVENT_UI_INITIALIZED
UI コンテナが初期化されると実行されます
ui-initialized
ContextHub.Constants.ACTIVE_UI_MODE
アクティブな UI モードを示します。
/_/active-ui-mode

ContextHub JavaScript API リファレンス contexthub-javascript-api-reference-2

ContextHub オブジェクトを使用すると、すべてのストアにアクセスできます。

関数 (ContextHub) functions-contexthub

getAllStores() getallstores

登録されている ContextHub ストアをすべて返します。

この関数にパラメーターはありません。

戻り値

すべての ContextHub ストアを格納したオブジェクト。各ストアは、ストアと同じ名前を使用するオブジェクトです。

次の例では、すべてのストアを取得し、位置情報ストアを取得します。

var allStores = ContextHub.getAllStores();
var geoloc = allStores.geolocation;

getStore(name) getstore-name

ストアを JavaScript オブジェクトとして取得します。

パラメーター

  • 名前: ストアが登録された名前。

戻り値

ストアを表すオブジェクト。

次の例では、位置情報ストアを取得します。

var geoloc = ContextHub.getStore("geolocation");

ContextHub.SegmentEngine.Segment contexthub-segmentengine-segment

ContextHub セグメントを表します。ContextHub.SegmentEngine.SegmentManager を使用して、セグメントを取得します。

関数(ContextHub.ContextEngine.Segment) functions-contexthub-contextengine-segment

getName() getname

セグメントの名前を String 値として返します。

getPath() getpath

セグメント定義のリポジトリパスを String 値として返します。

ContextHub.SegmentEngine.SegmentManager contexthub-segmentengine-segmentmanager

ContextHub セグメントへのアクセスを提供します。

関数 (ContextHub.SegmentEngine.SegmentManager) functions-contexthub-segmentengine-segmentmanager

getResolvedSegments() getresolvedsegments

現在のコンテキストで解決されたセグメントを返します。 この関数にパラメーターはありません。

戻り値

ContextHub.SegmentEngine.Segment オブジェクトの配列。

ContextHub.Store.Core contexthub-store-core

ContextHub ストアのベースクラス。

プロパティ(ContextHub.Store.Core) properties-contexthub-store-core

eventing eventing

A ContextHub.Utils.Eventing オブジェクト。 このオブジェクトを使用して、関数をストアイベントにバインドします。デフォルト値と初期化については、init(name,config) を参照してください。

name name

ストアの名前。

persistence persistence

ContextHub.Utils.Persistence オブジェクト。デフォルト値と初期化については、init(name,config) を参照してください。。

関数(ContextHub.Store.Core) functions-contexthub-store-core

addAllItems(tree, options) addallitems-tree-options

データオブジェクトまたは配列とストアデータを結合します。オブジェクトのキーと値の各ペアまたは配列が(setItem 関数を使用して)ストアに追加されます。

  • オブジェクト: ​キーはプロパティ名です。
  • 配列: キーは配列のインデックスです。

値はオブジェクトにすることができます。

パラメーター

  • ツリー: (オブジェクトまたは配列)ストアに追加するデータ。
  • options:(Object)setItem 関数に渡すオプションからなる任意のオブジェクト。詳しくは、optionssetItem(key,value,) options パラメーターを参照してください。

戻り値

boolean 値:

  • true は、データオブジェクトが保存されたことを示します。
  • false は、データストアが変更されていないことを示します。

addReference(key, anotherKey) addreference-key-anotherkey

あるキーから別のキーへの参照を作成します。 キーは、それ自体を参照できません。

パラメーター

  • key: anotherKey を参照するキー。

  • anotherkey:key に参照されるキー。

戻り値

boolean 値:

  • true 値は、参照が追加されたことを示します。
  • false 値は、参照が追加されなかったことを示します。

announceReadiness() announcereadiness

このストアに対する ready イベントを発生させます。この関数にはパラメーターがなく、値を返しません。

clean() clean

ストアからすべてのデータを削除します。 関数にはパラメーターも戻り値もありません。

getItem(key) getitem-key

キーに関連付けられている値を返します。

パラメーター

  • キー: (String) 値を返すキー。

戻り値

キーの値を表す Object です。

getKeys(includeInternals) getkeys-includeinternals

ストアからキーを取得します。 オプションで、ContextHub フレームワークで内部的に使用されるキーを取得できます。

パラメーター

  • includeInternals: ​値 true は、内部的に使用されているキーを結果に含めます。このようなキーは、アンダースコア("_")文字で始まります。デフォルト値は false です。

戻り値

キー名(string 値)の配列。

getReferences() getreferences

ストアから参照を取得します。

戻り値

参照キーを被参照キーのインデックスとして使用する配列。

  • 参照キーは、key 関数の addReference パラメーターに対応しています。

  • 被参照キーは、anotherKey 関数の addReference パラメーターに対応しています。

getTree(includeInternals) gettree-includeinternals

ストアからデータツリーを取得します。 オプションで、ContextHub フレームワークによって内部的に使用されるキーと値のペアを含めることができます。

パラメーター

  • includeInternals::値 true は、内部的に使用されているキーと値のペアを結果に含めます。このデータのキーは、アンダースコア("_")文字で始まります。デフォルト値は false です。

戻り値

データツリーを表すオブジェクト。 キーは、オブジェクトのプロパティ名です。

init(name, config) init-name-config

ストアを初期化します。

  • ストアデータを空のオブジェクトに設定します。

  • ストア参照を空のオブジェクトに設定します。

  • eventChannel は data:name です。name はストア名です。

  • storeDataKey は/store/です。名前 ​で、 名前 はストア名です。

パラメーター

  • 名前: ストアの名前。

  • config: 設定プロパティを格納したオブジェクト。

    • eventDeferring:デフォルト値は 32 です。
    • eventing:この ContextHub.Utils.Eventing オブジェクトを選択します。 デフォルト値は ContextHub.eventing オブジェクトを使用します。
    • 永続性:このストアの ContextHub.Utils.Persistence オブジェクト。 デフォルト値は ContextHub.persistence オブジェクトです。

isEventingPaused() iseventingpaused

このストアに対するイベンティングが一時停止されているかどうかを判断します。

戻り値

次の boolean 値。

  • true:イベンティングが一時停止されているので、このストアに対するイベントは発生しません。
  • false:イベンティングが一時停止されていないので、このストアに対するイベントが発生します。

pauseEventing() pauseeventing

ストアのイベンティングを一時停止して、イベントが発生しないようにします。 この関数は、パラメーターを指定せず、値を返しません。

removeItem(key, options) removeitem-key-options

キーと値のペアをストアから削除します。

キーが削除されると、この関数が data イベントを発生させます。イベントデータには、ストア名、削除されたキーの名前、削除された値、キーの新しい値(null)およびアクションタイプ「remove」が含まれます。

オプションで、data イベントを発生させないようにすることができます。

パラメーター

  • キー: (String) 削除するキーの名前。

  • options: (Object) オプションからなるオブジェクト。 次のオブジェクトプロパティが有効です。

    • silent:値 true は、data イベントが発生しないようにします。デフォルト値は false です。

戻り値

boolean 値:

  • true 値は、キーと値のペアが削除されたことを示します。
  • false 値は、キーがストアに見つからなかったのでデータストアが変更されていないことを示します。

removeReference(key) removereference-key

参照をストアから削除します。

パラメーター

  • キー: 削除するキー参照。 このパラメーターは、key 関数の addReference パラメーターに対応しています。

戻り値

boolean 値:

  • true 値は、参照が削除されたことを示します。
  • false 値は、キーが有効ではなかったのでストアが変更されていないことを示します。

reset(keepRemainingData) reset-keepremainingdata

ストアの永続化されたデータの初期値をリセットします。 必要に応じて、その他のすべてのデータをストアから削除できます。 ストアのリセット中に、このストアのイベンティングが一時停止されました。 この関数は値を返しません。

初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。

パラメーター

  • keepRemainingData: (ブール値)値が true の場合、初期値以外のデータは保持されます。 値が false の場合、初期値を除くすべてのデータが削除されます。

ストアの永続化されたデータの初期値をリセットします。 必要に応じて、その他のすべてのデータをストアから削除できます。 ストアのリセット中に、このストアのイベンティングが一時停止されました。 この関数は値を返しません。

初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。

パラメーター

  • keepRemainingData:(ブール値)値が true の場合、初期値以外のデータは保持されます。 値が false の場合、初期値を除くすべてのデータが削除されます。

resolveReference(key, retry) resolvereference-key-retry

参照されたキーを取得します。 オプションで、最良一致の解決に使用する反復回数を指定できます。

パラメーター

  • キー: (String) 参照を解決するキー。 この key パラメーターは、key 関数の addReference パラメーターに対応しています。

  • 再試行: (Number) 使用する繰り返し回数。

戻り値

被参照キーを表す string 値。参照が解決されない場合は、key パラメーターの値が返されます。

resumeEventing() resumeeventing

このストアのイベンティングを再開して、イベントをトリガーします。 この関数は、パラメーターを定義せず、値を返しません。

setItem(key, value, options) setitem-key-value-options

キーと値のペアをストアに追加します。

キーの値がそのキーに対して現在保存されている値と異なる場合にのみ data イベントを発生させます。オプションで、data イベントを発生させないようにすることができます。

イベントデータには、ストア名、キー、前の値、新しい値およびアクションタイプ set が含まれます。

パラメーター

  • キー: (String) キーの名前。

  • options: (Object) オプションからなるオブジェクト。 次のオブジェクトプロパティが有効です。

    • silent:値 true は、data イベントが発生しないようにします。デフォルト値は false です。
  • 値: (Object) キーに関連付ける値。

戻り値

boolean 値:

  • true は、データオブジェクトが保存されたことを示します。
  • false は、データストアが変更されていないことを示します。

ContextHub.Store.JSONPStore contexthub-store-jsonpstore

JSON データを格納したストア。 データは、外部の JSONP サービスから、またはオプションで JSON データを返すサービスから取得されます。 このクラスのインスタンスを作成する際に、 関数を使用してサービスの詳細を指定します。init

ストアは、インメモリ永続性(JavaScript 変数)を使用します。 ストアデータは、ページの有効期間中にのみ使用できます。

ContextHub.Store.JSONPStore は ContextHub.Store.Core を拡張したものなので、このクラスの関数を継承しています。

関数(ContextHub.Store.JSONPStore) functions-contexthub-store-jsonpstore

configureService(serviceConfig, override) configureservice-serviceconfig-override

このオブジェクトが使用する JSONP サービスへの接続の詳細を設定します。 既存の設定は、更新または置き換えることができます。 この関数は値を返しません。

パラメーター

  • serviceConfig: 次のプロパティを格納したオブジェクト。

    • ホスト:(String) サーバーの名前または IP アドレス。

    • jsonp:(Boolean) 値 true はサービスが JSONP サービスであることを示し、それ以外は false です。 true の場合、{callback:"ContextHub.Callbacks.Object.name} 個のオブジェクトが service.params オブジェクトに追加されます。

    • params:(オブジェクト)オブジェクトのプロパティとして表される URL パラメーター。パラメーター名はプロパティ名で、パラメーター値はプロパティ値です。

    • パス:(String) サービスへのパス。

    • ポート:(Number) サービスのポート番号。

    • セキュア:(String または Boolean)サービス URL に使用するプロトコルを決定します。

      • auto: //
      • true//
      • false: https://
  • override:(Boolean)値が true の場合、既存のサービス設定を serviceConfig のプロパティで置き換えます。値が false の場合、既存のサービス設定プロパティを serviceConfig のプロパティと結合します。

getRawResponse() getrawresponse

JSONP サービスの最後の呼び出し以降にキャッシュされた生の応答を返します。 この関数にはパラメーターは必要ありません。

戻り値

生の応答を表すオブジェクトです。

getServiceDetails() getservicedetails

この ContextHub.Store.JSONPStore オブジェクトのサービスオブジェクトを取得します。 service オブジェクトには、サービス URL の作成に必要なすべての情報が含まれています。

戻り値

次のプロパティを持つオブジェクト。

  • ホスト: (String) サーバーの名前または IP アドレス。

  • jsonp: (Boolean) 値 true はサービスが JSONP サービスであることを示し、それ以外は false です。 true の場合、{callback:"ContextHub.Callbacks.Object.name} 個のオブジェクトが service.params オブジェクトに追加されます。

  • params:(オブジェクト)オブジェクトのプロパティとして表される URL パラメーター。パラメーター名はプロパティ名で、パラメーター値はプロパティ値です。

  • パス: (String) サービスへのパス。

  • ポート: (Number) サービスのポート番号。

  • セキュア: (String または Boolean)サービス URL に使用するプロトコルを決定します。

    • auto: //
    • true//
    • false: https://

getServiceURL(resolve) getserviceurl-resolve

JSONP サービスの URL を取得します。

パラメーター

  • 解決: (Boolean) 解決されたパラメーターを URL に含めるかどうかを決定します。 値 true はパラメーターを解決し、false は解決しません。

戻り値

サービス URL を表す string 値。

init(name, config) init-name-config-1

ContextHub.Store.JSONPStore オブジェクトを初期化します。

パラメーター

  • 名前: (String) ストアの名前。

  • config: (Object) サービスプロパティを格納するオブジェクト。 JSONPStore オブジェクトは、service オブジェクトのプロパティを使用して、JSONP サービスの URL を組み立てます。

    • eventDeferring:32.

    • eventing:このストアの ContextHub.Utils.Eventing オブジェクト。 デフォルト値は ContextHub.eventing オブジェクトです。

    • 永続性:このストアの ContextHub.Utils.Persistence オブジェクト。 デフォルトでは、メモリパーシスタンスが使用されます(JavaScript オブジェクト)。

    • service:(オブジェクト)

      • ホスト:(String) サーバーの名前または IP アドレス。

      • jsonp:(Boolean) 値 true はサービスが JSONP サービスであることを示し、それ以外は false です。 true の場合、{callback: "ContextHub.Callbacks.*Object.name*} オブジェクトは service.params に追加されます。

      • params:(オブジェクト)オブジェクトのプロパティとして表される URL パラメーター。パラメーターの名前と値は、それぞれオブジェクトのプロパティの名前と値です。

      • パス:(String) サービスへのパス。

      • ポート:(Number) サービスのポート番号。

      • セキュア:(String または Boolean)サービス URL に使用するプロトコルを決定します。

        • auto: //
        • true//
        • false: https://
      • timeout:(Number)タイムアウトまでに JSONP サービスの応答を待機する時間(ミリ秒単位)。

      • ttl:JSONP サービスの最小呼び出し間隔(ミリ秒)。 ( queryService 関数 ) を参照してください。

queryService(reload) queryservice-reload

リモート JSONP サービスをクエリし、応答をキャッシュします。この関数の前回の呼び出しからの時間が config.service.ttl の値より小さい場合、サービスは呼び出されず、キャッシュされた応答は変更されません。オプションで、サービスを強制的に呼び出すことができます。config.service.ttl プロパティは、ストアを初期化するために init 関数を呼び出すと設定されます。

クエリが完了すると、ready イベントが発生します。JSONP サービスの URL が設定されていない場合、この関数は何もしません。

パラメーター

  • リロード: (Boolean) 値が true の場合、キャッシュされた応答を削除し、JSONP サービスを強制的に呼び出します。

reset reset

ストアの永続化されたデータの初期値をリセットし、JSONP サービスを呼び出します。 必要に応じて、その他のすべてのデータをストアから削除できます。 初期値がリセットされている間、このストアのイベンティングは一時停止されています。 この関数は値を返しません。

初期値は、ストアオブジェクトのインスタンス化に使用される config オブジェクトの initialValues プロパティで提供されます。

パラメーター

  • keepRemainingData: (ブール値)値が true の場合、初期値以外のデータは保持されます。 値が false の場合、初期値を除くすべてのデータが削除されます。

resolveParameter(f) resolveparameter-f

指定されたパラメータを解決します。

ContextHub.Store.PersistedJSONPStore contexthub-store-persistedjsonpstore

ContextHub.Store.PersistedJSONPStore extends ContextHub.Store.JSONPStore そのクラスのすべての関数を継承します。 ただし、JSONP サービスから取得されるデータは、ContextHub の永続性に応じて保持されます(永続モードを参照)。

ContextHub.Store.PersistedStore contexthub-store-persistedstore

ContextHub.Store.PersistedStore は ContextHub.Store.Core を拡張したものなので、このクラスのすべての関数を継承しています。このストア内のデータは、ContextHub の永続性の設定に従って保持されます。

ContextHub.Store.SessionStore contexthub-store-sessionstore

ContextHub.Store.SessionStore は ContextHub.Store.Core を拡張したものなので、このクラスのすべての関数を継承しています。このストアのデータは、インメモリ永続性(JavaScript オブジェクト)を使用して保持されます。

ContextHub.UI contexthub-ui

UI モジュールと UI モジュールレンダラーを管理します。

関数 (ContextHub.UI) functions-contexthub-ui

registerRenderer(moduleType, renderer, dontRender) registerrenderer-moduletype-renderer-dontrender

UI モジュールレンダラーを ContextHub に登録します。 レンダラーの登録後は、 UI モジュールの作成. この関数は、 ContextHub.UI.BaseModuleRenderer の拡張 :カスタム UI モジュールレンダラーを作成します。

パラメーター

  • moduleType: (String)UI モジュールレンダラーの識別子。 指定された値でレンダラーが既に登録されている場合、既存のレンダラーが登録解除されてから、このレンダラーが登録されます。
  • renderer:(文字列)UI モジュールをレンダリングするクラスの名前。
  • dontRender:(Boolean)レンダラーの登録後に ContextHub UI がレンダリングされないようにするには、true に設定します。デフォルト値は false です。

次の例では、レンダラーを contexthub.browserinfo モジュールタイプとして登録します。

ContextHub.UI.registerRenderer('contexthub.browserinfo', new SurferinfoRenderer());

cookie とやり取りするためのユーティリティクラス。

exists(key) exists-key

cookie が存在するかどうかを判断します。

パラメーター

  • key: ​テストする cookie のキーを格納した String

戻り値

boolean 値 true は、cookie が存在することを示します。

if (ContextHub.Utils.Cookie.exists("name")) {
   // conditionally-executed code
}

getAllItems(filter) getallitems-filter

フィルターに一致するキーを持つすべての cookie を返します。

パラメーター

  • (オプション) フィルター: cookie のキーを照合する条件。 すべての cookie を返す場合は、値を指定しません。 次のタイプがサポートされます。

    • 文字列:この文字列が cookie のキーと比較されます。
    • 配列:配列内の各項目はフィルターです。
    • RegExp オブジェクト:オブジェクトの test 関数は、cookie のキーの照合に使用されます。
    • 関数:cookie のキーが一致するかどうかをテストする関数。関数は、cookie のキーをパラメーターとして取り、テストによって一致が確認された場合は true を返す必要があります。

戻り値

cookie のオブジェクト。 オブジェクトのプロパティは cookie のキーで、キー値は cookie の値です。

ContextHub.Utils.Cookie.getAllItems([/^cq-authoring/, /^cq-editor/])

getItem(key) getitem-key-1

cookie の値を返します。

パラメーター

  • キー: 値を取得する cookie のキー。

戻り値

cookie の値、またはそのキーの cookie が見つからなかった場合は null

ContextHub.Utils.Cookie.getItem("name");

getKeys(filter) getkeys-filter

フィルターに一致する既存の cookie のキーからなる配列を返します。

パラメーター

  • フィルター: cookie のキーを照合する条件。 次のタイプがサポートされます。

    • 文字列:この文字列が cookie のキーと比較されます。
    • 配列:配列内の各項目はフィルターです。
    • RegExp オブジェクト:オブジェクトの test 関数は、cookie のキーの照合に使用されます。
    • 関数:cookie のキーが一致するかどうかをテストする関数。関数は、cookie のキーをパラメーターとして取り、テストによって一致が確認された場合は true を返す必要があります。

戻り値

それぞれがフィルターに一致する cookie のキーである文字列からなる配列。

ContextHub.Utils.Cookie.getKeys([/^cq-authoring/, /^cq-editor/])

removeItem(key, options) removeitem-key-options-1

cookie を削除します。cookie を削除するには、値を空の文字列に設定し、有効期限を現在の日付の前の日に設定します。

パラメーター

  • key: ​削除する cookie のキーを表す String 値。

  • options: cookie の属性を設定するプロパティ値を格納したオブジェクト。詳しくは、 [setItem](https://experienceleague.adobe.com/docs/experience-manager-64/developing/personlization/contexthub-api.html?lang=ja#setitem-key-value-options) 関数を参照してください。expires プロパティは無効です。

戻り値

この関数は値を返しません。

ContextHub.Utils.Cookie.vanish([/^cq-authoring/, 'cq-scrollpos']);

setItem(key, value, options) setitem-key-value-options-1

指定されたキーと値の cookie を作成し、その cookie を現在のドキュメントに追加します。 必要に応じて、cookie の属性を設定するオプションを指定できます。

パラメーター

  • キー: cookie のキーを格納した String。

  • 値: cookie の値を格納した String。

  • options: (オプション)cookie の属性を設定する、次のいずれかのプロパティを格納したオブジェクト。

    • expires:cookie の有効期限を指定する date 値または number 値。date 値は、有効期限の絶対時刻を指定します。 数値(日単位)は、有効期限を現在の時刻に数値を加えた値に設定します。 デフォルト値は undefined です。
    • :cookie の booleanSecure 属性を指定する Secure 値。デフォルト値は false です。
    • :cookie の StringPath 属性として使用する Path 値。デフォルト値は undefined です。

戻り値

値が設定された cookie。

ContextHub.Utils.Cookie.setItem("name", "mycookie", {
    expires: 3,
    domain: 'localhost',
    path: '/some/directory',
    secure: true
});

vanish(filter, options) vanish-filter-options

指定されたフィルターに一致するすべての cookie を削除します。cookie は、 getKeys 関数を使用して照合され、 removeItem 関数を使用して削除されます。

パラメーター

  • filter 関数への呼び出しに使用する [getKeys](/docs/experience-manager-64/developing/personlization/contexthub-api.md#getkeys-filter)filter 引数。

  • options 関数への呼び出しに使用する [removeItem](/docs/experience-manager-64/developing/personlization/contexthub-api.md#removeitem-key-options)options 引数。

戻り値

この関数は値を返しません。

ContextHub.Utils.Eventing contexthub-utils-eventing

関数を ContextHub ストアイベントにバインドおよびバインド解除できます。を使用して、ストアの ContextHub.Utils.Eventing オブジェクトにアクセスします。 eventing ストアのプロパティ。

関数(ContextHub.Utils.Eventing) functions-contexthub-utils-eventing

off(name, selector) off-name-selector

イベントから関数をバインド解除します。

パラメーター

  • name: ​関数のバインドを解除するイベントの名前

  • selector: ​バインドを識別するセレクター(on 関数と once 関数の selector パラメーターを参照)。

戻り値

この関数は値を返しません。

on(name, handler, selector, triggerForPastEvents) on-name-handler-selector-triggerforpastevents

関数をイベントにバインドします。 イベントが発生するたびに関数が呼び出されます。 オプションで、バインディングが確立される前に過去に発生したイベントに対して関数を呼び出すことができます。

パラメーター

  • 名前: (文字列) イベント名 関数をバインドする先にドラッグします。

  • ハンドラー: (関数)イベントにバインドする関数。

  • selector:(文字列)バインドの一意の識別子。off 関数を使用してバインドを削除する場合は、セレクターでバインドを識別する必要があります。

  • triggerForPastEvents:(Boolean)過去に発生したイベントに対してハンドラーを実行するかどうかを示します。true 値は、過去のイベントに対してハンドラーを呼び出します。値 false は、未来のイベントに対してハンドラーを呼び出します。デフォルト値は true です。

戻り値

triggerForPastEvents 引数が true の場合、この関数はイベントが過去に発生したかどうかを示す boolean 値を返します。

  • true:イベントが過去に発生しており、ハンドラーが呼び出されます。
  • false:イベントが過去に発生していません。

triggerForPastEventsfalse の場合、この関数は値を返しません。

次の例では、関数を geolocation ストアの data イベントにバインドします。この関数は、ページ上の要素にストアの緯度データ項目の値を設定しています。

<div class="location">
    <p>latitude: <span id="lat"></span></p>
</div>

<script>
    var geostore = ContextHub.getStore("geolocation");
    geostore.eventing.on(ContextHub.Constants.EVENT_DATA_UPDATE,getlat,"getlat");

    function getlat(){
       latitude = geostore.getItem("latitude");
       $("#lat").html(latitude);
    }
</script>

once(name, handler, selector, triggerForPastEvents) once-name-handler-selector-triggerforpastevents

関数をイベントにバインドします。 イベントが最初に発生したときに、関数が 1 回だけ呼び出されます。 オプションで、バインディングが確立される前に過去に発生したイベントに対して関数を呼び出すことができます。

パラメーター

  • 名前: (文字列) イベント名 関数をバインドする先にドラッグします。

  • ハンドラー: (関数)イベントにバインドする関数。

  • selector:(文字列)バインドの一意の識別子。off 関数を使用してバインドを削除する場合は、セレクターでバインドを識別する必要があります。

  • triggerForPastEvents:(Boolean)過去に発生したイベントに対してハンドラーを実行するかどうかを示します。true 値は、過去のイベントに対してハンドラーを呼び出します。値 false は、未来のイベントに対してハンドラーを呼び出します。デフォルト値は true です。

戻り値

triggerForPastEvents 引数が true の場合、この関数はイベントが過去に発生したかどうかを示す boolean 値を返します。

  • true:イベントが過去に発生しており、ハンドラーが呼び出されます。
  • false:イベントが過去に発生していません。

triggerForPastEventsfalse の場合、この関数は値を返しません。

ContextHub.Utils.inheritance contexthub-utils-inheritance

オブジェクトが別のオブジェクトのプロパティとメソッドを継承できるようにするユーティリティクラス。

関数 (ContextHub.Utils.inheritance) functions-contexthub-utils-inheritance

inherit(child, parent) inherit-child-parent

オブジェクトに別のオブジェクトのプロパティとメソッドを継承させます。

パラメーター

  • 子: (Object) 継承するオブジェクト。
  • 親: (Object) 継承するプロパティとメソッドを定義するオブジェクト。

ContextHub.Utils.JSON contexthub-utils-json

オブジェクトを JSON 形式にシリアライズし、JSON 文字列をオブジェクトにデシリアライズする関数を提供します。

関数 (ContextHub.Utils.JSON) functions-contexthub-utils-json

parse(data) parse-data

文字列値を JSON として解析し、JavaScript オブジェクトに変換します。

パラメーター

  • データ: JSON 形式の string 値。

戻り値

JavaScript オブジェクト。

このコード ContextHub.Utils.JSON.parse("{'city':'Basel','country':'Switzerland','population':'173330'}"); は次のオブジェクトを返します。

Object {
   city: "Basel",
   country: "Switzerland",
   population: 173330
}

stringify(data) stringify-data

JavaScript の値およびオブジェクトを JSON 形式の文字列値にシリアライズします。

パラメーター

  • データ: シリアライズする値またはオブジェクト。 この関数は、boolean、array、number、string および date 値をサポートします。

戻り値

シリアライズされた文字列値。dataegExp 値の場合、この関数は空のオブジェクトを返します。data が関数の場合は、undefined を返します。

次のコードは "{'city':'Basel','country':'Switzerland','population':'173330'}": を返します。

ContextHub.Utils.JSON.stringify({
   city: "Basel",
   country: "Switzerland",
   population: 173330
});

ContextHub.Utils.JSON.tree contexthub-utils-json-tree

このクラスは、保存される、または ContextHub ストアから取得されるデータオブジェクトの操作を容易にします。

関数 (ContextHub.Utils.JSON.tree) functions-contexthub-utils-json-tree

addAllItems() addallitems

データオブジェクトのコピーを作成し、2 つ目のオブジェクトのデータツリーに追加します。 この関数はコピーを返し、元のオブジェクトは変更しません。 2 つのオブジェクトのデータツリーに同じキーが含まれている場合、2 番目のオブジェクトの値は、最初のオブジェクトの値を上書きします。

パラメーター

  • tree: ​コピーされるオブジェクト。
  • secondTree: tree オブジェクトのコピーと結合されるオブジェクト。

戻り値

結合されたデータを格納するオブジェクト。

cleanup() cleanup

オブジェクトのコピーを作成し、値を含まないか、null 値または undefined 値を含むデータツリーの項目を探して削除し、コピーを返します。

パラメーター

  • ツリー: クリーンアップするオブジェクト。

戻り値

クリーンアップされるツリーのコピー。

getItem() getitem

キーに対する値をオブジェクトから取得します。

パラメーター

  • ツリー: データオブジェクト。
  • キー: 取得する値のキー。

戻り値

キーに対応する値。 キーに子キーがある場合、この関数は複合オブジェクトを返します。キーの値のタイプが undefined の場合、null が返されます。

次の JavaScript オブジェクトについて考えてみます。

myObject {
  user: {
    location: {
      city: "Basel",
        details: {
          population: 173330,
          elevation: 260
        }
      }
    }
  }

次のサンプルコードは、値 260 を返します。

ContextHub.Utils.JSON.tree.getItem(myObject, "/user/location/details/elevation");

次のサンプルコードは、子キーを持つキーの値を取得します。

ContextHub.Utils.JSON.tree.getItem(myObject, "/user");

この関数は、次のオブジェクトを返します。

Object {
  location: {
    city: "Basel",
    details: {
      population: 173330,
      elevation: 260
    }
  }
}

getKeys() getkeys

オブジェクトのデータツリーからすべてのキーを取得します。 必要に応じて、特定のキーの子のキーのみを取得できます。 また、オプションで、取得したキーの並べ替え順を指定することもできます。

パラメーター

  • ツリー: データツリーのキーの取得元となるオブジェクト。
  • 親: (オプション)子項目のキーを取得するデータツリー内の項目のキー。
  • 順序: (オプション)返されたキーの並べ替え順を決定する関数。 ( Array.prototype.sort (Mozilla Developer Network)。

戻り値

キーからなる配列。

次のオブジェクトについて考えてみます。

myObject {
  location: {
    weather: {
      temperature: "28C",
      humidity: "77%",
      precipitation: "10%",
      wind: "8km/h"
    },
    city: "Basel",
    country: "Switzerland",
    longitude: 7.5925727,
    latitude: 47.557421
  }
}

ContextHub.Utils.JSON.tree.getKeys(myObject); スクリプトは、次の配列を返します。

["/location", "/location/city", "/location/country", "/location/latitude", "/location/longitude", "/location/weather", "/location/weather/humidity", "/location/weather/precipitation", "/location/weather/temperature", "/location/weather/wind"]

removeItem() removeitem

指定されたオブジェクトのコピーを作成し、指定されたブランチをデータツリーから削除し、変更されたコピーを返します。

パラメーター

  • ツリー:データオブジェクト。
  • キー:削除するキー。

戻り値

キーが削除された元のデータオブジェクトのコピー。

次のオブジェクトについて考えてみます。

myObject {
  one: {
    foo: "bar",
    two: {
      three: {
        four: {
          five: 5,
          six: 6
        }
      }
    }
  }
}

次のスクリプトの例では、 /one/two/three/four ブランチをデータツリーから削除します。

myObject = ContextHub.Utils.JSON.tree.removeItem(myObject, "/one/two/three/four");

この関数は、次のオブジェクトを返します。

myObject {
  one: {
    foo: "bar"
  }
}

sanitizeKey(key) sanitizekey-key

文字列値の不要部分を削除して、キーとして使用できるようにします。 文字列の不要部分を削除するには、この関数は次の操作を実行します。

  • 複数の連続するスラッシュを 1 つのスラッシュに減らします。
  • 文字列の先頭と末尾から空白を削除します。
  • 結果をスラッシュで区切られた文字列の配列に分割します。

作成された配列を使用して、使用可能なキーを作成します。パラメーター

  • key: ​不要部分を削除する string

戻り値

string 値からなる配列で、各文字列はスラッシュで区切られた key の一部です。不要部分が削除されたキーを表します。不要部分が削除された配列の長さがゼロの場合、この関数は null を返します。

次のコードは、文字列の不要部分を削除して ["this", "is", "a", "path"] という配列を作成し、その配列からキー "/this/is/a/path" を生成します。

var key = " / this////is/a/path ";
ContextHub.Utils.JSON.tree.sanitizeKey(key)
"/" + ContextHub.Utils.JSON.tree.sanitizeKey(key).join("/");

setItem(tree, key, value) setitem-tree-key-value

オブジェクトのコピーのデータツリーにキーと値のペアを追加します。データツリーについて詳しくは、永続性を参照してください。

パラメーター

  • ツリー:データオブジェクト。
  • キー:追加する値に関連付けるキー。 キーは、データツリー内の項目へのパスです。この関数は、ContextHub.Utils.JSON.tree.sanitize を呼び出して、キーを追加する前に不要部分を削除します。
  • 値:データツリーに追加する値。

戻り値

keyvalue のペアを含む tree オブジェクトのコピー。

次の JavaScript コードについて考えてみます。

var myObject = {
     user: {
        location: {
           city: "Basel"
           }
        }
     };

var myKey = "/user/location/details";

var myValue = {
      population: 173330,
      elevation: 260
     };

myObject = ContextHub.Utils.JSON.tree.setItem(myObject, myKey, myValue);

myObject オブジェクトの値は次のとおりです。

ContextHub.Utils.storeCandidates contexthub-utils-storecandidates

ストア候補を登録し、登録されたストア候補を取得できます。

関数 (ContextHub.Utils.storeCandidates) functions-contexthub-utils-storecandidates

getRegisteredCandidates(storeType) getregisteredcandidates-storetype

ストア候補として登録されているストアタイプを返します。特定のストアタイプまたはすべてのストアタイプの登録されている候補を取得します。

パラメーター

戻り値

ストアタイプのオブジェクト。 オブジェクトのプロパティはストアタイプ名で、プロパティ値は登録済みのストア候補の配列です。

getStoreFromCandidates(storeType) getstorefromcandidates-storetype

登録されている候補からストアタイプを返します。同じ名前のストアタイプが複数登録されている場合、この関数は最も優先度の高いストアタイプを返します。

パラメーター

戻り値

登録済みのストア候補を表すオブジェクト。 要求されたストアの種類が登録されていない場合は、エラーが発生します。

getSupportedStoreTypes() getsupportedstoretypes

ストア候補として登録されているストアタイプの名前を返します。 この関数にはパラメーターは必要ありません。

戻り値

文字列値からなる配列で、各文字列はストア候補と一緒に登録されたストアタイプです。storeType 関数の パラメーターを参照してください。ContextHub.Utils.storeCandidates.registerStoreCandidate

registerStoreCandidate(store, storeType, priority, applies) registerstorecandidate-store-storetype-priority-applies

名前と優先度を使用して、ストアオブジェクトをストア候補として登録します。

優先度は、同じ名前のストアの重要性を示す数値です。 既に登録されているストア候補と同じ名前でストア候補を登録した場合は、優先度の高い候補が使用されます。 ストア候補を登録する場合、優先度が同じ名前の登録済みストア候補より高い場合にのみ、ストアが登録されます。

パラメーター

  • ストア: (Object) ストア候補として登録するストアオブジェクト。
  • storeType: (String) ストア候補の名前。 この値は、ストア候補のインスタンスを作成する際に必要です。
  • priority:(数値)ストア候補の優先度。
  • applies:(Function)現在の環境内でのストアの適用可能性を評価するために呼び出す関数。この関数は、ストアを適用できる場合は true、それ以外の場合は false を返す必要があります。デフォルト値は、true を返す関数 function() {return true;} です。

ContextHub.Utils.storeCandidates.registerStoreCandidate(myStoreCandidate,
                                'contexthub.mystorecandiate', 0);
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e