MediaRecorder.stop()

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報