Integrate the SDK

Errors

When something fails in a session — while it starts, while it runs, or when a request you made is rejected — it reaches your code as one typed error. You catch it, explain it to the user in your own words, and branch on it; every code it can carry is listed below.

The error object

Every error is one object:

Categories and classes

Every error also belongs to a category, and each category has its own class. Catch the class to handle a whole family at once — SpeechineerQuotaError covers every way an allowance can run out — or read error.code when you need the specific cause:

The numbers on a quota error

A quota error is the one category that carries figures, on error.meta. The keys are the same whether the allowance ran out on the request that started the session or while it was running, so one piece of code renders both:

Listen for errors

However a session fails, you never have to hunt for the error: the same object is delivered to three places, each suited to a different job — a callback for reacting the moment something fails, the session state for rendering, and the rejected promise for the code that asked. Use whichever fits the code you are writing.

• The onError callback — called the moment it happens. Log the error or send it to analytics from there:
  ReactAngularJavaScript

  tscopy

  const voice = useSpeechToForm({
    form: intakeForm,
    onError: (error) => showBanner(error.code),
  });

• The session state — the error sits there as error and stays until the next start() succeeds. Render your message from there — describe is your own mapping from a code to your wording:
  ReactAngularJavaScript

  tsxcopy

  {voice.error && <p role="alert">{describe(voice.error.code)}</p>}

• The rejected promise — start() and end() reject with the same error, so an await where you call them catches it directly:
  ReactAngularJavaScript

  tsxcopy

  const onSpeak = async () => {
    try {
      await voice.start();
    } catch (error) {
      showBanner(error.code);
    }
  };

Error codes

One section per category, so a section is exactly what one catch gives you: the class in the heading is what instanceof matches, and the codes under it are every way that class can arrive. The codes are frozen — they will not change under you.