元素: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);
}

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

requestor.requestFullscreen();

規範

規範
Fullscreen API
# handler-document-onfullscreenerror

瀏覽器相容性

另見