SpeechSynthesis: cancel() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年9月以降、すべてのブラウザーで利用可能です。

cancel() は SpeechSynthesis インターフェイスのメソッドで、発話キューからすべての発話を除去します。

現在発話中の場合は、直ちに発話が停止します。

構文

cancel()

引数

なし。

返値

なし (undefined)。

例

const synth = window.speechSynthesis;

const utterance1 = new SpeechSynthesisUtterance(
  "こう言ってみてはどうでしょうか？これを言うと、かなり長い文章になります。",
);
const utterance2 = new SpeechSynthesisUtterance("念のため、もう一言言います。");

synth.speak(utterance1);
synth.speak(utterance2);

synth.cancel(); // utterance1 の発話を直ちに停止し、両方がキューから除去します。