Lightning コ��ポーネント開発者ガイド
jグローバル参照のセキュアなラッパー
Locker Service はグローバル参照に制限を適用します。window など、組み込み以外のオブジェクトは Locker Service がセキュアなバージョンを用意します。たとえば、window のセキュアなバージョンは SecureWindow です。組み込み以外のオブジェクトと同じ方法でセキュアなラッパーとやりとりできますが、セキュアなラッパーではオブジェクトとそのプロパティへのアクセスが制限されます。セキュアなラッパーでは、基盤となるオブジェクトの API のサブセットが公開されます。
最も一般的に使用されるセキュアなオブジェクトのリストを次に示します。
- SecureAura
- $A のセキュアなラッパー。JavaScript コードのフレームワークを使用するためのエントリポイントです。
- SecureComponent
- Component オブジェクトのセキュアなラッパー。
- SecureComponentRef
- SecureComponentRef は、異なる名前空間のコンポーネントの外部 API を提供する SecureComponent のサブセットです。
- コントローラまたはヘルパーの使用中は、SecureComponent (基本的に this オブジェクト) にアクセスできます。コンポーネントを操作する他のコンテキストでは、異なる名前空間のコンポーネントを参照すると、SecureComponentRef が返されます。たとえば、マークアップに lightning:button が含まれ、cmp.find("buttonAuraId") をコールすると、lightning:button はボタンマークアップを含むコンポーネントとは異なる名前空間にあるため、SecureComponentRef が返されます。
- SecureDocument
- document オブジェクトのセキュアなラッパー。HTML ドキュメントまたはページのルートノードを表します。document オブジェクトは、ページのコンテンツ (DOM ツリー) へのエントリポイントです。
- SecureElement
- Element オブジェクトのセキュアなラッパー。HTML 要素を表します。SecureElement は Proxy オブジェクトでラップされているため、そのデータにアクセスされたときに遅延絞り込みを実行できるようにパフォーマンスが最適化されます。ブラウザコンソールでデバッグしている場合、HTML 要素は Proxy オブジェクトによって表されます。
- SecureObject
- Locker Service によってラップされるオブジェクトのセキュアなラッパー。SecureObject がある場合、通常はそのオブジェクトへのアクセス権がないため、一部のプロパティは使用できません。
- SecureWindow
- window オブジェクトのセキュアなラッパー。DOM ドキュメントがあるウィンドウを表します。
例
いくつかのセキュアなラッパーを表すサンプルコンポーネントを見てみましょう。
c:secureWrappers コンポーネントは、<div> HTML 要素と <lightning:button> コンポーネントを作成します。
次に、DOM 内でピークするクライ���ント側コントローラを示します。
console.log() を使用して、<div> 要素とボタンを調べます。<div> SecureElement は Proxy オブジェクトでラップされているため、そのデータにアクセスされたときに遅延絞り込みを実行できるようにパフォーマンスが最適化されます。
ブラウザコンソールの要素を調べることができるように、コードに debugger ステートメントが追加されています。
ブラウザコンソールに次の式を入力し、結果を確認します。
オブジェクトが String に変換されるように、いくつかの式に空の文字列が追加されています。toString() メソッドを使用することもできます。
出力は次のとおりです。
出力の一部を調べてみましょう。
- cmp+""
- c:secureWrappers コンポーネントを表す cmp の SecureComponent オブジェクトを返します。
- cmp.find("button1")+""
- 異なる名前空間のコンポーネントの外部 API を表す SecureComponentRef を返します。この例では、このコンポーネントは lightning:button です。
- window+""
- SecureWindow オブジェクトを返します。
- $A+""
- SecureAura オブジェクトを返します。