Padrões web

Confira quais objetos nativos de JavaScript uma function pode usar no Azion Runtime e qual argumento de timer o runtime recusa.

Última atualização

Ver como Markdown Configurar agente

O Azion Runtime executa JavaScript construído sobre padrões web, por isso as APIs nativas de JavaScript, como os objetos Math e JSON, estão disponíveis para uma function. Para os objetos globais que o runtime define, consulte Globais. Para mais informações sobre a linguagem, consulte JavaScript reference na MDN Web Docs.

nota — Com azion dev, uma string passada para setTimeout() lança um TypeError no argumento callback, em vez do EvalError que uma function com deploy feito lança.

JavaScript nativo e Web APIs

Os objetos nativos de JavaScript e as Web APIs do runtime funcionam juntos em uma mesma function. Uma function faz o parsing do corpo de uma requisição com JSON, calcula valores com Math, Date e String e retorna o resultado com Response. Para as Web APIs que o Azion Runtime suporta, consulte Web APIs. Para as definições padrão dessas APIs, consulte Web APIs na MDN Web Docs.

Callbacks de timer

Uma function com deploy feito recusa uma string como callback de setTimeout() ou de setInterval(). A chamada lança EvalError: eval not allowed on setTimeout/setInterval parameter. Passe uma função como callback.

Casos de uso

  • Faça o parsing e a serialização de payloads com o objeto JSON enquanto as requisições passam por uma function.
  • Calcule, formate e transforme dados com os métodos padrão de Math, Date e String.
  • Escreva uma lógica portável, teste-a com azion dev e confirme-a em uma function com deploy feito. Para as APIs que se comportam de forma diferente em cada lado, consulte Como o Azion Runtime funciona.
  • Combine recursos nativos da linguagem com as Web APIs suportadas para montar respostas na infraestrutura distribuída da Azion.

Exemplo

Este handler passa uma string para setTimeout(), captura o erro que a chamada lança e retorna o erro como texto da resposta:

JavaScript
01export default {
02 async fetch(request, env, ctx) {
03 const result = await new Promise((resolve) => {
04 try {
05 setTimeout('globalThis.flag = 1', 0);
06 setTimeout(() => resolve(`string callback ran: ${globalThis.flag === 1}`), 20);
07 } catch (error) {
08 resolve(`${error.name}: ${error.message}`);
09 }
10 });
11 return new Response(result);
12 },
13};

Uma function com deploy feito retorna este texto:

EvalError: eval not allowed on setTimeout/setInterval parameter

Recursos relacionados

Web APIs

Todas as Web APIs que o Azion Runtime suporta, agrupadas por família.

fetch

Como uma function envia uma requisição e lê a resposta.

node:timers

As funções de timer do Node.js, incluindo os timers baseados em promises.

Como o Azion Runtime funciona

Onde azion dev difere de uma function com deploy feito, API por API.