Fouten, time-outs en nieuwe pogingen

invoke retourneert { data, error } en gooit nooit. error is een AuraError, dus isAuraError(error) is waar. Twee subklassen vertellen je wie heeft gefaald:

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

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

if (error instanceof FunctionsHttpError) {
  // Uw functie heeft geantwoord, met een foutstatus. Debug uw code.
} else if (error instanceof FunctionsRelayError) {
  // Het platform faalde: het antwoord van jouw functie kwam nooit meer terug.
} else if (error) {
  // De oproep is geannuleerd of geweigerd op de client (time-out, invalid_body, no_session).
}

Gedrag waargenomen tegen een lopende stapel. De quotarij volgt de fouttoewijzing van de backend en werd niet geactiveerd in onze tests.

De SDK probeert nooit opnieuw een aanroep voor u uit te voeren: uw functie kan bijwerkingen hebben en een herhaalde POST is standaard niet veilig. U beslist aan de hand van onderstaande tabel.

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 })
}

Drie klokken lopen tegelijk:

Wanneer de functie timeout_secs overschrijdt, wordt deze door de runtime geannuleerd en mislukt uw oproep na ongeveer die vertraging, met de hierboven weergegeven 500 of 503. De oorzaak verschijnt in error.context.detail (WorkerRequestCancelled: request has been cancelled by supervisor) in onbewerkte modus. Stel uw client timeout iets boven de timeout_secs van de functie in om deze fout te zien in plaats van een client timeout.

const { error } = await aura.functions.invoke('report', { timeout: 35_000 })
if (error?.code === 'timeout') {
  // Geannuleerd door uw klant. Mogelijk is de functie nog actief.
}

Voor werk dat langer dan een paar seconden duurt, zet een taak in de wachtrij in plaats van een verbinding open te houden.

• Platformfouten hebben een verzoek-ID: error.details.error.request_id. Vermeld dit wanneer u contact opneemt met de ondersteuning.
• aura functions logs <name> geeft een overzicht van recente HTTP-verzoeken met methode, pad, status, duur en verzoek-ID. Het laat en niet zien wat uw functie heeft geschreven met console.log of console.error: die uitvoer blijft in de eigen logs van de runtime, die alleen de platformoperator kan lezen. Zie limieten voor deze en de andere huidige hiaten.
• De identificatie van de oproep wordt niet doorgestuurd naar uw functie. Geef uw eigen ID door in headers en log deze in.