このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

SpeechSynthesis: cancel() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2018年9月.

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

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

構文

js
cancel()

引数

なし。

返値

なし (undefined)。

js
const synth = window.speechSynthesis;

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

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

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

仕様書

Specification
Web Speech API
# dom-speechsynthesis-cancel

ブラウザーの互換性

関連情報