@nestjs/platform-express

@nestjs/platform-express

Version 10.2.5
Published 7 days ago
61.3 kB
5 dependencies
MIT license

Install

npm i @nestjs/platform-express

yarn add @nestjs/platform-express

pnpm add @nestjs/platform-express

Overview

Nest - modern, fast, powerful node.js web framework (@platform-express)

Index

Functions

AnyFilesInterceptor()
FileFieldsInterceptor()
FileInterceptor()
FilesInterceptor()
NoFilesInterceptor()

Functions

function AnyFilesInterceptor

AnyFilesInterceptor: (localOptions?: MulterOptions) => Type<NestInterceptor>;

Parameter localOptions

function FileFieldsInterceptor

FileFieldsInterceptor: (
    uploadFields: MulterField[],
    localOptions?: MulterOptions
) => Type<NestInterceptor>;

Parameter uploadFields
Parameter localOptions

function FileInterceptor

FileInterceptor: (
    fieldName: string,
    localOptions?: MulterOptions
) => Type<NestInterceptor>;

Parameter fieldName
Parameter localOptions

function FilesInterceptor

FilesInterceptor: (
    fieldName: string,
    maxCount?: number,
    localOptions?: MulterOptions
) => Type<NestInterceptor>;

Parameter fieldName
Parameter maxCount
Parameter localOptions

function NoFilesInterceptor

NoFilesInterceptor: (localOptions?: MulterOptions) => Type<NestInterceptor>;

Parameter localOptions

Classes

class ExpressAdapter

class ExpressAdapter extends AbstractHttpAdapter<http.Server | https.Server> {}

constructor

constructor(instance?: any);

method applyVersionFilter

applyVersionFilter: (
    handler: Function,
    version: VersionValue,
    versioningOptions: VersioningOptions
) => VersionedRoute;

method close

close: () => Promise<unknown>;

method createMiddlewareFactory

createMiddlewareFactory: (
    requestMethod: RequestMethod
) => (path: string, callback: Function) => any;

method disable

disable: (...args: any[]) => any;

method enable

enable: (...args: any[]) => any;

method enableCors

enableCors: (options: CorsOptions | CorsOptionsDelegate<any>) => any;

method end

end: (response: any, message?: string) => any;

method engine

engine: (...args: any[]) => any;

method getRequestHostname

getRequestHostname: (request: any) => string;

method getRequestMethod

getRequestMethod: (request: any) => string;

method getRequestUrl

getRequestUrl: (request: any) => string;

method getType

getType: () => string;

method initHttpServer

initHttpServer: (options: NestApplicationOptions) => void;

method isHeadersSent

isHeadersSent: (response: any) => boolean;

method listen

listen: {
    (port: string | number, callback?: () => void): Server;
    (port: string | number, hostname: string, callback?: () => void): Server;
};

method redirect

redirect: (response: any, statusCode: number, url: string) => any;

method registerParserMiddleware

registerParserMiddleware: (prefix?: string, rawBody?: boolean) => void;

method render

render: (response: any, view: string, options: any) => any;

method reply

reply: (response: any, body: any, statusCode?: number) => any;

method set

set: (...args: any[]) => any;

method setBaseViewsDir

setBaseViewsDir: (path: string | string[]) => any;

method setErrorHandler

setErrorHandler: (handler: Function, prefix?: string) => any;

method setHeader

setHeader: (response: any, name: string, value: string) => any;

method setLocal

setLocal: (key: string, value: any) => this;

method setNotFoundHandler

setNotFoundHandler: (handler: Function, prefix?: string) => any;

method setViewEngine

setViewEngine: (engine: string) => any;

method status

status: (response: any, statusCode: number) => any;

method useBodyParser

useBodyParser: <Options = NestExpressBodyParserOptions>(
    type: NestExpressBodyParserType,
    rawBody: boolean,
    options?: Omit<Options, 'verify'>
) => this;

method useStaticAssets

useStaticAssets: (path: string, options: ServeStaticOptions) => any;

class MulterModule

class MulterModule {}

method register

static register: (options?: MulterModuleOptions) => DynamicModule;

method registerAsync

static registerAsync: (options: MulterModuleAsyncOptions) => DynamicModule;

Interfaces

interface MulterModuleAsyncOptions

interface MulterModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {}

property inject

inject?: any[];

property useClass

useClass?: Type<MulterOptionsFactory>;

property useExisting

useExisting?: Type<MulterOptionsFactory>;

property useFactory

useFactory?: (
    ...args: any[]
) => Promise<MulterModuleOptions> | MulterModuleOptions;

interface MulterOptionsFactory

interface MulterOptionsFactory {}

method createMulterOptions

createMulterOptions: () => Promise<MulterModuleOptions> | MulterModuleOptions;

interface NestExpressApplication

interface NestExpressApplication<
    TServer extends CoreHttpServer | CoreHttpsServer = CoreHttpServer
> extends INestApplication<TServer> {}

Interface describing methods on NestExpressApplication.
See Also
- [Platform](https://docs.nestjs.com/first-steps#platform)

method disable

disable: (...args: any[]) => this;

A wrapper function around native express.disable() method.
Returns
{this}
Example 1
app.disable('x-powered-by')

method enable

enable: (...args: any[]) => this;

A wrapper function around native express.enable() method.
Returns
{this}
Example 1
app.enable('x-powered-by')

method engine

engine: (...args: any[]) => this;

A wrapper function around native express.engine() method.
Returns
{this}
Example 1
app.engine('mustache', mustacheExpress())

method getHttpAdapter

getHttpAdapter: () => HttpServer<Express.Request, Express.Response, Express>;

Returns the underlying HTTP adapter bounded to the Express.js app.
Returns
{HttpServer}

method listen

listen: {
    (port: number | string, callback?: () => void): Promise<TServer>;
    (
        port: string | number,
        hostname: string,
        callback?: () => void
    ): Promise<TServer>;
};

Starts the application.
Parameter port
Parameter hostname
Parameter callback
Optional callback
Returns
{Promise} A Promise that, when resolved, is a reference to the underlying HttpServer.

method set

set: (...args: any[]) => this;

A wrapper function around native express.set() method.
Returns
{this}
Example 1
app.set('trust proxy', 'loopback')

method setBaseViewsDir

setBaseViewsDir: (path: string | string[]) => this;

Sets one or multiple base directories for templates (views).
Returns
{this}
Example 1
app.setBaseViewsDir('views')

method setLocal

setLocal: (key: string, value: any) => this;

Sets app-level globals for view templates.
Returns
{this}
Example 1
app.setLocal('title', 'My Site')
See Also
- https://expressjs.com/en/4x/api.html#app.locals

method setViewEngine

setViewEngine: (engine: string) => this;

Sets a view engine for templates (views).
Returns
{this}
Example 1
app.setViewEngine('pug')

method useBodyParser

useBodyParser: <Options = NestExpressBodyParserOptions>(
    parser: NestExpressBodyParserType,
    options?: Omit<Options, 'verify'>
) => this;

Register Express body parsers on the fly. Will respect the application's rawBody option.
Returns
{this}
Example 1
const app = await NestFactory.create( AppModule, { rawBody: true } ); app.useBodyParser('json', { limit: '50mb' });

method useStaticAssets

useStaticAssets: {
    (options: ServeStaticOptions): this;
    (path: string, options?: ServeStaticOptions): this;
};

Sets a base directory for public assets.
Returns
{this}
Example 1
app.useStaticAssets('public')

interface NestExpressBodyParserOptions

interface NestExpressBodyParserOptions {}

Type alias to keep compatibility with @types/body-parser
See Also
- https://github.com/DefinitelyTyped/DefinitelyTyped/blob/dcd1673c4fa18a15ea8cd8ff8af7d563bb6dc8e6/types/body-parser/index.d.ts#L48-L66#L48-L66

property inflate

inflate?: boolean | undefined;

When set to true, then deflated (compressed) bodies will be inflated; when false, deflated bodies are rejected. Defaults to true.

property limit

limit?: number | string | undefined;

Controls the maximum request body size. If this is a number, then the value specifies the number of bytes; if it is a string, the value is passed to the bytes library for parsing. Defaults to '100kb'.

property type

type?: string | string[] | ((req: IncomingMessage) => any) | undefined;

The type option is used to determine what media type the middleware will parse

index signature

[key: string]: unknown;

Type Aliases

type MulterModuleOptions

type MulterModuleOptions = MulterOptions;

type NestExpressBodyParserType

type NestExpressBodyParserType = 'json' | 'urlencoded' | 'text' | 'raw';

Interface defining possible body parser types, to be used with NestExpressApplication.useBodyParser().

Package Files (12)

Dependencies (5)

body-parser
cors
express
multer
tslib

Dev Dependencies (2)

@nestjs/common
@nestjs/core

Peer Dependencies (2)

@nestjs/common
@nestjs/core

Badge

To add a badge like this oneto your package's README, use the codes available below.

You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/@nestjs/platform-express.

Markdown

[![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/@nestjs/platform-express)

HTML

<a href="https://www.jsdocs.io/package/@nestjs/platform-express"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>

Updated 4 days ago.
Package analyzed in 2035 ms.
Missing or incorrect documentation? Open an issue for this package.

@nestjs/platform-express

Install

Overview

Index

Functions

Classes

Interfaces

Type Aliases

Functions

function AnyFilesInterceptor

Parameter localOptions

function FileFieldsInterceptor

Parameter uploadFields

Parameter localOptions

function FileInterceptor

Parameter fieldName

Parameter localOptions

function FilesInterceptor

Parameter fieldName

Parameter maxCount

Parameter localOptions

function NoFilesInterceptor

Parameter localOptions

Classes

class ExpressAdapter

constructor

method applyVersionFilter

method close

method createMiddlewareFactory

method disable

method enable

method enableCors

method end

method engine

method getRequestHostname

method getRequestMethod

method getRequestUrl

method getType

method initHttpServer

method isHeadersSent

method listen

method redirect

method registerParserMiddleware

method render

method reply

method set

method setBaseViewsDir

method setErrorHandler

method setHeader

method setLocal

method setNotFoundHandler

method setViewEngine

method status

method useBodyParser

method useStaticAssets

class MulterModule

method register

method registerAsync

Interfaces

interface MulterModuleAsyncOptions

property inject

property useClass

property useExisting

property useFactory

interface MulterOptionsFactory

method createMulterOptions

interface NestExpressApplication

See Also

method disable

Returns

Example 1

method enable

Returns

Example 1

method engine

Returns

Example 1

method getHttpAdapter

Returns

method listen