SpeechSynthesis: cancel() 方法

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上使用。自 2018 年 9 月以來,它已在各種瀏覽器中推出。

SpeechSynthesis 介面的 cancel() 方法將語音佇列中的所有話語移除。

如果當前正在朗讀某個話語,朗讀將立即停止。

語法

js
cancel()

引數

無。

返回值

無(undefined)。

示例

js
const synth = window.speechSynthesis;

const utterance1 = new SpeechSynthesisUtterance(
  "How about we say this now? This is quite a long sentence to say.",
);
const utterance2 = new SpeechSynthesisUtterance(
  "We should say another sentence too, just to be on the safe side.",
);

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

synth.cancel(); // utterance1 stops being spoken immediately, and both are removed from the queue

規範

規範
Web Speech API
# dom-speechsynthesis-cancel

瀏覽器相容性

另見