22987 2013-08-16 23:06:53 +0000 Proposal: Shadow DOM support in WebDriver 2018-06-21 11:07:12 +0000 1 1 1 Unclassified Browser Test/Tools WG WebDriver unspecified PC All NEW https://docs.google.com/document/d/1qP7Se3MDUac5P0V1Kfm2yaj3fFhBOFCyWyXLcsVwkTA/edit?usp=sharing P2 normal --- 24121 1 fisherii public-browser-tools-testing chrisgao martijn.martijn mike travispaez100 w3 w3bugs public-browser-tools-testing oldest_to_newest 92205 0 fisherii 2013-08-16 23:06:53 +0000 The current proposal for dealing with Web Components and their corresponding Shadow DOMs in WebDriver treats them similarly to frames; at any point in time the WebDriver session is operating within a particular DOM, either the top-level DOM or one of the Shadow DOMs of a particular Web Component. However, this makes interacting with pages that use Web Components extremely taxing, as the current DOM will have to be switched on a regular basis, and it is unclear over what time frame an element id found within a particular DOM will be considered valid. Instead I propose that the WebDriver wire protocol be extended with commands to get the list of attached Shadow DOMs for an elements as opaques IDs and to support new element and elements commands that are scoped to a particular DOM. Additionally, element IDs from Shadow DOMs be completely accessible as long they are the corresponding element attached to the Shadow DOM and the Shadow DOM is attached to the page. For a more thorough description see: https://docs.google.com/document/d/1qP7Se3MDUac5P0V1Kfm2yaj3fFhBOFCyWyXLcsVwkTA/edit?usp=sharing 93695 1 1400 chrisgao 2013-09-23 22:42:57 +0000 Created attachment 1400 Patch for Shadow Dom and WebEelement lifetime Do we want to make it explicit in spec which commands are supported with Shadow DOM roots? eg.: FindElement, FindElements, ExecuteScript, ExecuteAsyncScript, GetActiveElement and the like. 94913 2 fisherii 2013-10-17 22:19:20 +0000 Of the current commands that take a WebElement: findElement and findElements: Search scoped to the Shadow DOM. execute[Async]Script: if a Shadow DOM root is passed as parameter it should be resolved to the correct ShadowRoot instance (http://www.w3.org/TR/shadow-dom/#shadow-root-object). Any other command that takes an element id (e.g. isSelected, getElementAttribute, getText) should throw an exception if passed a Shadow DOM root. None of the current set of status codes seem appropriate, so maybe add a new one "operation not supported on shadow dom root". It may be reasonable to add an optional element id parameter to the following commands: getActiveElement: returns ShadowRoot.activeElement getSource: returns ShadowRoot.innerHTML If added, these commands should probably throw an exception if the element id doesn't correspond to a shadow dom root: "operation only supported on shadow dom root". 97622 3 1420 chrisgao 2013-12-14 21:38:37 +0000 Created attachment 1420 Patch for Shadow Dom and WebEelement/ShadowRoot lifetime(v2) Update the patch for shadow dom according to the discussion in the F2F meeting at TPAC 2013. 1400 2013-09-23 22:42:57 +0000 2013-12-14 21:38:37 +0000 Patch for Shadow Dom and WebEelement lifetime shadow_dom.patch text/plain 4459 chrisgao ZGlmZiAtciAwNDg2ZGI1NjMwODAgMDdfc3dpdGNoaW5nLmh0bWwKLS0tIGEvMDdfc3dpdGNoaW5n Lmh0bWwJVHVlIFNlcCAxNyAxNTo0NzoxNCAyMDEzICswMTAwCisrKyBiLzA3X3N3aXRjaGluZy5o dG1sCU1vbiBTZXAgMjMgMTM6NDc6MDkgMjAxMyAtMDcwMApAQCAtOTMsNDMgKzkzLDQgQEAKIAog PC9zZWN0aW9uPgogCi08c2VjdGlvbj4KLQk8aDI+U3dpdGNoaW5nIHRvIEhvc3RlZCBTaGFkb3cg RE9NczwvaDI+Ci0KLQk8dGFibGUgY2xhc3M9InNpbXBsZSI+Ci0JCTx0cj4KLQkJCTx0aD5DYXBh YmlsaXR5IE5hbWU8L3RoPjx0aD5UeXBlPC90aD4KLQkJPC90cj4KLQkJPHRyPgotCQkJPHRkPjxz cGFuIGNsYXNzPSJjYXBhYmlsaXR5LXNoYWRvd0RvbSI+c2hhZG93RG9tPC9zcGFuPjwvdGQ+PHRk PmJvb2xlYW48L3RkPgotCQk8L3RyPgotCTwvdGFibGU+Ci0KLQk8cD5JZiBhIGJyb3dzZXIgaW1w bGVtZW50cyB0aGUgU2hhZG93IERPTSBzcGVjaWZpY2F0aW9uLCBpdCBNVVNUIHN1cHBvcnQgdGhl IGFiaWxpdHkgdG8gYWNjZXNzIHNoYWRvdyBzdWJ0cmVlcy4gVGhpcyBpcyBkb25lIHVzaW5nIHRo ZSBzd2l0Y2hUb1N1YlRyZWUgY29tbWFuZDo8L3A+Ci0KLQk8dGFibGUgY2xhc3M9InNpbXBsZSI+ Ci0JCTx0cj4KLQkJCTx0ZD5Db21tYW5kIE5hbWU8L3RkPgotCQkJPHRkPnN3aXRjaFRvU3ViVHJl ZTwvdGQ+Ci0JCTwvdHI+Ci0JCTx0cj4KLQkJCTx0ZD5QYXJhbWV0ZXJzPC90ZD4KLQkJCTx0ZD4i ZWxlbWVudCIgeyFXZWJFbGVtZW50PX0gVGhlIHNoYWRvdyBob3N0Ljxicj4KLQkJCQkiaW5kZXgi IHtpbnR9IFRoZSBpbmRleCBvZiB0aGUgc2hhZG93IHN1YnRyZWUuIERlZmF1bHRzIHRvIDAuPC90 ZD4KLQkJPC90cj4KLQkJPHRyPgotCSAgICAJPHRkPlJldHVybiBWYWx1ZTwvdGQ+Ci0JICAgCQk8 dGQ+Tm9uZTwvdGQ+Ci0JCTwvdHI+Ci0JCTx0cj4KLQkgICAgCTx0ZD5FcnJvcnM8L3RkPgotCSAg ICAJPHRkPjxjb2RlPjxhIGhyZWY9IiNzdGF0dXMtbm8tc3VjaC1kb20iPm5vIHN1Y2ggZG9tPC9h PjwvY29kZT4gaWYgdGhlIGVsZW1lbnQgaXMgbm90IGEgc2hhZG93IGhvc3QsIG9yIGlmIHRoZSBp bmRleGVkIHNoYWRvdyBzdWJ0cmVlIGRvZXMgbm90IGV4aXN0LjwvdGQ+Ci0JCTwvdHI+Ci0JPC90 YWJsZT4KLQotPHA+V2hlbiBleGVjdXRpbmcgdGhpcyBjb21tYW5kLCBTaGFkb3cgRE9NIHN1YnRy ZWVzIGFyZSBpbmRleGVkIGluIHRoZSBvcmRlciB0aGF0IHRoZXkgd2VyZSBhZGRlZCB0byB0aGUg aG9zdC4gVGhhdCBpcywgdGhlICJvbGRlc3QiIHN1YnRyZWUgaXMgYXQgaW5kZXggMCwgYW5kIHRo ZSAieW91bmdlc3QiIHN1YnRyZWUgYXQgdGhlIGhpZ2hlc3Qgc2VxdWVudGlhbGx5IG51bWJlcmVk IGluZGV4LjwvcD4KLQotPHA+V2hlcmUgdGhlIFNoYWRvdyBET00gaXMgc3VwcG9ydGVkLCBhbGwg Y29tbWFuZHMgaW4gV2ViRHJpdmVyIE1VU1Qgb3BlcmF0ZSBvbiB0aGUgY3VycmVudGx5IHNlbGVj dGVkIFNoYWRvdyBET00gc3VidHJlZSB1bmxlc3MgdGhlIGNvbW1hbmQgaXRzZWxmIGRlY2xhcmVz IG90aGVyd2lzZS48L3A+CiA8L3NlY3Rpb24+Ci0KLTwvc2VjdGlvbj4KZGlmZiAtciAwNDg2ZGI1 NjMwODAgMDlfZWxlbWVudHMuaHRtbAotLS0gYS8wOV9lbGVtZW50cy5odG1sCVR1ZSBTZXAgMTcg MTU6NDc6MTQgMjAxMyArMDEwMAorKysgYi8wOV9lbGVtZW50cy5odG1sCU1vbiBTZXAgMjMgMTM6 NDc6MDkgMjAxMyAtMDcwMApAQCAtMjYsNiArMjYsMTcgQEAKICAgdGhlc2UgbG9jYXRlZCBlbGVt ZW50cy4gVGhlIHByaW1hcnkgaW50ZXJmYWNlIHVzZWQgYnkgdGhlIFdlYkRyaXZlciBBUEkgZm9y IGxvY2F0aW5nIGVsZW1lbnRzIGlzIHRoZSAKICAgPGNvZGU+U2VhcmNoQ29udGV4dDwvY29kZT4u PC9wPgogICA8c2VjdGlvbj4KKyAgICA8aDI+TGlmZXRpbWUgb2YgYSBXZWJFbGVtZW50PC9oMj4K KyAgICA8cD5BIERPTSBub2RlLCB3aGV0aGVyIGl0IGlzIGluIHRoZSB0b3AtbGV2ZWwgRE9NIG9y IGEgU2hhZG93IERPTSwgd2lsbCBiZSBhY2Nlc3NpYmxlIGFzIGxvbmcgYXMgYm90aCBvZiB0aGUg Zm9sbG93aW5nIGFyZSB0cnVlOgorICAgIDx1bD4KKyAgICAgIDxsaT5UaGUgRE9NIG5vZGUgaXMg c3RpbGwgYXR0YWNoZWQgdG8gaXRzIGNvcnJlc3BvbmRpbmcgRE9NIHRyZWUuPC9saT4KKyAgICAg IDxsaT5Gb3IgdGhlIERPTSB0cmVlIHRoYXQgdGhlIERPTSBub2RlIGlzIGF0dGFjaGVkIHRvLCBp dCBpcyBlaXRoZXIgdGhlIHRvcC1sZXZlbCBET00gdHJlZSBmb3IgdGhlIGN1cnJlbnQgcGFnZSBv ciBhdHRhY2hlZCB0byBhIERPTSBub2RlIHRoYXQgaXMgYWNjZXNzaWJsZS48L2xpPgorICAgIDwv dWw+CisgICAgPC9wPgorICAgIDxwPlRoZSBsaWZldGltZSBvZiBhIHJldHVybmVkIDxhPldlYkVs ZW1lbnQ8L2E+IHJlZmVyZW5jZSBpcyBjb25maW5lZCB0byB0aGUgYWNjZXNzaWJpbGl0eSBvZiBp dHMgY29ycmVzcG9uZGluZyBET00gbm9kZS4gSWYgYSA8YT5XZWJFbGVtZW50PC9hPiB0aGF0IGNv cnJlc3BvbmRzIHRvIGFuIGluYWNjZXNzaWJsZSBET00gbm9kZSBpcyBhY2Nlc3NlZCBpbiBhbnkg V2ViRHJpdmVyIGNvbW1hbmQsIHRoZW4gYSA8YSBocmVmPSIjc3RhdHVzLXN0YWxlLWVsZW1lbnQt cmVmZXJlbmNlIj5zdGFsZSBlbGVtZW50IHJlZmVyZW5jZTwvYT4gZXJyb3Igd2lsbCBiZSByZXR1 cm5lZCBmb3IgdGhhdCBjb21tYW5kLjwvcD4KKyAgICAKKyAgPC9zZWN0aW9uPgorICA8c2VjdGlv bj4KICAgICA8aDI+TGlzdHMgb2YgV2ViRWxlbWVudHM8L2gyPgogICAgIAogICAgIDxwPlRoZSBw cmltYXJ5IGdyb3VwaW5nIG9mIDxhPldlYkVsZW1lbnQ8L2E+IGluc3RhbmNlcyBpcyBhbiA8Y29k ZT5hcnJheTwvY29kZT4gb2YgPGE+V2ViRWxlbWVudDwvYT4gaW5zdGFuY2VzPC9wPgpAQCAtNTEs NiArNjIsNDEgQEAKICAgPC9zZWN0aW9uPgogCiAgIDxzZWN0aW9uPgorICAgIDxoMj5MaXN0IG9m IEhvc3RlZCBTaGFkb3cgRE9NIHJvb3RzPC9oMj4KKworICAgIDx0YWJsZSBjbGFzcz0ic2ltcGxl Ij4KKyAgICAgIDx0cj4KKyAgICAgICAgPHRoPkNhcGFiaWxpdHkgTmFtZTwvdGg+PHRoPlR5cGU8 L3RoPgorICAgICAgPC90cj4KKyAgICAgIDx0cj4KKyAgICAgICAgPHRkPjxzcGFuIGNsYXNzPSJj YXBhYmlsaXR5LXNoYWRvd0RvbSI+c2hhZG93RG9tPC9zcGFuPjwvdGQ+PHRkPmJvb2xlYW48L3Rk PgorICAgICAgPC90cj4KKyAgICA8L3RhYmxlPgorCisgICAgPHA+SWYgYSBicm93c2VyIGltcGxl bWVudHMgdGhlIFNoYWRvdyBET00gc3BlY2lmaWNhdGlvbiwgaXQgTVVTVCBzdXBwb3J0IHRoZSBh YmlsaXR5IHRvIGFjY2VzcyBzaGFkb3cgc3VidHJlZXMuIFRoZSByb290IG9mIGEgc2hhZG93IHN1 YnRyZWUgaXMgcmV0dXJuZWQgYXMgYSA8YT5XZWJFbGVtZW50PC9hPi4gVGhpcyBpcyBkb25lIHVz aW5nIHRoZSBnZXRTaGFkb3dSb290cyBjb21tYW5kOjwvcD4KKworICAgIDx0YWJsZSBjbGFzcz0i c2ltcGxlIj4KKyAgICAgIDx0cj4KKyAgICAgICAgPHRkPkNvbW1hbmQgTmFtZTwvdGQ+CisgICAg ICAgIDx0ZD5nZXRTaGFkb3dSb290czwvdGQ+CisgICAgICA8L3RyPgorICAgICAgPHRyPgorICAg ICAgICA8dGQ+UGFyYW1ldGVyczwvdGQ+CisgICAgICAgIDx0ZD4iZWxlbWVudCIgeyFXZWJFbGVt ZW50PX0gVGhlIHNoYWRvdyBob3N0LjwvdGQ+CisgICAgICA8L3RyPgorICAgICAgPHRyPgorICAg ICAgICA8dGQ+UmV0dXJuIFZhbHVlPC90ZD4KKyAgICAgICAgPHRkPkEgbGlzdCBvZiB7V2ViRWxl bWVudH0sIGVhY2ggb2Ygd2hpY2ggcmVwcmVzZW50cyB0aGUgcm9vdCBvZiBhIFNoYWRvdyBET00g c3VidHJlZS4gVGhlIGxpc3QgY29udGFpbnMgYXQgbGVhc3Qgb25lIGVsZW1lbnQuPC90ZD4KKyAg ICAgIDwvdHI+CisgICAgICA8dHI+CisgICAgICAgIDx0ZD5FcnJvcnM8L3RkPgorICAgICAgICA8 dGQ+PGNvZGU+PGEgaHJlZj0iI3N0YXR1cy1uby1zdWNoLWRvbSI+bm8gc3VjaCBkb208L2E+PC9j b2RlPiBpZiB0aGUgZWxlbWVudCBpcyBub3QgYSBzaGFkb3cgaG9zdC48L3RkPgorICAgICAgPC90 cj4KKyAgICA8L3RhYmxlPgorCisgICAgPHA+VGhlIFNoYWRvdyByb290cyBpbiB0aGUgcmV0dXJu ZWQgbGlzdCBhcmUgaW4gcmV2ZXJzZSBvcmRlciB0aGF0IHRoZXkgd2VyZSBhZGRlZCB0byB0aGUg aG9zdC4gVGhlICJ5b3VuZ2VzdCIgaXMgYXQgdGhlIGJlZ2lubmluZyBvZiB0aGUgbGlzdCwgYW5k IHRoZSAib2xkZXN0IiBvbmUgYXQgdGhlIGVuZCBvZiB0aGUgbGlzdC48L3A+CisgIDwvc2VjdGlv bj4KKyAgPHNlY3Rpb24+CiAgICAgPGgyPkVsZW1lbnQgTG9jYXRpb24gU3RyYXRlZ2llczwvaDI+ CiAKICAgICA8cD5BbGwgZWxlbWVudCBsb2NhdGlvbiBzdHJhdGVnaWVzIE1VU1QgcmV0dXJuIGVs ZW1lbnRzIGluIHRoZSBvcmRlciBpbiB3aGljaCB0aGV5IGFwcGVhciBpbiB0aGUgY3VycmVudCBk b2N1bWVudC48L3A+Cg== 1420 2013-12-14 21:38:37 +0000 2018-06-21 11:07:12 +0000 Patch for Shadow Dom and WebEelement/ShadowRoot lifetime(v2) shadow_dom.patch text/plain 4650 chrisgao ZGlmZiAtciAwNDc1OTU2NjhiYmMgMDJfY29tbWFuZHMuaHRtbAotLS0gYS8wMl9jb21tYW5kcy5o dG1sCUZyaSBOb3YgMjIgMjM6MTg6NDggMjAxMyArMDAwMAorKysgYi8wMl9jb21tYW5kcy5odG1s CVNhdCBEZWMgMTQgMTM6MjU6NTIgMjAxMyAtMDgwMApAQCAtMTAyLDEwICsxMDIsNiBAQAogICAg ICAgICA8dGQ+QW4gYXR0ZW1wdCB3YXMgbWFkZSB0byBvcGVyYXRlIG9uIGEgbW9kYWwgZGlhbG9n IHdoZW4gb25lIHdhcyBub3Qgb3Blbi48L3RkPgogICAgICAgPC90cj4KICAgICAgIDx0cj4KLSAg ICAgICAgPHRkPjxkZm4gaWQ9InN0YXR1cy1uby1zdWNoLWRvbSI+bm8gc3VjaCBkb208L2Rmbj48 L3RkPgotICAgICAgICA8dGQ+QW4gYXR0ZW1wdCB3YXMgbWFkZSB0byBzd2l0Y2ggdG8gYSBob3N0 ZWQgU2hhZG93IERPTSB0aGF0IGRvZXMgbm90IGV4aXN0LjwvdGQ+Ci0gICAgICA8L3RyPgotICAg ICAgPHRyPgogICAgICAgICA8dGQ+PGRmbiBpZD0ic3RhdHVzLW5vLXN1Y2gtZWxlbWVudCI+bm8g c3VjaCBlbGVtZW50PC9kZm4+PC90ZD4KICAgICAgICAgPHRkPkFuIGVsZW1lbnQgY291bGQgbm90 IGJlIGxvY2F0ZWQgb24gdGhlIHBhZ2UgdXNpbmcgdGhlIGdpdmVuIHNlYXJjaCBwYXJhbWV0ZXJz LjwvdGQ+CiAgICAgICA8L3RyPgpAQCAtMTMwLDYgKzEyNiwxMCBAQAogICAgICAgICA8dGQ+QW4g ZWxlbWVudCBjb21tYW5kIGZhaWxlZCBiZWNhdXNlIHRoZSByZWZlcmVuY2VkIGVsZW1lbnQgaXMg bm8gbG9uZ2VyIGF0dGFjaGVkIHRvIHRoZSBET00uPC90ZD4KICAgICAgIDwvdHI+CiAgICAgICA8 dHI+CisgICAgICAgIDx0ZD48ZGZuIGlkPSJzdGF0dXMtc3RhbGUtc2hhZG93LXJvb3QtcmVmZXJl bmNlIj5zdGFsZSBzaGFkb3cgcm9vdCByZWZlcmVuY2U8L2Rmbj48L3RkPgorICAgICAgICA8dGQ+ QW4gY29tbWFuZCBmYWlsZWQgYmVjYXVzZSB0aGUgcmVmZXJlbmNlZCBzaGFkb3cgcm9vdCBpcyBu byBsb25nZXIgYXR0YWNoZWQgdG8gdGhlIERPTS48L3RkPgorICAgICAgPC90cj4KKyAgICAgIDx0 cj4KICAgICAgICAgPHRkPjxkZm4gaWQ9InN0YXR1cy1zdWNjZXNzIj5zdWNjZXNzPC9kZm4+PC90 ZD4KICAgICAgICAgPHRkPlRoZSBjb21tYW5kIGV4ZWN1dGVkIHN1Y2Nlc3NmdWxseS48L3RkPgog ICAgICAgPC90cj4KZGlmZiAtciAwNDc1OTU2NjhiYmMgMDlfZWxlbWVudHMuaHRtbAotLS0gYS8w OV9lbGVtZW50cy5odG1sCUZyaSBOb3YgMjIgMjM6MTg6NDggMjAxMyArMDAwMAorKysgYi8wOV9l bGVtZW50cy5odG1sCVNhdCBEZWMgMTQgMTM6MjU6NTIgMjAxMyAtMDgwMApAQCAtNDIsNyArNDIs NyBAQAogICAgIDwvZGw+CiAgIDwvc2VjdGlvbj4KICAgPHNlY3Rpb24+Ci0gICAgPGRsIGNsYXNz PSJpZGwiIHRpdGxlPSJpbnRlcmZhY2UgU2VhY2hDb250ZXh0Ij4KKyAgICA8ZGwgY2xhc3M9Imlk bCIgdGl0bGU9ImludGVyZmFjZSBTZWFyY2hDb250ZXh0Ij4KICAgICAgIDxkdD5XZWJFbGVtZW50 W10gZmluZEVsZW1lbnRzKGluIExvY2F0b3IgbG9jYXRvcik8L2R0PgogICAgICAgPGRkPjwvZGQ+ CiAgICAgICA8ZHQ+V2ViRWxlbWVudCBmaW5kRWxlbWVudChpbiBMb2NhdG9yIGxvY2F0b3IpPC9k dD4KQEAgLTEzMiw0ICsxMzIsNDQgQEAKICAgICAgIDxwPkFsbCBXZWJEcml2ZXIgaW1wbGVtZW50 YXRpb25zIE1VU1Qgc3VwcG9ydCBmaW5kaW5nIGVsZW1lbnRzIGJ5IFhQYXRoIDEuMCBbWyFYUEFU SF1dIHdpdGggdGhlIDxhIGhyZWY9Imh0dHA6Ly9kZXYudzMub3JnL2h0bWw1L3NwZWMvT3ZlcnZp ZXcuaHRtbCNpbnRlcmFjdGlvbnMtd2l0aC14cGF0aC1hbmQteHNsdCI+ZWRpdHMgZnJvbSBzZWN0 aW9uIDMuMzwvYT4gb2YgdGhlIFtbIUhUTUw1XV0gc3BlY2lmaWNhdGlvbiBtYWRlLiBJZiBubyBu YXRpdmUgc3VwcG9ydCBpcyBwcmVzZW50IGluIHRoZSBicm93c2VyLCBhIHB1cmUgSlMgaW1wbGVt ZW50YXRpb24gTUFZIGJlIHVzZWQuIFdoZW4gY2FsbGVkLCB0aGUgcmV0dXJuZWQgdmFsdWVzIE1V U1QgYmUgZXF1aXZhbGVudCBvZiBjYWxsaW5nICI8YSBocmVmPSJodHRwOi8vd3d3LnczLm9yZy9U Ui9ET00tTGV2ZWwtMy1YUGF0aC94cGF0aC5odG1sI1hQYXRoRXZhbHVhdG9yLWV2YWx1YXRlIj5l dmFsdWF0ZTwvYT4iIGZ1bmN0aW9uIGZyb20gdGhlIERPTSBMZXZlbCAzIFhQYXRoIHNwZWMgW1tE T00tTEVWRUwtMy1YUEFUSF1dIHdpdGggdGhlIHJlc3VsdCB0eXBlIHNldCB0byAiPGEgaHJlZj0i aHR0cDovL3d3dy53My5vcmcvVFIvRE9NLUxldmVsLTMtWFBhdGgveHBhdGguaHRtbCNYUGF0aFJl c3VsdC1PUkRFUkVELU5PREUtU05BUFNIT1QtVFlQRSI+T1JERVJFRF9OT0RFX1NOQVBTSE9UX1RZ UEU8L2E+ICg3KS48L3A+CiAgICAgPC9zZWN0aW9uPgogICA8L3NlY3Rpb24+CisKKyAgPHNlY3Rp b24+CisgICAgPGgyPkxpc3Qgb2YgSG9zdGVkIFNoYWRvdyBSb290czwvaDI+CisgICAgPHRhYmxl IGNsYXNzPSJzaW1wbGUiPgorICAgICAgPHRyPgorICAgICAgICA8dGg+Q2FwYWJpbGl0eSBOYW1l PC90aD48dGg+VHlwZTwvdGg+CisgICAgICA8L3RyPgorICAgICAgPHRyPgorICAgICAgICA8dGQ+ PHNwYW4gY2xhc3M9ImNhcGFiaWxpdHktc2hhZG93RG9tIj5zaGFkb3dEb208L3NwYW4+PC90ZD48 dGQ+Ym9vbGVhbjwvdGQ+CisgICAgICA8L3RyPgorICAgIDwvdGFibGU+CisKKyAgICA8cD5JZiBh IGJyb3dzZXIgaW1wbGVtZW50cyB0aGUgU2hhZG93IERPTSBzcGVjaWZpY2F0aW9uLCBpdCBNVVNU IHN1cHBvcnQgdGhlCisgICAgYWJpbGl0eSB0byBhY2Nlc3Mgc2hhZG93IHN1YnRyZWVzLiBUaGUg cm9vdCBvZiBhIHNoYWRvdyBzdWJ0cmVlIGlzIHJldHVybmVkCisgICAgYXMgYSA8YT5TaGFkb3dS b290PC9hPi48L3A+CisKKyAgICA8ZGwgY2xhc3M9ImlkbCIgdGl0bGU9ImludGVyZmFjZSBTaGFk b3dSb290IDogU2VhcmNoQ29udGV4dCI+CisgICAgICA8ZHQ+cmVhZG9ubHkgYXR0cmlidXRlIERP TVN0cmluZyBpZDwvZHQ+CisgICAgICA8ZGQ+VGhlIFdlYkRyaXZlciBJRCBvZiB0aGlzIHBhcnRp Y3VsYXIgc2hhZG93IHJvb3QuIFRoaXMgU0hPVUxEIGJlIGEgVVVJRC48L2RkPgorICAgICAgPGR0 PldlYkVsZW1lbnQgZ2V0QWN0aXZlRWxlbWVudCgpPC9kdD4KKyAgICAgIDxkZD48L2RkPgorICAg IDwvZGw+CisKKyAgICA8ZGwgY2xhc3M9ImlkbCIgdGl0bGU9InBhcnRpYWwgaW50ZXJmYWNlIFdl YkVsZW1lbnQiPgorICAgICAgPGR0PlNoYWRvd1Jvb3RbXSBnZXRTaGFkb3dSb290cygpPC9kdD4K KyAgICAgIDxkZD5SZXR1cm4gYSBsaXN0IG9mIDxhPlNoYWRvd1Jvb3Q8L2E+IGluc3RhbmNlcyBp biB0aGUgcmV2ZXJzZSBvcmRlciB0aGF0IHRoZXkgd2VyZSBhZGRlZCB0byB0aGUgaG9zdC4gVGhl ICJ5b3VuZ2VzdCIgaXMgYXQgdGhlIGJlZ2lubmluZyBvZiB0aGUgbGlzdCwgYW5kIHRoZSAib2xk ZXN0IiBvbmUgYXQgdGhlIGVuZCBvZiB0aGUgbGlzdC4gVGhlIHJldHVybmVkIGxpc3QgY291bGQg YmUgZW1wdHkgaWYgdGhlIDxhPldlYkVsZW1lbnQ8L2E+IGlzIG5vdCBhIHNoYWRvdyBob3N0Ljwv ZGQ+CisgICAgPC9kbD4KKyAgPC9zZWN0aW9uPgorCisgIDxzZWN0aW9uPgorICAgIDxoMj5MaWZl dGltZSBvZiBhIFdlYkVsZW1lbnQgb3IgU2hhZG93Um9vdDwvaDI+CisgICAgPHA+QSBET00gbm9k ZSwgd2hldGhlciBpdCBpcyBpbiB0aGUgdG9wLWxldmVsIERPTSBvciBhIFNoYWRvdyBET00sIHdp bGwgYmUgYWNjZXNzaWJsZSBhcyBsb25nIGFzIGJvdGggb2YgdGhlIGZvbGxvd2luZyBhcmUgdHJ1 ZToKKyAgICA8dWw+CisgICAgICA8bGk+VGhlIERPTSBub2RlIGlzIHN0aWxsIGF0dGFjaGVkIHRv IGl0cyBjb3JyZXNwb25kaW5nIERPTSB0cmVlLjwvbGk+CisgICAgICA8bGk+Rm9yIHRoZSBET00g dHJlZSB0aGF0IHRoZSBET00gbm9kZSBpcyBhdHRhY2hlZCB0bywgaXQgaXMgZWl0aGVyIHRoZSB0 b3AtbGV2ZWwgRE9NIHRyZWUgZm9yIHRoZSBjdXJyZW50IHBhZ2Ugb3IgYXR0YWNoZWQgdG8gYSBE T00gbm9kZSB0aGF0IGlzIGFjY2Vzc2libGUuPC9saT4KKyAgICA8L3VsPgorICAgIDwvcD4KKyAg ICA8cD5UaGUgbGlmZXRpbWUgb2YgYSByZXR1cm5lZCA8YT5XZWJFbGVtZW50PC9hPiByZWZlcmVu Y2UgaXMgY29uZmluZWQgdG8gdGhlIGFjY2Vzc2liaWxpdHkgb2YgaXRzIGNvcnJlc3BvbmRpbmcg RE9NIG5vZGUuIElmIGEgPGE+V2ViRWxlbWVudDwvYT4gdGhhdCBjb3JyZXNwb25kcyB0byBhbiBp bmFjY2Vzc2libGUgRE9NIG5vZGUgaXMgYWNjZXNzZWQgaW4gYW55IFdlYkRyaXZlciBjb21tYW5k LCB0aGVuIGEgPGEgaHJlZj0iI3N0YXR1cy1zdGFsZS1lbGVtZW50LXJlZmVyZW5jZSI+c3RhbGUg ZWxlbWVudCByZWZlcmVuY2U8L2E+IGVycm9yIHdpbGwgYmUgcmV0dXJuZWQgZm9yIHRoYXQgY29t bWFuZC48L3A+CisgICAgPHA+U2ltaWxhcmx5LCB0aGUgc2FtZSBydWxlIGFwcGxpZXMgdG8gYSBy ZXR1cm5lZCA8YT5TaGFkb3dSb290PC9hPiByZWZlcmVuY2UgZm9yIGEgaG9zdGVkIHNoYWRvdyBy b290LCBhbHRob3VnaCB0aGUgcmV0dXJuZWQgZXJyb3IgaXMgYSA8YSBocmVmPSIjc3RhdHVzLXN0 YWxlLXNoYWRvdy1yb290LXJlZmVyZW5jZSI+c3RhbGUgc2hhZG93IHJvb3QgcmVmZXJlbmNlPC9h Pi48L3A+CisgIDwvc2VjdGlvbj4KIDwvc2VjdGlvbj4K