What remains unclear is how to know if the document is fully active or not. As an example, the WakeLock API requires the document to be fully active. If the document is not fully active, then calling “WakeLock.request()” will reject the returned promise with a “NotAllowedError” error object. However, there are other reasons it might return a “NotAllowedError” and does not specify which reason in a given case.
So, how can I proactively determine if a document is fully active before attempting to use APIs that require it?
There is a section from the page: https://html.spec.whatwg.org/multipage/browsers.html#active-document
A Document d is said to be fully active when d’s browsing context is non-null, d’s browsing context’s active document is d, and either d’s browsing context is a top-level browsing context, or d’s browsing context’s container document is fully active.
Looking to your question:
So, how can I proactively determine if a document is fully active before attempting to use APIs that require it
let’s expand the rules:
- d’s browsing context is non-null
- d’s browsing context’s active document is d
- either d’s browsing context is a top-level browsing context, or d’s browsing context’s container document is fully active
I didn’t found any API/spec saying about an event or method to check if a document is fully active.
- Nested browsing context: https://www.w3.org/TR/2011/WD-html5-20110525/browsers.html#nested-browsing-context
- Definition of fully active changed: https://github.com/whatwg/html/issues/388
- window.parent: https://developer.mozilla.org/en-US/docs/Web/API/Window/parent