Document: fullscreenerror 事件

有限可用性

此功能不是基线功能，因为它在一些最常用的浏览器中无法正常工作。

当浏览器无法切换到全屏模式时，会触发 fullscreenerror 事件。

与 fullscreenchange 事件 一样，会触发两个 fullscreenerror 事件；第一个发送到无法更改模式的 Element，第二个发送到拥有该元素的 Document。

有关切换到全屏模式可能失败的一些原因，请参阅 全屏 API 指南。

此事件不可取消。

语法

在诸如 addEventListener() 的方法中使用事件名称，或设置事件处理程序属性。

js
addEventListener("fullscreenerror", (event) => {});

onfullscreenerror = (event) => {};

事件类型

一个通用的 Event。

示例

js
const requestor = document.querySelector("div");

function handleError(event) {
  console.error("an error occurred changing into fullscreen");
  console.log(event);
}

document.addEventListener("fullscreenerror", handleError);
// or
document.onfullscreenerror = handleError;

requestor.requestFullscreen();

规范

规范
全屏 API 标准
# handler-document-onfullscreenerror

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅