flowingts / StaticOptions

Interface: StaticOptions

Definido em: src/server/static.ts:23

Opções comuns a app.static() e ctx.sendFile() (F-13).

Estende

• FileOptions

Propriedades

dotfiles?

optional dotfiles?: "deny" | "allow"

Definido em: src/server/static.ts:32

Arquivos e pastas que começam com . (.env, .git): 'deny' responde 404 (padrão) ou 'allow'.

---

etag?

optional etag?: boolean

Definido em: src/server/static.ts:16

ETag fraco (tamanho + data de modificação), com 304 para If-None-Match. Padrão: true.

Herdado de

FileOptions.etag

---

fallback?

optional fallback?: string

Definido em: src/server/static.ts:30

SPA: arquivo (relativo à raiz) servido quando o path pedido não existe e não tem extensão (/pedidos/42 → index.html, mas /app.js inexistente continua 404). Sai com no-cache.

---

immutable?

optional immutable?: boolean

Definido em: src/server/static.ts:14

Acrescenta immutable ao Cache-Control, para arquivos com hash no nome.

Herdado de

FileOptions.immutable

---

index?

optional index?: string | false

Definido em: src/server/static.ts:25

Arquivo servido para um diretório. Padrão: 'index.html'; false desliga. Diretórios nunca são listados.

---

lastModified?

optional lastModified?: boolean

Definido em: src/server/static.ts:18

Last-Modified, com 304 para If-Modified-Since. Padrão: true.

Herdado de

FileOptions.lastModified

---

maxAge?

optional maxAge?: string | number

Definido em: src/server/static.ts:12

Cache-Control: max-age, em segundos ou como '7d', '12h', '30m', '10s'. Padrão: 0 (revalida sempre).

Herdado de

FileOptions.maxAge

---

mimeTypes?

optional mimeTypes?: Readonly<Record<string, string>>

Definido em: src/server/static.ts:20

Tipos por extensão, somados à tabela interna: { glb: 'model/gltf-binary' }.

Herdado de

FileOptions.mimeTypes