MediaRecorderErrorEvent.error

非推奨;: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。

error は MediaRecorderErrorEvent インターフェイスの読み取り専用のプロパティで、MediaRecorder インスタンスによって発生した例外に関する詳細を提供する DOMException オブジェクトです。

MediaRecorderErrorEvent が発生した場合、MediaRecorder の error イベントハンドラーである onerror によって受けた MediaRecorderErrorEvent 内の error プロパティを調べることによって、何が問題であるかをある程度判断できます。

イベントによって表されるエラーを記述する DOMException。エラーの name プロパティの値は、仕様で明確に識別されているものも含め、メディア収録の処理中に意味をなすものであればどんな例外でもかまいません。ここでの説明は一般的なものです。あなたはそれらが対応するメソッドのリファレンスで起こるかもしれない様々なシナリオにもっと具体的なものを見つけるでしょう。

InvalidStateError

操作が許可されていないコンテキストで操作が試行されたか、削除されたか取り除かれたオブジェクトに対して要求が行われました。

NotSupportedError

指定されたオプションが無効なため、MediaRecorder を作成できませんでした。 message 属性は、もしあれば追加情報を提供するべきです。

SecurityError

MediaStream は収録を禁止するように設定されています。これは、例えば、ユーザーが入力デバイスを使用するパーミッションを拒否したときに getUserMedia() を使用して取得されたソースの場合などです。

InvalidModificationError

収録中のストリームのトラック数が変更されました。メディアの収録中にトラックを追加したり削除したりすることはできません。

UnknownError

セキュリティに関連しない、他に分類できないエラーが発生しました。収録が停止し、MediaRecorder の state は inactive となり、最後に残りの受信データで dataavailable イベントが MediaRecorder に送られ、最後に stop イベントが送出されました。

例

基本的なエラー処理の例

この関数は、与えられた MediaStream の MediaRecorder を作成して、データを配列にバッファーし、エラーを監視するように構成して、返します。

js
function recordStream(stream) {
  let recorder = null;
  let bufferList = [];

  try {
    recorder = new MediaRecorder(stream);
  } catch (err) {
    /* レコーダーを作成しようとしたときの例外。 それを扱う */
  }

  recorder.ondataavailable = (event) => {
    bufferList.push(event.data);
  };

  recorder.onerror = (event) => {
    console.error(`Error: ${event.error}`);
  };

  recorder.start(100); /* バッファーあたり 100ms のタイムスライス */
  return recorder;
}