Skip to content

CorsOptions ​

CorsOptions configura CORS para cada rota de um HttpRouter. Seus campos obrigatórios são origin, methods, allowedHeaders, exposedHeaders, credentials e maxAge em segundos.

methods aceita somente os literais de métodos HTTP padrão em maiúsculas: "CONNECT", "DELETE", "GET", "HEAD", "OPTIONS", "PATCH", "POST", "PUT", "QUERY" e "TRACE". allowedHeaders permanece string[] para que aplicações possam autorizar headers de requisição personalizados, como "X-Request-Id" e "X-Api-Key".

Quando credentials é true, origin deve listar origens explícitas. "*" é rejeitado pelo compilador e pelo runtime porque navegadores não permitem origem curinga com credenciais.

Chame app.cors(options) antes de listen(...). CORS é uma política do navegador, não autenticação nem autorização.

tyrus
import { CorsOptions, createRouter, HttpRouter } from "tyrus:http";

const options: CorsOptions = {
    origin: ["https://app.example.com"],
    methods: ["GET", "POST", "OPTIONS", "QUERY"],
    allowedHeaders: ["Content-Type", "Authorization"],
    exposedHeaders: ["x-request-id"],
    credentials: true,
    maxAge: 3600,
};

const app: HttpRouter = createRouter();
app.cors(options);