Document: exitPictureInPicture() メソッド

構文

exitPictureInPicture()

引数

なし。

返値

プロミス (Promise) で、ユーザーエージェントがピクチャインピクチャモードを終了した時点で解決されます。全画面モードを終了しようとしてエラーが発生した場合、プロミスの catch() ハンドラーが呼び出されます。

例外

InvalidStateError DOMException

document.pictureInPictureElement が null の場合に発生します。

例

この例では、現在の文書内でマウスボタンがクリックされるたびに、ピクチャインピクチャモードを終了させます。

document.onclick = (event) => {
  if (document.pictureInPictureElement) {
    document
      .exitPictureInPicture()
      .then(() => console.log("Document Exited from Picture-in-Picture mode"))
      .catch((err) => console.error(err));
  } else {
    video.requestPictureInPicture();
  }
};

ページ上のどの動画が現在ピクチャインピクチャモードで再生されているかを追跡する予定であれば、 HTMLVideoElement 要素上の enterpictureinpicture と exitpictureinpicture イベントを待ち受けなければならないことに注意してください。あるいは、 Document.pictureInPictureElement が現在の HTMLVideoElement 要素を参照しているかどうかを調べることもできます。

仕様書

ブラウザーの互換性

関連情報

• HTMLVideoElement.requestPictureInPicture()
• HTMLVideoElement.disablePictureInPicture
• Document.pictureInPictureEnabled
• Document.pictureInPictureElement
• :picture-in-picture
• ピクチャインピクチャのイベント