Lightning コンポーネント開発者ガイド
jセキュアなラッパー
Locker Service は、オブジェクトを非表示にすることや、それらのオブジェクトのセキュアなバージョンを提供することで、グローバル参照に制限を適用します。たとえば、window のセキュアなバージョンは SecureWindow です。セキュアなバージョンは、メソッドおよびプロパティに応じて絞り込まれたり、非表示になったりする点を除き、セキュアでないバージョンと同じ方法でやりとりできます。
他のオブジェクト (コンポーネントやイベントなど) のインスタンスも、ラップされたセキュアなバージョンで置き換えられます。最も一般的なセキュアなラッパーのリストを次に示します。
- 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
- さまざまな HTML 要素を表す Element オブジェクトのセキュアなラッパー。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 オブジェクトを返します。