Intent to Remove: ShadowRoot.getElementsBy*()

[Hayato Ito]

Primary eng (and PM) emails

hay...@chromium.org

Link to “Intent to Deprecate” thread

https://groups.google.com/a/chromium.org/forum/#!topic/blink-dev/YHObTvjl1tU

Summary

Remove getElementsByClassName(), getElementsByTagName() and getElementsByTagNameNS() on ShadowRoot.

Note: getElementById() is not involved in any way.

(copied-and-pasted from "Intent to Deprecated" thread)

Motivation

https://www.w3.org/Bugs/Public/show_bug.cgi?id=23620 Follow the link for more context. In summary, this was agreed upon a year ago.

(copied-and-pasted from "Intent to Deprecated" thread)

Usage information from UseCounter

ShadowRootGetElementsByClassName: <=0.0001% https://www.chromestatus.com/metrics/feature/timeline/popularity/623 ShadowRootGetElementsByTagName: 0.0039% https://www.chromestatus.com/metrics/feature/timeline/popularity/624

ShadowRootGetElementsByTagNameNS: <=0.0001% https://www.chromestatus.com/metrics/feature/timeline/popularity/625

FYI.

As a basic for comparison, Element.createShadowRoot is: 2.6288%

https://www.chromestatus.com/metrics/feature/timeline/popularity/456

Entry on chromestatus.com

https://www.chromestatus.com/feature/4507242028072960

Compatibility Risk

Any content using these methods will throw exceptions.

[TAMURA, Kent]

LGTM to remove.

--

TAMURA Kent
Software Engineer, Google

[Dimitri Glazkov]

LGTM2

[Chris Harrelson]

LGTM3

LGTM2

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.

[p...@google.com]

LGTM, better to remove this early before certain people start using this API.