SpeechSynthesisErrorEvent: свойство error

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузера. Она доступна во всех браузерах с сентября 2018 года.

Свойство error интерфейса SpeechSynthesisErrorEvent возвращает код ошибки, указывающий на то, что не удалось выполнить попытку синтеза речи.

Значение

Строка, содержащая причину ошибки. Возможные значения:

canceled: Вызов метода SpeechSynthesis.cancel привел к удалению SpeechSynthesisUtterance из очереди до начала его воспроизведения.
interrupted: Вызов метода SpeechSynthesis.cancel привел к прерыванию SpeechSynthesisUtterance после начала его воспроизведения и до завершения.
audio-busy: Операция не может быть завершена в настоящее время, так как пользовательский агент не может получить доступ к устройству вывода звука (например, пользователь может потребоваться исправить это, закрыв другое приложение).
audio-hardware: Операция не может быть завершена в настоящее время, так как пользовательский агент не может определить устройство вывода звука (например, пользователю может потребоваться подключить динамики или настроить системные параметры).
network: Операция не может быть завершена в настоящее время, так как произошла ошибка в требуемой сетевой коммуникации.
synthesis-unavailable: Операция не может быть завершена в настоящее время, так как не было доступно никакого движка синтеза (Например, пользователю может потребоваться установить или настроить движок синтеза).
synthesis-failed: Операция завершилась ошибкой, так как движок синтеза поднял ошибку.
language-unavailable: Для языка, установленного в SpeechSynthesisUtterance.lang, не было доступного голоса. Вы можете использовать метод window.speechSynthesis.getVoices(), чтобы определить, какие голоса и языки поддерживаются в браузере пользователя.
voice-unavailable: Голос, установленный в SpeechSynthesisUtterance.voice, был недоступен.
text-too-long: Содержание атрибута SpeechSynthesisUtterance.text было слишком длинным для синтеза.
invalid-argument: Содержание свойства SpeechSynthesisUtterance.rate, SpeechSynthesisUtterance.pitch или SpeechSynthesisUtterance.volume было некорректным.
not-allowed: Запуск операции не разрешен.

Примеры

const synth = window.speechSynthesis;

const inputForm = document.querySelector("form");
const inputTxt = document.querySelector("input");
const voiceSelect = document.querySelector("select");

const voices = synth.getVoices();

// ...

inputForm.onsubmit = (event) => {
  event.preventDefault();

  const utterThis = new SpeechSynthesisUtterance(inputTxt.value);
  const selectedOption =
    voiceSelect.selectedOptions[0].getAttribute("data-name");
  for (let i = 0; i < voices.length; i++) {
    if (voices[i].name === selectedOption) {
      utterThis.voice = voices[i];
    }
  }

  synth.speak(utterThis);

  utterThis.onerror = (event) => {
    console.error(
      `An error has occurred with the speech synthesis: ${event.error}`,
    );
  };

  inputTxt.blur();
};

Спецификации

Спецификация
Web Speech API # dom-speechsynthesiserrorevent-error

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`error`	33	≤18	49	21	7	33	62	Нет	7	3.0	Нет

См. также

Web Speech API

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesisErrorEvent/error