24635 2014-02-12 21:45:46 +0000 switchToFrame should only accept a WebElement or number argument. 2014-03-10 21:45:57 +0000 1 1 1 Unclassified Browser Test/Tools WG WebDriver unspecified PC All RESOLVED FIXED P2 normal --- 20860 1 jleyba public-browser-tools-testing barancev dburns fisherii luke.semerau mike public-browser-tools-testing oldest_to_newest 100444 0 jleyba 2014-02-12 21:45:46 +0000 https://dvcs.w3.org/hg/webdriver/raw-file/default/webdriver-spec.html#switching-frames switchToFrame currently accepts a WebElement (as a reference to an iframe/frame element), DOMString (as the frame name or id), or number (the frame index) as an argument. The spec should be updated to drop support for DOMString, as these selection methods are redundant with WebElement. Furthermore, even though the spec outlines how DOMString should be handled, it is ambiguous from an API perspective. Given a DOMString argument, should WebDriver select the frame with that name, or the frame with that ID? By supporting only an index number or WebElement reference, switchToFrame would present an unambiguous API with clearly defined behavior. To select a frame by name: webElement = findElement(Locator("name", "X")) switchToFrame(webElement) Likewise, to switch to a frame by ID: webElement = findElement(Locator("id", "X")) switchToFrame(webElement) 100560 1 barancev 2014-02-13 21:25:14 +0000 I suggest to deprecate swithing by index too. Yes, it is unambiguous, but the order of frames can vary among browsers. According to the specification switching by number is equivalent of the JS expression "window.frames[n]". Let's consider a sample: http://jsfiddle.net/barancev/e6ahn/2/show/light/ This page has a static iframe (let's call it "8uua7") and a dynamic iframe (let's call it "2P8u6") created by JS and inserted before the static one. So the tree (DOM) order of frames is 1) "2P8u6", 2) "8uua7". What browsers think about the order of the frames in the array window.frames on this page? IE: 1) "2P8u6", 2) "8uua7", all right. Firefox: 1) "8uua7", 2) "2P8u6", the order is opposite to the tree order. Chrome: 1) "8uua7", 2) "2P8u6", the same as Firefox. And as soon as the browser behaviour is incosistent here we'd better not propagate this incosistency to the WebDriver API. 100592 2 dburns 2014-02-14 16:46:29 +0000 reading http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#accessing-other-browsing-contexts it would appear that Chrome and Firefox do not conform to this which means using it by index Raised https://bugzilla.mozilla.org/show_bug.cgi?id=972902 related to this 101410 3 dburns 2014-02-25 21:50:10 +0000 we are going to remove the locators by name and ID. We will keep window.frames[n] and WebElement with WebElement being the favoured way. 101558 4 luke.semerau 2014-02-27 23:45:03 +0000 *** Bug 24837 has been marked as a duplicate of this bug. *** 101560 5 1441 luke.semerau 2014-02-27 23:46:05 +0000 Created attachment 1441 frame_switching_patch.txt 102150 6 luke.semerau 2014-03-10 18:05:13 +0000 *** Bug 24989 has been marked as a duplicate of this bug. *** 102164 7 dburns 2014-03-10 21:45:57 +0000 landed in https://dvcs.w3.org/hg/webdriver/rev/561e13778acb 1441 2014-02-27 23:46:05 +0000 2014-02-27 23:46:05 +0000 frame_switching_patch.txt frame_patch.txt text/plain 8983 luke.semerau IyBIRyBjaGFuZ2VzZXQgcGF0Y2gKIyBVc2VyIEx1a2UgSW5tYW4tU2VtZXJhdSA8bHVrZS5zZW1l cmF1QGdtYWlsLmNvbT4KIyBEYXRlIDEzOTM1MjEwODUgMjg4MDAKIyAgICAgIFRodSBGZWIgMjcg MDk6MTE6MjUgMjAxNCAtMDgwMAojIE5vZGUgSUQgZjFjYTdiYzI2NDgwNDMyZjNlNjgzYzIwMGY3 ZTU2NDMzMGYyMGYzNQojIFBhcmVudCAgYWMxY2FkYzMyNjYxMjdmNWU4ZWQ5Y2EyMDBkNDM5ZmNl ZTgyNGQ2OQppbXBvcnRlZCBwYXRjaCBmcmFtZVN3aXRjaGluZwoKZGlmZiAtciBhYzFjYWRjMzI2 NjEgLXIgZjFjYTdiYzI2NDgwIDA3X3N3aXRjaGluZy5odG1sCi0tLSBhLzA3X3N3aXRjaGluZy5o dG1sCVRodSBGZWIgMjcgMDA6MjY6NDggMjAxNCArMDAwMAorKysgYi8wN19zd2l0Y2hpbmcuaHRt bAlUaHUgRmViIDI3IDA5OjExOjI1IDIwMTQgLTA4MDAKQEAgLTQwLDMyICs0MCw0OSBAQAogICAg IDxkbCBjbGFzcz0naWRsJyB0aXRsZT0ncGFydGlhbCBpbnRlcmZhY2UgV2ViRHJpdmVyJz4KICAg ICAgIDxkdD52b2lkIHN3aXRjaFRvRnJhbWUoKTwvZHQ+CiAgICAgICA8ZGQ+CisgICAgICAgIDx0 YWJsZSBjbGFzcz0ic2ltcGxlIGpzb25jb21tYW5kIj4KKyAgICAgICAgICA8dHI+CisgICAgICAg ICAgICA8dGg+SFRUUCBNZXRob2Q8L3RoPgorICAgICAgICAgICAgPHRoPlBhdGggVGVtcGxhdGU8 L3RoPgorICAgICAgICAgICAgPHRoPk5vdGVzPC90aD4KKyAgICAgICAgICA8L3RyPgorICAgICAg ICAgIDx0cj4KKyAgICAgICAgICAgIDx0ZD5QT1NUPC90ZD4KKyAgICAgICAgICAgIDx0ZD4vc2Vz c2lvbi97c2Vzc2lvbklkfS9mcmFtZTwvdGQ+CisgICAgICAgICAgICA8dGQ+PC90ZD4KKyAgICAg ICAgICA8L3RyPgorICAgICAgICA8L3RhYmxlPgogICAgICAgICA8ZGwgY2xhc3M9J3BhcmFtZXRl cnMnPgotICAgICAgICAgIDxkdD5XZWJFbGVtZW50IG9yIERPTVN0cmluZyBvciBudW1iZXI/IGlk PC9kdD4KKyAgICAgICAgICA8ZHQ+PGE+V2ViRWxlbWVudDwvYT4gb3IgbnVtYmVyPyBpZDwvZHQ+ CiAgICAgICAgICAgPGRkPlRoZSBpZGVudGlmaWVyIHVzZWQgZm9yIGEgZnJhbWUuPC9kZD4KICAg ICAgICAgPC9kbD4KLSAgICAgICAgPHA+VGhlICJzd2l0Y2hUb0ZyYW1lIiBjb21tYW5kIGlzIHVz ZWQgdG8gc2VsZWN0IHdoaWNoIGZyYW1lIHdpdGhpbiBhIHdpbmRvdyBNVVNUIGJlIHVzZWQgYXMg dGhlIGNvbnRleHQgZm9yIGhhbmRsaW5nIGZ1dHVyZSBjb21tYW5kcy4gQWxsIGZyYW1lIHN3aXRj aGluZyBpcyB0YWtlbiBmcm9tIHRoZSBjdXJyZW50IGNvbnRleHQgZnJvbSB3aGljaCBjb21tYW5k cyBhcmUgY3VycmVudGx5IGJlaW5nIGhhbmRsZWQuIFRoZSAiPGNvZGU+aWQ8L2NvZGU+IiBwYXJh bWV0ZXIgY2FuIGJlIG9uZSBvZiBhIHN0cmluZywgbnVtYmVyIG9mIGFuIGVsZW1lbnQuIFdlYkRy aXZlciBpbXBsZW1lbnRhdGlvbnMgTVVTVCBkZXRlcm1pbmUgd2hpY2ggZnJhbWUgdG8gc2VsZWN0 IHVzaW5nIHRoZSBmb2xsb3dpbmcgYWxnb3JpdGhtOgorICAgICAgICA8cD5UaGUgInN3aXRjaFRv RnJhbWUiIGNvbW1hbmQgaXMgdXNlZCB0byBzZWxlY3Qgd2hpY2ggZnJhbWUgd2l0aGluIGEgd2lu ZG93IE1VU1QgYmUgdXNlZCBhcyB0aGUgY29udGV4dCBmb3IgaGFuZGxpbmcgZnV0dXJlIGNvbW1h bmRzLiBBbGwgZnJhbWUgc3dpdGNoaW5nIGlzIHRha2VuIGZyb20gdGhlIGN1cnJlbnQgY29udGV4 dCBmcm9tIHdoaWNoIGNvbW1hbmRzIGFyZSBjdXJyZW50bHkgYmVpbmcgaGFuZGxlZC4gVGhlICI8 Y29kZT5pZDwvY29kZT4iIHBhcmFtZXRlciBjYW4gYmUgYSBudW1iZXIgb3IgYSA8YT5XZWJFbGVt ZW50PC9hPi4gV2ViRHJpdmVyIGltcGxlbWVudGF0aW9ucyBNVVNUIGRldGVybWluZSB3aGljaCBm cmFtZSB0byBzZWxlY3QgdXNpbmcgdGhlIGZvbGxvd2luZyBhbGdvcml0aG06CiAKICAgICAgICAg PG9sPgogICAgICAgICAgIDxsaT5JZiB0aGUgImlkIiBpcyBhIG51bWJlciB0aGUgY3VycmVudCBj b250ZXh0IGlzIHNldCB0byB0aGUgZXF1aXZhbGVudCBvZiB0aGUgSlMgZXhwcmVzc2lvbiAid2lu ZG93LmZyYW1lc1tuXSIgd2hlcmUgIm4iIGlzIHRoZSBudW1iZXIgYW5kICJ3aW5kb3ciIGlzIHRo ZSBET00gd2luZG93IHJlcHJlc2VudGVkIGJ5IHRoZSBjdXJyZW50IGNvbnRleHQuPC9saT4KICAg ICAgICAgICA8bGk+SWYgdGhlICJpZCIgaXMgbnVsbCwgdGhlIGN1cnJlbnQgY29udGV4dCBpcyBz ZXQgdG8gdGhlIGRlZmF1bHQgY29udGV4dC48L2xpPgotICAgICAgICAgIDxsaT5JZiB0aGUgImlk IiBpcyBhIHN0cmluZzoKLSAgICAgICAgICAgIDxvbD4KLSAgICAgICAgICAgICAgPGxpPklmIHRo ZSBKUyBleHByZXNzaW9uICJ3aW5kb3cuZnJhbWVzW2lkXSIgZXZhbHVhdGVkIGluIHRoZSBjdXJy ZW50IGNvbnRleHQgcmV0dXJucyBhIHdpbmRvdywgd2hlcmUgImlkIiBpcyB0aGUgdmFsdWUgb2Yg dGhlIHRoZSAiaWQiIHBhcmFtZXRlciwgdGhlIGN1cnJlbnQgY29udGV4dCBpcyBzZXQgdG8gdGhh dC48L2xpPgotICAgICAgICAgICAgICA8bGk+T3RoZXJ3aXNlIGZvciBlYWNoIHZhbHVlIG9mICJ3 aW5kb3cuZnJhbWVzIiAocmVmZXJyZWQgdG8gYXMgPGNvZGU+d2luPC9jb2RlPik6Ci0gICAgICAg ICAgICAgICAgPG9sPgotICAgICAgICAgICAgICAgICAgPGxpPklmIDxjb2RlPndpbjwvY29kZT4g aGFzIGEgIm5hbWUiIHByb3BlcnR5IG9yIGF0dHJpYnV0ZSBlcXVhbCB0byB0aGUgImlkIiBwYXJh bWV0ZXIsIHRoaXMgYmVjb21lcyB0aGUgY3VycmVudCBjb250ZXh0LjwvbGk+Ci0gICAgICAgICAg ICAgICAgICA8bGk+SWYgPGNvZGU+d2luPC9jb2RlPiBoYXMgYW4gImlkIiBwcm9wZXJ0eSBvciBh dHRyaWJ1dGUgZXF1YWwgdG8gdGhlICJpZCIgcGFyYW1ldGVyLCB0aGlzIGJlY29tZXMgdGhlIGN1 cnJlbnQgY29udGV4dC48L2xpPgotICAgICAgICAgICAgICAgIDwvb2w+Ci0gICAgICAgICAgICAg IDwvbGk+Ci0gICAgICAgICAgICA8L29sPgotICAgICAgICAgIDwvbGk+Ci0gICAgICAgICAgPGxp PklmIHRoZSAiaWQiIHJlcHJlc2VudHMgYSA8Y29kZT5XZWJFbGVtZW50PC9jb2RlPiwgYW5kIHRo ZSBjb3JyZXNwb25kaW5nIERPTSBlbGVtZW50IHJlcHJlc2VudHMgYSBGUkFNRSBvciBhbiBJRlJB TUUsIGFuZCB0aGUgV2ViRWxlbWVudCBpcyBwYXJ0IG9mIHRoZSBjdXJyZW50IGNvbnRleHQsIHRo ZSAid2luZG93IiBwcm9wZXJ0eSBvZiB0aGF0IERPTSBlbGVtZW50IGJlY29tZXMgdGhlIGN1cnJl bnQgY29udGV4dC48L2xpPgorICAgICAgICAgIDxsaT5JZiB0aGUgImlkIiByZXByZXNlbnRzIGEg PGE+V2ViRWxlbWVudDwvYT4sIGFuZCB0aGUgY29ycmVzcG9uZGluZyBET00gZWxlbWVudCByZXBy ZXNlbnRzIGEgRlJBTUUgb3IgYW4gSUZSQU1FLCBhbmQgdGhlIDxhPldlYkVsZW1lbnQ8L2E+IGlz IHBhcnQgb2YgdGhlIGN1cnJlbnQgY29udGV4dCwgdGhlICJ3aW5kb3ciIHByb3BlcnR5IG9mIHRo YXQgRE9NIGVsZW1lbnQgYmVjb21lcyB0aGUgY3VycmVudCBjb250ZXh0LjwvbGk+CiAgICAgICAg IDwvb2w+CiAKICAgICAgICAgPHA+SW4gYWxsIGNhc2VzIGlmIG5vIG1hdGNoIGlzIG1hZGUgYSAi PGNvZGU+PGEgaHJlZj0iI3N0YXR1cy1uby1zdWNoLWZyYW1lIj5ubyBzdWNoIGZyYW1lPC9hPjwv Y29kZT4iIHN0YXR1cyBjb2RlIE1VU1QgYmUgcmV0dXJuZWQuPC9wPgogCiAgICAgICAgIDxwPklm IHRoZSBpbmRpY2F0ZWQgZnJhbWUgZXhpc3RzLCBmcmFtZSBzd2l0Y2hpbmcgTVVTVCBzdWNjZWVk IGV2ZW4gaWYgZG9pbmcgc28gd291bGQgdmlvbGF0ZSB0aGUgbm9ybWFsIHNlY3VyaXR5IGNvbnN0 cmFpbnRzIGluIHBsYWNlIHdpdGhpbiB0aGUgSmF2YXNjcmlwdCBzYW5kYm94LjwvcD48L2RkPgor ICAgICAgPGR0PnZvaWQgc3dpdGNoVG9QYXJlbnRGcmFtZSgpPC9kdD4KKyAgICAgIDxkZD4KKyAg ICAgICAgPHRhYmxlIGNsYXNzPSJzaW1wbGUganNvbmNvbW1hbmQiPgorICAgICAgICAgIDx0cj4K KyAgICAgICAgICAgIDx0aD5IVFRQIE1ldGhvZDwvdGg+CisgICAgICAgICAgICA8dGg+UGF0aCBU ZW1wbGF0ZTwvdGg+CisgICAgICAgICAgICA8dGg+Tm90ZXM8L3RoPgorICAgICAgICAgIDwvdHI+ CisgICAgICAgICAgPHRyPgorICAgICAgICAgICAgPHRkPlBPU1Q8L3RkPgorICAgICAgICAgICAg PHRkPi9zZXNzaW9uL3tzZXNzaW9uSWR9L2ZyYW1lL3BhcmVudDwvdGQ+CisgICAgICAgICAgICA8 dGQ+PC90ZD4KKyAgICAgICAgICA8L3RyPgorICAgICAgICA8L3RhYmxlPgorICAgICAgICA8cD5U aGUgInN3aXRjaFRvUGFyZW50RnJhbWUiIGNvbW1hbmQgTVVTVCBzZXQgdGhlIGNvbnRleHQgb2Yg ZnV0dXJlIGNvbW1hbmRzIHRvIHRoZSA8Y29kZT53aW5kb3cucGFyZW50PC9jb2RlPi4gSWYgdGhl IGN1cnJlbnQgY29udGV4dCBpcyB0aGUgW1shSFRNTDVdXSdzIDxhIGhyZWY9Imh0dHA6Ly93d3cu dzMub3JnL1RSL2h0bWw1L2Jyb3dzZXJzLmh0bWwjdG9wLWxldmVsLWJyb3dzaW5nLWNvbnRleHQi PnRvcCBsZXZlbCBicm93c2luZyBjb250ZXh0PC9hPiwgdGhlIGNvbnRleHQgcmVtYWlucyB1bmNo YW5nZWQuPC9wPgorICAgICAgPC9kZD4KICAgICA8L2RsPgogICA8L3NlY3Rpb24+CiA8L3NlY3Rp b24+CmRpZmYgLXIgYWMxY2FkYzMyNjYxIC1yIGYxY2E3YmMyNjQ4MCB3ZWJkcml2ZXItc3BlYy5o dG1sCi0tLSBhL3dlYmRyaXZlci1zcGVjLmh0bWwJVGh1IEZlYiAyNyAwMDoyNjo0OCAyMDE0ICsw MDAwCisrKyBiL3dlYmRyaXZlci1zcGVjLmh0bWwJVGh1IEZlYiAyNyAwOToxMToyNSAyMDE0IC0w ODAwCkBAIC04NTAsMzIgKzg1MCw0OSBAQAogICAgIDxkbCBjbGFzcz0naWRsJyB0aXRsZT0ncGFy dGlhbCBpbnRlcmZhY2UgV2ViRHJpdmVyJz4KICAgICAgIDxkdD52b2lkIHN3aXRjaFRvRnJhbWUo KTwvZHQ+CiAgICAgICA8ZGQ+CisgICAgICAgIDx0YWJsZSBjbGFzcz0ic2ltcGxlIGpzb25jb21t YW5kIj4KKyAgICAgICAgICA8dHI+CisgICAgICAgICAgICA8dGg+SFRUUCBNZXRob2Q8L3RoPgor ICAgICAgICAgICAgPHRoPlBhdGggVGVtcGxhdGU8L3RoPgorICAgICAgICAgICAgPHRoPk5vdGVz PC90aD4KKyAgICAgICAgICA8L3RyPgorICAgICAgICAgIDx0cj4KKyAgICAgICAgICAgIDx0ZD5Q T1NUPC90ZD4KKyAgICAgICAgICAgIDx0ZD4vc2Vzc2lvbi97c2Vzc2lvbklkfS9mcmFtZTwvdGQ+ CisgICAgICAgICAgICA8dGQ+PC90ZD4KKyAgICAgICAgICA8L3RyPgorICAgICAgICA8L3RhYmxl PgogICAgICAgICA8ZGwgY2xhc3M9J3BhcmFtZXRlcnMnPgotICAgICAgICAgIDxkdD5XZWJFbGVt ZW50IG9yIERPTVN0cmluZyBvciBudW1iZXI/IGlkPC9kdD4KKyAgICAgICAgICA8ZHQ+PGE+V2Vi RWxlbWVudDwvYT4gb3IgbnVtYmVyPyBpZDwvZHQ+CiAgICAgICAgICAgPGRkPlRoZSBpZGVudGlm aWVyIHVzZWQgZm9yIGEgZnJhbWUuPC9kZD4KICAgICAgICAgPC9kbD4KLSAgICAgICAgPHA+VGhl ICJzd2l0Y2hUb0ZyYW1lIiBjb21tYW5kIGlzIHVzZWQgdG8gc2VsZWN0IHdoaWNoIGZyYW1lIHdp dGhpbiBhIHdpbmRvdyBNVVNUIGJlIHVzZWQgYXMgdGhlIGNvbnRleHQgZm9yIGhhbmRsaW5nIGZ1 dHVyZSBjb21tYW5kcy4gQWxsIGZyYW1lIHN3aXRjaGluZyBpcyB0YWtlbiBmcm9tIHRoZSBjdXJy ZW50IGNvbnRleHQgZnJvbSB3aGljaCBjb21tYW5kcyBhcmUgY3VycmVudGx5IGJlaW5nIGhhbmRs ZWQuIFRoZSAiPGNvZGU+aWQ8L2NvZGU+IiBwYXJhbWV0ZXIgY2FuIGJlIG9uZSBvZiBhIHN0cmlu ZywgbnVtYmVyIG9mIGFuIGVsZW1lbnQuIFdlYkRyaXZlciBpbXBsZW1lbnRhdGlvbnMgTVVTVCBk ZXRlcm1pbmUgd2hpY2ggZnJhbWUgdG8gc2VsZWN0IHVzaW5nIHRoZSBmb2xsb3dpbmcgYWxnb3Jp dGhtOgorICAgICAgICA8cD5UaGUgInN3aXRjaFRvRnJhbWUiIGNvbW1hbmQgaXMgdXNlZCB0byBz ZWxlY3Qgd2hpY2ggZnJhbWUgd2l0aGluIGEgd2luZG93IE1VU1QgYmUgdXNlZCBhcyB0aGUgY29u dGV4dCBmb3IgaGFuZGxpbmcgZnV0dXJlIGNvbW1hbmRzLiBBbGwgZnJhbWUgc3dpdGNoaW5nIGlz IHRha2VuIGZyb20gdGhlIGN1cnJlbnQgY29udGV4dCBmcm9tIHdoaWNoIGNvbW1hbmRzIGFyZSBj dXJyZW50bHkgYmVpbmcgaGFuZGxlZC4gVGhlICI8Y29kZT5pZDwvY29kZT4iIHBhcmFtZXRlciBj YW4gYmUgYSBudW1iZXIgb3IgYSA8YT5XZWJFbGVtZW50PC9hPi4gV2ViRHJpdmVyIGltcGxlbWVu dGF0aW9ucyBNVVNUIGRldGVybWluZSB3aGljaCBmcmFtZSB0byBzZWxlY3QgdXNpbmcgdGhlIGZv bGxvd2luZyBhbGdvcml0aG06CiAKICAgICAgICAgPG9sPgogICAgICAgICAgIDxsaT5JZiB0aGUg ImlkIiBpcyBhIG51bWJlciB0aGUgY3VycmVudCBjb250ZXh0IGlzIHNldCB0byB0aGUgZXF1aXZh bGVudCBvZiB0aGUgSlMgZXhwcmVzc2lvbiAid2luZG93LmZyYW1lc1tuXSIgd2hlcmUgIm4iIGlz IHRoZSBudW1iZXIgYW5kICJ3aW5kb3ciIGlzIHRoZSBET00gd2luZG93IHJlcHJlc2VudGVkIGJ5 IHRoZSBjdXJyZW50IGNvbnRleHQuPC9saT4KICAgICAgICAgICA8bGk+SWYgdGhlICJpZCIgaXMg bnVsbCwgdGhlIGN1cnJlbnQgY29udGV4dCBpcyBzZXQgdG8gdGhlIGRlZmF1bHQgY29udGV4dC48 L2xpPgotICAgICAgICAgIDxsaT5JZiB0aGUgImlkIiBpcyBhIHN0cmluZzoKLSAgICAgICAgICAg IDxvbD4KLSAgICAgICAgICAgICAgPGxpPklmIHRoZSBKUyBleHByZXNzaW9uICJ3aW5kb3cuZnJh bWVzW2lkXSIgZXZhbHVhdGVkIGluIHRoZSBjdXJyZW50IGNvbnRleHQgcmV0dXJucyBhIHdpbmRv dywgd2hlcmUgImlkIiBpcyB0aGUgdmFsdWUgb2YgdGhlIHRoZSAiaWQiIHBhcmFtZXRlciwgdGhl IGN1cnJlbnQgY29udGV4dCBpcyBzZXQgdG8gdGhhdC48L2xpPgotICAgICAgICAgICAgICA8bGk+ T3RoZXJ3aXNlIGZvciBlYWNoIHZhbHVlIG9mICJ3aW5kb3cuZnJhbWVzIiAocmVmZXJyZWQgdG8g YXMgPGNvZGU+d2luPC9jb2RlPik6Ci0gICAgICAgICAgICAgICAgPG9sPgotICAgICAgICAgICAg ICAgICAgPGxpPklmIDxjb2RlPndpbjwvY29kZT4gaGFzIGEgIm5hbWUiIHByb3BlcnR5IG9yIGF0 dHJpYnV0ZSBlcXVhbCB0byB0aGUgImlkIiBwYXJhbWV0ZXIsIHRoaXMgYmVjb21lcyB0aGUgY3Vy cmVudCBjb250ZXh0LjwvbGk+Ci0gICAgICAgICAgICAgICAgICA8bGk+SWYgPGNvZGU+d2luPC9j b2RlPiBoYXMgYW4gImlkIiBwcm9wZXJ0eSBvciBhdHRyaWJ1dGUgZXF1YWwgdG8gdGhlICJpZCIg cGFyYW1ldGVyLCB0aGlzIGJlY29tZXMgdGhlIGN1cnJlbnQgY29udGV4dC48L2xpPgotICAgICAg ICAgICAgICAgIDwvb2w+Ci0gICAgICAgICAgICAgIDwvbGk+Ci0gICAgICAgICAgICA8L29sPgot ICAgICAgICAgIDwvbGk+Ci0gICAgICAgICAgPGxpPklmIHRoZSAiaWQiIHJlcHJlc2VudHMgYSA8 Y29kZT5XZWJFbGVtZW50PC9jb2RlPiwgYW5kIHRoZSBjb3JyZXNwb25kaW5nIERPTSBlbGVtZW50 IHJlcHJlc2VudHMgYSBGUkFNRSBvciBhbiBJRlJBTUUsIGFuZCB0aGUgV2ViRWxlbWVudCBpcyBw YXJ0IG9mIHRoZSBjdXJyZW50IGNvbnRleHQsIHRoZSAid2luZG93IiBwcm9wZXJ0eSBvZiB0aGF0 IERPTSBlbGVtZW50IGJlY29tZXMgdGhlIGN1cnJlbnQgY29udGV4dC48L2xpPgorICAgICAgICAg IDxsaT5JZiB0aGUgImlkIiByZXByZXNlbnRzIGEgPGE+V2ViRWxlbWVudDwvYT4sIGFuZCB0aGUg Y29ycmVzcG9uZGluZyBET00gZWxlbWVudCByZXByZXNlbnRzIGEgRlJBTUUgb3IgYW4gSUZSQU1F LCBhbmQgdGhlIDxhPldlYkVsZW1lbnQ8L2E+IGlzIHBhcnQgb2YgdGhlIGN1cnJlbnQgY29udGV4 dCwgdGhlICJ3aW5kb3ciIHByb3BlcnR5IG9mIHRoYXQgRE9NIGVsZW1lbnQgYmVjb21lcyB0aGUg Y3VycmVudCBjb250ZXh0LjwvbGk+CiAgICAgICAgIDwvb2w+CiAKICAgICAgICAgPHA+SW4gYWxs IGNhc2VzIGlmIG5vIG1hdGNoIGlzIG1hZGUgYSAiPGNvZGU+PGEgaHJlZj0iI3N0YXR1cy1uby1z dWNoLWZyYW1lIj5ubyBzdWNoIGZyYW1lPC9hPjwvY29kZT4iIHN0YXR1cyBjb2RlIE1VU1QgYmUg cmV0dXJuZWQuPC9wPgogCiAgICAgICAgIDxwPklmIHRoZSBpbmRpY2F0ZWQgZnJhbWUgZXhpc3Rz LCBmcmFtZSBzd2l0Y2hpbmcgTVVTVCBzdWNjZWVkIGV2ZW4gaWYgZG9pbmcgc28gd291bGQgdmlv bGF0ZSB0aGUgbm9ybWFsIHNlY3VyaXR5IGNvbnN0cmFpbnRzIGluIHBsYWNlIHdpdGhpbiB0aGUg SmF2YXNjcmlwdCBzYW5kYm94LjwvcD48L2RkPgorICAgICAgPGR0PnZvaWQgc3dpdGNoVG9QYXJl bnRGcmFtZSgpPC9kdD4KKyAgICAgIDxkZD4KKyAgICAgICAgPHRhYmxlIGNsYXNzPSJzaW1wbGUg anNvbmNvbW1hbmQiPgorICAgICAgICAgIDx0cj4KKyAgICAgICAgICAgIDx0aD5IVFRQIE1ldGhv ZDwvdGg+CisgICAgICAgICAgICA8dGg+UGF0aCBUZW1wbGF0ZTwvdGg+CisgICAgICAgICAgICA8 dGg+Tm90ZXM8L3RoPgorICAgICAgICAgIDwvdHI+CisgICAgICAgICAgPHRyPgorICAgICAgICAg ICAgPHRkPlBPU1Q8L3RkPgorICAgICAgICAgICAgPHRkPi9zZXNzaW9uL3tzZXNzaW9uSWR9L2Zy YW1lL3BhcmVudDwvdGQ+CisgICAgICAgICAgICA8dGQ+PC90ZD4KKyAgICAgICAgICA8L3RyPgor ICAgICAgICA8L3RhYmxlPgorICAgICAgICA8cD5UaGUgInN3aXRjaFRvUGFyZW50RnJhbWUiIGNv bW1hbmQgTVVTVCBzZXQgdGhlIGNvbnRleHQgb2YgZnV0dXJlIGNvbW1hbmRzIHRvIHRoZSA8Y29k ZT53aW5kb3cucGFyZW50PC9jb2RlPi4gSWYgdGhlIGN1cnJlbnQgY29udGV4dCBpcyB0aGUgW1sh SFRNTDVdXSdzIDxhIGhyZWY9Imh0dHA6Ly93d3cudzMub3JnL1RSL2h0bWw1L2Jyb3dzZXJzLmh0 bWwjdG9wLWxldmVsLWJyb3dzaW5nLWNvbnRleHQiPnRvcCBsZXZlbCBicm93c2luZyBjb250ZXh0 PC9hPiwgdGhlIGNvbnRleHQgcmVtYWlucyB1bmNoYW5nZWQuPC9wPgorICAgICAgPC9kZD4KICAg ICA8L2RsPgogICA8L3NlY3Rpb24+CiA8L3NlY3Rpb24+Cg==