SpeechSynthesis: getVoices() 方法

Baseline 已廣泛支援

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

getVoices() 方法是 SpeechSynthesis 介面的一部分，它返回一個 SpeechSynthesisVoice 物件列表，代表當前裝置上所有可用的語音。

語法

getVoices()

引數

無。

返回值

一個 SpeechSynthesisVoice 物件的列表（陣列）。

示例

JavaScript

function populateVoiceList() {
  if (typeof speechSynthesis === "undefined") {
    return;
  }

  const voices = speechSynthesis.getVoices();

  for (const voice of voices) {
    const option = document.createElement("option");
    option.textContent = `${voice.name} (${voice.lang})`;

    if (voice.default) {
      option.textContent += " — DEFAULT";
    }

    option.setAttribute("data-lang", voice.lang);
    option.setAttribute("data-name", voice.name);
    document.getElementById("voiceSelect").appendChild(option);
  }
}

populateVoiceList();
if (
  typeof speechSynthesis !== "undefined" &&
  speechSynthesis.onvoiceschanged !== undefined
) {
  speechSynthesis.onvoiceschanged = populateVoiceList;
}

HTML

html

<select id="voiceSelect"></select>

規範

規範
Web Speech API # dom-speechsynthesis-getvoices

瀏覽器相容性

另見

Web Speech API

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2025年5月27日⁩，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題