Zwróć tekst, plik binarny i HTML

Domyślny tryb 'json' może przenosić JSON i tekst. To nie może przenosić bajtów: jeśli funkcja odpowie z binarnym typem zawartości, SDK zwróci błąd invalid_response i powie ci, abyś wybrał 'blob' lub 'arrayBuffer', więc nic nie zostanie utracone w trybie cichym.

Deno.serve((req) => {
  const { pathname } = new URL(req.url)
  if (pathname === '/csv') {
    return new Response('id,name\n1,Ada\n', { headers: { 'content-type': 'text/csv' } })
  }
  // 8-bajtowy podpis PNG, wystarczający do pokazania bajtów w obie strony
  const bytes = new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10])
  return new Response(bytes, { headers: { 'content-type': 'image/png' } })
})

const csv = await aura.functions.invoke<string>('export', { path: '/csv', responseType: 'text' })
console.log(csv.data) // "id, nazwa\n1,Ada\n"

const img = await aura.functions.invoke<Blob>('export', { responseType: 'blob' })
console.log(img.data?.type, img.data?.size) // „obraz/png” 8

W prawdziwym działaniu z funkcją zwracającą bajty 137,80,78,71,13,10,26,10,255,0,1, arrayBuffer zwróciło dokładnie te 11 bajtów, a blob zwróciło type=image/png size=11.

W przypadku 'text', 'blob' lub 'arrayBuffer' zestaw SDK pomija kopertę JSON i zwraca treść funkcji w niezmienionej postaci. Jeśli funkcja odpowiada statusem błędu, error.status jest tym statusem, a error.message jest tekstem zwróconym przez funkcję.

Dodaj nagłówek X-Aurabase-Invoke-Mode: raw, a platforma zwróci własną odpowiedź Twojej funkcji: jej status, content-type i bajty.

curl -i -X POST "$AURA_URL/v1/functions/export/invoke" \
  -H "apikey: $AURA_ANON_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Aurabase-Invoke-Mode: raw" \
  -d '{"path":"/csv"}' --output export.csv

Bez tego nagłówka odpowiedź to zawsze 200 z kopertą:

{
  "data": {
    "status": 200,
    "headers": { "content-type": "application/json" },
    "body": { "greeting": "Hello, Ada!" },
    "logs": [],
    "duration_ms": 74
  },
  "meta": null
}

W kopercie body to przeanalizowany plik JSON, tekst odpowiedzi, jeśli jest to UTF-8, a nie JSON, lub null, jeśli treść jest pusta lub binarna.

W trybie surowym każda odpowiedź z Twojej funkcji zawiera x-aurabase-invoke-origin: function. Odpowiedź bez tej odpowiedzi pochodzi z bramy lub środowiska wykonawczego. W ten sposób SDK informuje 503 zwrócony przez Twój kod w przypadku awarii platformy.

W trybie surowym nagłówki odpowiedzi są filtrowane, ponieważ są podawane z własnego źródła platformy.

Odpowiedź, która może uruchamiać skrypty (text/html, application/xhtml+xml, image/svg+xml, application/xml, text/xml) jest dostarczana z polityką bezpieczeństwa treści w trybie piaskownicy. Prawdziwa odpowiedź na funkcję zwracającą text/html:

content-type: text/html
content-security-policy: default-src 'none'; frame-ancestors 'none'; sandbox
x-content-type-options: nosniff

Twój kod HTML jest udostępniany, ale bez dostępu do plików cookie, pamięci i skryptów do źródła Twojego projektu. Użyj Storage lub własnej domeny, aby hostować prawdziwą stronę internetową.