Erreurs, délais d'attente et tentatives

invoke renvoie { data, error } et ne lance jamais. error est un AuraError, donc isAuraError(error) est vrai. Deux sous-classes vous indiquent qui a échoué:

import { FunctionsHttpError, FunctionsRelayError } from '@aurabase/aurabase-js'

const { data, error } = await aura.functions.invoke('checkout', { body })

if (error instanceof FunctionsHttpError) {
  // Votre fonction a répondu, avec un statut d'erreur. Déboguez votre code.
} else if (error instanceof FunctionsRelayError) {
  // La plateforme a échoué : la réponse de votre fonction n'est jamais revenue.
} else if (error) {
  // L'appel a été annulé ou refusé sur le client (timeout, invalid_body, no_session).
}

Comportements observés par rapport à une pile en cours d’exécution. La ligne de quota suit le mappage des erreurs du backend et n'a pas été déclenchée lors de nos tests.

Le SDK ne relance jamais une invocation à votre place : votre fonction peut avoir des effets secondaires et un POST répété n'est pas sûr par défaut. Vous décidez, à l’aide du tableau ci-dessous.

import { FunctionsRelayError } from '@aurabase/aurabase-js'

async function invokeWithRetry(name: string, body: unknown, attempts = 3) {
  for (let i = 0; i < attempts; i++) {
    const res = await aura.functions.invoke(name, { body })
    const safe = res.error instanceof FunctionsRelayError && res.error.status === 503
    if (!res.error || !safe) return res
    await new Promise((r) => setTimeout(r, 2 ** i * 500))
  }
  return aura.functions.invoke(name, { body })
}

Trois horloges fonctionnent en même temps :

Lorsque la fonction dépasse timeout_secs, le runtime l'annule et votre appel échoue après environ ce délai, avec le 500 ou 503 indiqué ci-dessus. La cause apparaît dans error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) en mode brut. Définissez votre client timeout légèrement au-dessus du timeout_secs de la fonction pour voir cette erreur au lieu d'un client timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Annulé par votre client. La fonction est peut-être toujours en cours d'exécution.
}

Pour un travail de plus de quelques secondes, met en file d'attente une tâche au lieu de maintenir une connexion ouverte.

• Les erreurs de plate-forme portent un identifiant de demande : error.details.error.request_id. Citez-le lorsque vous contactez le support.
• aura functions logs <name> répertorie les requêtes HTTP récentes avec la méthode, le chemin, le statut, la durée et l'identifiant de la requête. et non montrent ce que votre fonction a écrit avec console.log ou console.error: cette sortie reste dans les propres journaux du runtime, que seul l'opérateur de la plate-forme peut lire. Voir les limites pour cela et les autres écarts de courant.
• L'identifiant de l'appel n'est pas transmis à votre fonction. Transmettez votre propre identifiant dans headers et enregistrez-le.