Типы

Импортируемые типы и интерфейсы фреймворка Lunatic.

Интерфейсы

CorsOptions

Тип:

interface CorsOptions {
    allowedHeaders?: string | string[]
    corsErrorStatus?: number
    credentials?: boolean
    exposedHeaders?: string | string[]
    maxAge?: number
    methods?: HttpMethod | HttpMethod[]
    origin?:
        | boolean
        | string
        | string[]
        | RegExp
        | RegExp[]
        | ((origin: string) => boolean)
    preflightSuccessStatus?: number
}

Параметры конфигурации middleware CORS.

ServeStaticOptions

Тип:

interface ServeStaticOptions {
    dotfiles?: 'allow' | 'forbid' | 'ignore'
    etag?: boolean
    index?: string | false
    lastModified?: boolean
}

Параметры конфигурации Сервера статических файлов

UploadedFile

Тип:

interface UploadedFile {
    data: Buffer
    filename: string
    mimetype: string
}

Файл, загружаемый через форму типа multipart/form-data.

Типы

ApplicationFeature

Тип:

type ApplicationFeature = '500-on-error' | 'auto-head-handler' | 'x-powered-by'

Доступные Особенности приложения.

CookieOptions

Тип:

type CookieOptions = {
    domain?: string
    expires?: string | number
    httpOnly?: boolean
    maxAge?: number
    path?: string
} & (
    | {
          sameSite?: 'None'
          secure: true
      }
    | {
          sameSite?: 'Lax' | 'Strict'
          secure?: boolean
      }
)

Объектное представление атрибутов заголовка Set-Cookie.

HttpMethod

Тип:

type HttpMethod =
    | 'GET'
    | 'HEAD'
    | 'POST'
    | 'PUT'
    | 'DELETE'
    | 'CONNECT'
    | 'OPTIONS'
    | 'TRACE'
    | 'PATCH'
    | '*'

Метод запроса HTTP.

NextHandler

type NextHandler = () => void

Следующий middleware, 3-ий параметр RequestHandler.

RenderFunction

Тип:

type RenderFunction = (source: string, options?: Record<string, any>) => string

Функция-отрисовщик, используемая для отрисовки HTML-шаблонов.

RequestHandler

Тип:

type RequestHandler = (
    req: Request,
    res: Response,
    next: NextHandler,
) => unknown

Функция-обработчик запросов.

Перечисления

Status

Тип:

enum Status {
    Continue = 100,
    SwitchingProtocols = 101,
    Processing = 102,
    EarlyHints = 103,

    Ok = 200,
    Created = 201,
    Accepted = 202,
    NonAuthoritativeInformation = 203,
    NoContent = 204,
    ResetContent = 205,
    PartialContent = 206,
    MultiStatus = 207,
    AlreadyReported = 208,
    IMUsed = 226,

    MultipleChoices = 300,
    MovedPermanently = 301,
    Found = 302,
    SeeOther = 303,
    NotModified = 304,
    TemporaryRedirect = 307,
    PermanentRedirect = 308,

    BadRequest = 400,
    Unauthorized = 401,
    PaymentRequired = 402,
    Forbidden = 403,
    NotFound = 404,
    MethodNotAllowed = 405,
    NotAcceptable = 406,
    ProxyAuthenticationRequired = 407,
    RequestTimeout = 408,
    Conflict = 409,
    Gone = 410,
    LengthRequired = 411,
    PreconditionFailed = 412,
    PayloadTooLarge = 413,
    URITooLong = 414,
    UnsupportedMediaType = 415,
    RangeNotSatisfiable = 416,
    ExpectationFailed = 417,
    ImATeapot = 418,
    MisdirectedRequest = 421,
    UnprocessableContent = 422,
    Locked = 423,
    FailedDependency = 424,
    TooEarly = 425,
    UpgradeRequired = 426,
    PreconditionRequired = 428,
    TooManyRequests = 429,
    RequestHeaderFieldsTooLarge = 431,
    UnavailableForLegalReasons = 451,

    InternalServerError = 500,
    NotImplemented = 501,
    BadGateway = 502,
    ServiceUnavailable = 503,
    GatewayTimeout = 504,
    HTTPVersionNotSupported = 505,
    VariantAlsoNegotiates = 506,
    InsufficientStorage = 507,
    LoopDetected = 508,
    NotExtended = 510,
    NetworkAuthenticationRequired = 511,
}

Перечисление статусов ответа HTTP. Может использоваться вместо «магических чисел», обозначающих статус ответа:

res.status(200).end()
res.status(Status.Ok).end()

Чтобы узнать больше о кодах состояния ответа, смотрите Коды состояния HTTP на MDN.