グローバル参照のセキュアなラッパー

最も一般的に使用されるセキュアなオブジェクトのリストを次に示します。

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

LockerService によってラップされるオブジェクトのセキュアなラッパー。SecureObject がある場合、通常はそのオブジェクトへのアクセス権がないため、一部のプロパティは使用できません。

SecureWindow

Window オブジェクトのセキュアなラッパー。DOM ドキュメントがあるウィンドウを表します。

1<!--c:secureWrappers-->
2<aura:component >
3    <div id="myDiv" aura:id="div1">
4        <p>See how LockerService uses secure wrappers</p>
5    </div>
6    <lightning:button name="myButton" label="Peek in DOM"
7        aura:id="button1" onclick="{!c.peekInDom}"/>
8</aura:component>

1({ /* secureWrappersController.js */
2    peekInDom : function(cmp, event, helper) {
3        console.log("div1: ", cmp.find("div1").getElement());
4        
5        console.log("button1: ", cmp.find("button1"));
6        console.log("button name: ", event.getSource().get("v.name"));
7        // add debugger statement for inspection
8        // always remove this from production code
9        debugger;
10    }
11})

1cmp
2cmp+""
3cmp.find("button1")
4cmp.find("button1")+""
5window
6window+""
7$A
8$A+""