MediaRecorder.stop()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

MediaRecorder.stop() メソッド（MediaStream 収録 API の一部）は、メディアキャプチャを停止するために使用します。

stop() メソッドを呼び出すと、 UA は次の手順を実行するタスクをキューに入れます。

  1. MediaRecorder.state が "inactive" の場合は、DOM の InvalidState エラーを発生させてこれらの手順を終了します。 MediaRecorder.state が "inactive" でない場合は、次の手順に進みます。
  2. MediaRecorder.state を "inactive" に設定してメディアのキャプチャを停止します。
  3. 収集されたデータの Blob を含む dataavailable イベントを発生させます。
  4. stop イベントを発生させます。

構文

js
stop()

引数

なし。

返値

なし (undefined)。

エラー

MediaRecorder オブジェクトの MediaRecorder.state が "inactive" のときに stop() メソッドが呼び出されると、InvalidState エラーが発生します — メディアキャプチャが既に停止している場合は停止しても意味がありません。

例

js
stop.onclick = () => {
  mediaRecorder.stop();
  console.log("レコーダー停止、データ使用可能");
};

仕様書

Specification
MediaStream Recording
# dom-mediarecorder-stop

ブラウザーの互換性

関連情報