elementLoaded()
Detect when an element matching a selector is loaded into the DOM.
elementLoaded(selector)
.then((element) => {
// ...
});
elementLoaded(selector)
elementLoaded(selector, target)
selector
: A selector to match against.
target
(Optional): An element to query and observe for matches. By default, this is the entire document.
A Promise
that is:
selector
matched an element already loaded
into the
document.selector
into the DOM.elementLoaded()
will search the document with
querySelector()
against a given selector
. If there is a match, then the returned promise will
resolve immediately. If there is no match, but the document
readyState
is no longer loading
, then the returned promise will reject immediately.
Otherwise, it will observe the document for
matches
using
MutationObserver
.
If a matching mutation is observed, then the promise will resolve. By the time
that the DOM has finished loading and the DOMContentLoaded
event
is fired, if no matching element has been found, then the promise will reject
and the observer will
disconnect.
Alternatives are:
MutationObserver
directly.See also:
See examples.