检测文档何时“完全活动”

Question

在阅读各种 JavaScript API 的规范时，您可能会遇到这样的要求：文档必须“完全激活”才能使用它们。这是从规范中定义的含义： https://html.spec.whatwg.org/multipage/browsers.html#fully-active

尚不清楚的是如何知道文档是否完全处于活动状态。例如，WakeLock API 要求文档完全处于活动状态。如果文档未完全激活，则调用“WakeLock.request()”将拒绝返回的 Promise，并带有“NotAllowedError”错误对象。但是，还有其他原因，它可能会返回“NotAllowedError”，并且在给定情况下没有指定哪个原因。

那么，在尝试使用需要它的 API 之前，如何主动确定文档是否处于完全活动状态？

Answer 1

页面中有一段：https://html.spec.whatwg.org/multipage/browsers.html#active-document

当 d 的浏览上下文不为空，d 的浏览上下文的活动文档为 d，并且 d 的浏览上下文是顶级浏览上下文，或者d 的浏览上下文的容器文档完全处于活动状态。

期待您的问题：

那么，在尝试使用需要它的 API 之前，我如何才能主动确定文档是否处于完全活动状态

让我们扩展规则：

• d 的浏览上下文不为空
• d 的浏览上下文的活动文档是 d
• d 的浏览上下文是顶级浏览上下文，或者 d 的浏览上下文的容器文档处于完全活动状态

我认为可以将其翻译为该 javascript 代码，但我对此不是 100% 确定：

function isFullyActive(s /* self */) {
    return s.window !== null
    && s.document === s.window.document
    && (s.window.top === s.window || isFullyActive(s.window.parent));
}

// you can use in this way on a top level javascript:
isFullyActive(self)

我没有找到任何关于检查文档是否完全活动的事件或方法的 API/规范。

参考资料：

• 浏览器上下文：How to access "browsing context" in JavaScript?
• 嵌套浏览上下文：https://www.w3.org/TR/2011/WD-html5-20110525/browsers.html#nested-browsing-context
• 完全活动的定义已更改：https://github.com/whatwg/html/issues/388
• window.parent：https://developer.mozilla.org/en-US/docs/Web/API/Window/parent